正在加载…

Claude / Codex 配置

这篇教你把 Claude 桌面版、Claude Code 和 Codex 改成使用本站的 API,桌面版和命令行版都包括。照着做,不需要懂编程,全程大约 5 分钟。其他软件见第三方软件接入。

先看你要用哪个

你想用的软件 看哪一节
Claude 桌面版(像聊天软件一样的窗口) Claude 桌面版
Claude Code(在终端里写代码,或 Claude 桌面版里的 Code 页) Claude Code
Codex 桌面版,或 Codex 命令行 Codex

开始之前,先在 API 密钥 页面创建一把密钥。密钥就像本站账号的「通行证」,软件靠它来使用你的余额。不要把密钥发给别人。

页面最上方的「用你的密钥生成配置」工具会自动填好你的地址和密钥,下面各节会告诉你什么时候用它。

怎么打开终端

Claude Code 和 Codex 的步骤需要在「终端」里粘贴命令。终端就是一个输入文字命令的窗口,不用怕,只需要粘贴、回车。

  • macOS:按 ⌘ 空格,输入「终端」,回车打开。
  • Windows:在开始菜单搜索「PowerShell」,点开「Windows PowerShell」。

粘贴命令:macOS 按 ⌘ V,Windows 在窗口里点右键。粘贴后按回车运行。

Claude 桌面版

这一节不需要终端,全在 Claude 窗口里点选。

第一步:安装。 从 Claude 官方下载页下载安装。这个页面在国内网络下可能打不开。

第二步:打开设置窗口。 打开 Claude,在屏幕顶部菜单栏选择 Developer → Configure Third-Party Inference…。

如果菜单栏里没有 Developer,先点 Help → Troubleshooting → Enable Developer Mode,再回来找。

第三步:填写。 把 Inference provider 选成 Gateway,然后照下表填。页面上方的工具选「Claude 桌面版」,每一项后面都有「复制」按钮。

设置项 填什么
Gateway base URL https://aaaiapi.com
Gateway API key 你的 API 密钥
Credential kind Static API key
Gateway auth scheme Bearer

没提到的设置项不用动。

第四步:重启 Claude。 保存后要彻底退出 Claude 再打开:macOS 按 ⌘ Q,Windows 在右下角托盘图标上右键选「退出」。重新打开后就是用本站的 API 了。

改完之后,Claude 不再使用你 claude.ai 账号的额度,费用从本站余额扣,可以在使用记录里查看。想改回去,回到同一个窗口改回原来的设置即可。

Claude Code

第一步:安装 Node.js。 Claude Code 要先装 Node.js 才能运行,这个只用装一次。

  1. 打开 Node.js 国内下载页。
  2. macOS 下载名字以 .pkg 结尾的文件,Windows 下载以 x64.msi 结尾的文件。
  3. 双击下载好的文件,一路点「继续」或「下一步」装完。
  4. 打开终端,输入 node -v 回车。看到类似 v22.x.x 的版本号,就说明装好了。

第二步:安装 Claude Code。 在终端里粘贴下面这行,回车:

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

这行命令从国内镜像下载,不需要访问境外网站。等它跑完再继续,可能要一两分钟。

macOS 如果提示 permission denied(权限不足),在命令最前面加上 sudo ,再运行一次,然后输入电脑的开机密码。输入密码时屏幕上不会显示,输完直接回车即可。

第三步:配置。 回到本页最上方的工具:

  1. 选「Claude Code」。
  2. 选你的密钥和电脑系统。
  3. 点「复制命令」,粘贴到终端里回车。

看到「已写入……」就成功了。

第四步:开始用。 在终端输入 claude 回车。Claude 桌面版里的 Code 页也会自动用上这份配置,彻底退出再打开一次即可。

这条命令做了什么:它会先把你原来的配置文件备份一份,再在 ~/.claude/settings.json 里写入本站地址和你的密钥,原有的其他设置都保留。它还会关掉自动更新和数据上报,因为这些请求连的是境外服务器,国内网络下会卡住。以后要升级,再运行一次第二步的安装命令就行。

Codex

第一步:安装。

npm install -g @openai/codex --registry=https://registry.npmmirror.com

第二步:配置。 回到本页最上方的工具:

  1. 选「Codex」。
  2. 选密钥、模型和电脑系统。
  3. 点「复制命令」,粘贴到终端里回车。

看到「已写入……」就成功了。

第三步:开始用。 桌面版要彻底退出再打开;命令行版在终端输入 codex 回车。

这条命令做了什么:它会先备份 ~/.codex/config.toml,再写入本站地址、你的密钥和选好的模型,其他设置不动。桌面版和命令行版共用这一个文件,配一次两边都能用。

遇到问题

  • 改完没变化:大多是没有彻底退出。macOS 按 ⌘ Q,Windows 从托盘图标退出,再重新打开。
  • 提示 command not found / 找不到命令:Node.js 或软件没装好。关掉终端重新打开,再试一次;还不行就重新做一遍安装步骤。
  • 提示 401:密钥没填对。回 API 密钥 页面确认密钥是「启用」状态,再用上方工具重新生成一次。
  • 提示模型不存在:选的模型不在这把密钥的分组里。在上方工具重新选模型,再运行一次命令。
  • Claude Code 一直要求登录:重新运行一次配置命令。如果以前在电脑里设置过 ANTHROPIC_API_KEY,它会和这里冲突,需要删掉。
  • 想恢复原来的设置:配置文件旁边有一个名字带 .bak- 和时间的备份,把它改回原来的文件名就恢复了。
  • 其他报错见常见问题,或联系客服。