上手指南
上手指南 / Claude Code

Claude Code 桌面版

Claude Code 桌面版就是 Claude 官方桌面软件里的「Code」功能,有窗口和按钮,不用敲命令也能让 AI 写代码。它支持"第三方推理"模式:不用登录 Anthropic 账号,直接连到 AIPlayer 演示站。

分三步:安装 → 打开开发者模式 → 填写连接信息。

还没有密钥的,先看 创建密钥。

一、下载安装

  1. 浏览器打开 claude.com/download,下载对应系统的安装包。
  2. 安装:
    • macOS:双击下载的 .dmg 文件,把 Claude 图标拖进「应用程序」文件夹。
    • Windows:双击下载的安装程序,按提示装完。
  3. 打开 Claude。
注意

打开后会看到登录页面。不要登录,也不要注册账号,直接做下一步。

二、打开开发者模式

macOS: 点屏幕最上方菜单栏的 Help(帮助)→ Troubleshooting → Enable Developer Mode。

Windows: 点登录界面左上角的 ☰(三条横线)菜单 → Help → Troubleshooting → Enable Developer Mode。

打开后,菜单里会多出一个 Developer 菜单。

三、填写连接信息

  1. 点 Developer → Configure Third-Party Inference…,打开配置窗口。
  2. 在 Connection(连接)这一部分,按下表填写:
配置项 填什么
Inference provider(推理提供方) 选 Gateway
Gateway base URL(网关地址) https://demo.aiplayer.club
Gateway API key(网关密钥) 你的密钥(sk- 开头那一串)
Credential kind(凭证类型) 保持默认 Static API key
Gateway auth scheme(认证方式) 保持默认 Bearer
  1. 点 Apply Changes(应用更改),再点 Save & Restart(保存并重启)。
说明

网关地址只填 https://demo.aiplayer.club,结尾不要加 /v1,也不要多打空格。

四、启动并验证

  1. Claude 重启后,登录界面会多出一个不用登录、直接进入第三方模式的选项,点它进入。
  2. 新建一个对话,发一句「你好,回复 OK 就行」,能收到回复就成功了。
  3. 想让它写代码,切到 Code 标签页,选一个本地文件夹开始。
  4. 回到 https://demo.aiplayer.club,点左侧「使用记录」,能看到刚产生的记录。

模型列表

桌面版会自动从本站读取可用模型。如果模型下拉框是空的,回到第三步的配置窗口,在填写模型列表的地方手动加上模型名,每行一个,例如:

text
claude-sonnet-5-5
claude-opus-5-5
claude-haiku-5-5

实际可用的模型以你的分组为准,不确定就问客服。

常见问题

现象 怎么办
菜单里找不到 Developer 重新做一遍「二、打开开发者模式」。切换到第三方模式后,这个菜单有时会被隐藏
启动时提示 Gateway was unreachable(连不上网关) 检查网关地址是否正好是 https://demo.aiplayer.club;检查网络;确认浏览器能打开这个地址
发消息报 401 或"认证失败" 密钥填错了或已被删除。到网站「API 密钥」页重新复制,回配置窗口改掉
发消息报余额不足 账户余额用完了,到网站「兑换」页充值
改了配置但没生效 彻底退出 Claude(macOS 按 Command + Q,Windows 在任务栏右下角图标上右键退出),再重新打开
小贴士

想看详细日志排查问题:macOS 在 ~/Library/Logs/Claude-3p/main.log,Windows 在 %LOCALAPPDATA%\Claude-3p\Logs\main.log。发给客服时,记得先把里面的密钥删掉。

更多报错见 常见问题。