Claude Code 配置
把本站 API 接到 Claude Code:上方生成配置,下方按步骤写入两个文件。
Claude Code 走 Anthropic Messages 接口。先按 创建 API Key 在控制台拿一把本站 Key,再用下面的生成器拼出配置,复制到本机两个文件里。
选线路、填本站 Key,下面直接复制。配置只在浏览器里拼,不会上传、也不会保存。
Claude Code 会自己拼 /v1,这里只填域名。
只影响下面显示的文件路径,生成内容一样。
在网站控制台创建。没填时示例里先用 your_api_key 占位。
对应 /model haiku,以及后台小任务。
对应 /model sonnet,日常写代码。
对应 /model opus,以及 Plan 模式里的重活。
~/.claude/settings.json
没有这个文件就新建。已有文件时,把 env 合并进去,不要整份覆盖掉别的设置。
{ "env": { "ANTHROPIC_AUTH_TOKEN": "your_api_key", "ANTHROPIC_BASE_URL": "https://code.ezaigc.cn", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.6-sol", "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "gpt-5.6-sol", "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.6-sol", "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gpt-5.6-sol", "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.6-sol", "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "gpt-5.6-sol", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" }}配置前注意
Base URL 不要带 /v1
Claude Code 会自己拼 /v1/messages。地址只填域名,例如 https://code.ezaigc.cn。
带上 /v1 容易 404。其他软件要 /v1 的,见 API 地址。
- Key 必须是本站 Key,不能拿官方 Anthropic 的 Key 填到本站
- 线路连不上就换一条。生成器里四条都可用,只换域名,Key 不用换
- 模型名填本站提供的名字,不要自行改写
第一步:写入 settings.json
把配置写进用户级 settings.json 的 env 字段。Claude Code 直接读这个文件,后台任务也能用上。同一变量如果 shell 里也 export 过,以这个文件为准。
文件路径:~/.claude/settings.json
没有 .claude 文件夹就先建一个。没有 settings.json 就新建。
已有文件时,只新增或改 env 里的这些字段,不要整份覆盖掉别的设置。把 your_api_key 换成你的本站 Key:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "your_api_key",
"ANTHROPIC_BASE_URL": "https://code.ezaigc.cn",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.6-sol",
"ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "gpt-5.6-sol",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.6-sol",
"ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gpt-5.6-sol",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.6-sol",
"ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "gpt-5.6-sol",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}| 字段 | 作用 |
|---|---|
ANTHROPIC_AUTH_TOKEN | 本站 API Key。走 Authorization: Bearer,和本站认证方式一致。 |
ANTHROPIC_BASE_URL | 本站地址,只填域名,不要 /v1。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | /model haiku 和后台小任务实际调用的模型。 |
ANTHROPIC_DEFAULT_SONNET_MODEL | /model sonnet 日常写代码用的模型。 |
ANTHROPIC_DEFAULT_OPUS_MODEL | /model opus,以及 Plan 模式里的重活。 |
ANTHROPIC_DEFAULT_*_MODEL_NAME | 只改 /model 选择器上的显示名。生成器里和模型 ID 保持一致。 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 关掉自动更新、遥测这类非必要请求,少去打官方。 |
为什么用 AUTH_TOKEN
本站认证是 Authorization: Bearer。官方对应这个请求头的变量是 ANTHROPIC_AUTH_TOKEN。
ANTHROPIC_API_KEY 走的是 x-api-key。报 401 时再换成 ANTHROPIC_API_KEY 试一次。
第二步:写入 .claude.json
新装第一次开 Claude Code 时,引导页有时会忽略刚写好的 settings.json,还去连官方登录。在用户目录再放一个 .claude.json,跳过这段引导。
文件路径:~/.claude.json
注意:它在用户目录根下,不在 ~/.claude/ 文件夹里。
没有这个文件就新建。已有文件时,补上这一项即可:
{
"hasCompletedOnboarding": true
}这一步在解决什么
官方还没把「首次启动读用户 settings」做稳。社区里常用的办法就是写上 hasCompletedOnboarding。
写完再开 claude,一般就不会再弹出「Select login method」。
VS Code 扩展(可选)
只用终端里的 claude,这一节可以跳过。
VS Code / Cursor 里的 Claude Code 扩展,登录检查读的是编辑器自己的设置,不读 ~/.claude/settings.json。打开命令面板,运行 Preferences: Open User Settings (JSON),合并下面这段。字段名是 name,不是 key:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_api_key" },
{ "name": "ANTHROPIC_BASE_URL", "value": "https://code.ezaigc.cn" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "gpt-5.6-sol" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME", "value": "gpt-5.6-sol" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "gpt-5.6-sol" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME", "value": "gpt-5.6-sol" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "gpt-5.6-sol" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME", "value": "gpt-5.6-sol" },
{ "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" }
]
}改完保存,重载窗口或把 Claude Code 面板关掉再开。
验证是否生效
- 终端里运行
claude(扩展就在面板里开一轮对话) - 输入
/status,打开 Status - 应能看到:
Anthropic base URL:你填的本站域名Auth token:来源是ANTHROPIC_AUTH_TOKEN
- 随便发一句,能正常回答就通了
也可以先不打开 Claude Code,用下面这条确认地址和 Key 本身没问题。把 Key 和模型名换成你的:
curl -X POST "https://code.ezaigc.cn/v1/messages" \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "gpt-5.6-sol", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'返回以 {"id":"msg_ 开头就说明线路和 Key 可用。提示模型不存在也没关系,至少证明已经打到本站了。401 就是 Key 没被接受。
常见问题
第一次打开还要选登录方式
settings.json 写好了,但 ~/.claude.json 还没有 hasCompletedOnboarding。按第二步补上,再重新开 claude。
报 404,或提示找不到接口
Base URL 多半带了 /v1。改回纯域名,例如 https://code.ezaigc.cn。
报 401
- 确认填的是本站 Key,复制时没有多空格
- 本站默认用
ANTHROPIC_AUTH_TOKEN。个别环境只认x-api-key,把同一把 Key 改放到ANTHROPIC_API_KEY再试 - 不要拿官方 Claude 的 Key 填到本站地址
模型名不对、选了没反应
haiku / sonnet / opus 只是别名,真正调用的是 ANTHROPIC_DEFAULT_*_MODEL 里的本站模型名。到网站【模型广场】核对后再改生成器里的三项。
改了 settings.json 好像没生效
- 确认改的是用户目录那份,不是项目里的
.claude/settings.json - 不要把 Key 写进会提交到 Git 的项目 settings
- 看
/status里的 Base URL 是不是你刚改的那条 - 以前在系统环境变量里 export 过旧地址,先清掉再开新终端。settings 文件里的
env会覆盖同名 shell 变量;系统级环境变量有时仍会捣乱
桌面版 App 配了也不走本站
官方桌面 App 不读 ANTHROPIC_BASE_URL 和 settings.json。它走自己的「第三方推理」:Help → Troubleshooting → Enable Developer Mode,再打开 Developer → Configure Third-Party Inference。日常更建议用 CLI 或 VS Code 扩展。