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 才能运行,这个只用装一次。
- 打开 Node.js 国内下载页。
- macOS 下载名字以
.pkg结尾的文件,Windows 下载以x64.msi结尾的文件。 - 双击下载好的文件,一路点「继续」或「下一步」装完。
- 打开终端,输入
node -v回车。看到类似v22.x.x的版本号,就说明装好了。
第二步:安装 Claude Code。 在终端里粘贴下面这行,回车:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
这行命令从国内镜像下载,不需要访问境外网站。等它跑完再继续,可能要一两分钟。
macOS 如果提示 permission denied(权限不足),在命令最前面加上 sudo ,再运行一次,然后输入电脑的开机密码。输入密码时屏幕上不会显示,输完直接回车即可。
第三步:配置。 回到本页最上方的工具:
- 选「Claude Code」。
- 选你的密钥和电脑系统。
- 点「复制命令」,粘贴到终端里回车。
看到「已写入……」就成功了。
第四步:开始用。 在终端输入 claude 回车。Claude 桌面版里的 Code 页也会自动用上这份配置,彻底退出再打开一次即可。
这条命令做了什么:它会先把你原来的配置文件备份一份,再在 ~/.claude/settings.json 里写入本站地址和你的密钥,原有的其他设置都保留。它还会关掉自动更新和数据上报,因为这些请求连的是境外服务器,国内网络下会卡住。以后要升级,再运行一次第二步的安装命令就行。
Codex
第一步:安装。
- 命令行版:先照 Claude Code 第一步装好 Node.js,然后在终端运行:
npm install -g @openai/codex --registry=https://registry.npmmirror.com
- 桌面版:从 Codex App 官方页面下载。这个页面在国内网络下可能打不开。
第二步:配置。 回到本页最上方的工具:
- 选「Codex」。
- 选密钥、模型和电脑系统。
- 点「复制命令」,粘贴到终端里回车。
看到「已写入……」就成功了。
第三步:开始用。 桌面版要彻底退出再打开;命令行版在终端输入 codex 回车。
这条命令做了什么:它会先备份 ~/.codex/config.toml,再写入本站地址、你的密钥和选好的模型,其他设置不动。桌面版和命令行版共用这一个文件,配一次两边都能用。
遇到问题
- 改完没变化:大多是没有彻底退出。macOS 按
⌘ Q,Windows 从托盘图标退出,再重新打开。 - 提示
command not found/ 找不到命令:Node.js 或软件没装好。关掉终端重新打开,再试一次;还不行就重新做一遍安装步骤。 - 提示 401:密钥没填对。回 API 密钥 页面确认密钥是「启用」状态,再用上方工具重新生成一次。
- 提示模型不存在:选的模型不在这把密钥的分组里。在上方工具重新选模型,再运行一次命令。
- Claude Code 一直要求登录:重新运行一次配置命令。如果以前在电脑里设置过
ANTHROPIC_API_KEY,它会和这里冲突,需要删掉。 - 想恢复原来的设置:配置文件旁边有一个名字带
.bak-和时间的备份,把它改回原来的文件名就恢复了。 - 其他报错见常见问题,或联系客服。