在官方客户端里使用 Claude Code
Claude 官方客户端全程点菜单,一条命令都不用敲;也可以装进 VS Code。
两条路配置的地方不同,别混着做
官方客户端全程点菜单;VS Code 扩展写代码用。
1
创建一把 API 密钥约 1 分钟
- 打开 控制台 → API 密钥,点创建新密钥。
- 起个名字,选择要使用的厂商,点确定。
- 弹窗里会出现完整密钥,先别关,按弹窗里的步骤往下做即可。
完整密钥默认隐藏
关掉弹窗后会显示
bgai_••••••1a2b 这样的打码样子,需要时可在控制台点查看或复制。 密钥等于密码,不要把完整密钥截图发给任何人;怀疑泄露时立即重新生成,旧密钥会立刻作废。2
装上 Claude 官方客户端约 3 分钟
- 在 claude.ai/download 下载 对应你系统的版本,双击装完。
- 第一次打开停在登录页,先别登录。
✓ 看到这个就说明这一步成了
应用打开,停在登录页。
3
打开「开发者模式」约 1 分钟
✓ 看到这个就说明这一步成了
重启后菜单栏上多了
Developer 这一项。× 没成的话,对照这里
找不到 Help 菜单看错地方了- Mac 上菜单栏在屏幕最顶端,不在应用窗口里,要先点一下 Claude 窗口让它变成当前应用。Windows 上点登录页左上角的 ☰ 菜单。
重启后还是没有 Developer没点到那一项- 再走一遍 Help → Troubleshooting,确认 Enable Developer Mode 前面已经打勾。有的版本要手动退出应用再打开。
4
打开第三方推理配置约 30 秒
把 Connection 里的 Inference provider 改成 Gateway。
✓ 看到这个就说明这一步成了
窗口里出现几个空白输入框。
5
填这四个格子约 2 分钟
这四项要从密钥弹窗进来才会自动填好
回控制台点那把密钥的 使用密钥,从弹窗进来即可。
填完点 Apply locally,别点 Export。应用会自动重启。
✓ 看到这个就说明这一步成了
重启后的登录页出现「使用 Claude Desktop on 3P」或第三方推理配置的启动选项。
× 没成的话,对照这里
点完以后仍只有普通 claude.ai 登录配置没有被应用- 重新打开第三方推理窗口,确认选了 Gateway,并点的是 Apply locally。仍不生效时,完全退出程序再打开,关窗口不算。
提示认证失败 / 401密钥填错了- 把第二格清空,回控制台重新复制完整密钥再粘一次。注意首尾不要带空格。
Gateway auth scheme 不知道选哪个两个都行- 选
Bearer或x-api-key都可以,比高两种都接受。
6
用第三方配置进入 Claude约 30 秒
- 在登录页选「使用 Claude Desktop on 3P」那一项。
- 打开模型选择器,选择这把密钥所属厂商里要用的型号(列表是空的就等 10 秒重开一次)。
- 输入「你好,请只回复:配置成功」,发送。
✓ 看到这个就说明这一步成了
Claude 回复「配置成功」,控制台使用记录里出现一条对应模型的调用。
接上之后 claude.ai 的订阅额度不再生效
费用统一从比高余额扣,会话也只在本机跑。想用回订阅就把 Inference provider 改回默认值。
✓
还是卡住了?
先对照教程逐步检查,再到常见问题里按报错信息找。别发完整密钥,打码留前几位就行。