接入软件
Claude Code
在终端里用 Claude Code,请求走我们的接入地址。
约 8 分钟适合:已经装好 Claude Code 的开发者
开始之前
- 已按 Claude Code 官方文档装好并能启动
claude - 一把 Key(见「创建 API Key」)
- 模型广场里要有可用的 Claude 系列模型,并带「Messages」接口标签
步骤 1 · STEP 0x01
设置两个环境变量
Claude Code 把这类服务叫「LLM 网关」。地址变量 ANTHROPIC_BASE_URL 填不带 /v1 的根地址,凭证变量用 ANTHROPIC_AUTH_TOKEN(以 Bearer 方式发送)。
export ANTHROPIC_BASE_URL=https://api.suanlimao.shop
export ANTHROPIC_AUTH_TOKEN=<你的 Key>$ export ANTHROPIC_BASE_URL=https://api.suanlimao.shop$ export ANTHROPIC_AUTH_TOKEN=<你的 Key>
步骤 2 · STEP 0x02
先用一条命令验证地址和 Key
在同一个终端里,向接入地址发一个只生成 1 个 token 的请求。先确认这一步是通的,再打开 Claude Code,出问题时更容易判断是哪一边的问题。
$ curl -sS -i -X POST "$ANTHROPIC_BASE_URL/v1/messages" \ -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "<模型名>", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'HTTP/2 200…"content":[…]
<模型名> 换成从模型广场复制的 Claude 模型名。返回 200 和一段 JSON 就说明地址、Key、模型都对。返回 401 表示 Key 不对;返回 404 多半是模型名写错。步骤 3 · STEP 0x03
启动 Claude Code 并确认走的是我们的地址
$ claude> /statusAnthropic base URL: https://api.suanlimao.shopAuth token: ANTHROPIC_AUTH_TOKEN
/status里应该有一行Anthropic base URL,值是你设置的地址。没有这一行说明变量没传进来,回第 1 步检查。- 接着发一句话,正常回答就成功了。
步骤 4 · STEP 0x04
让设置长期生效
把变量写进用户级设置文件 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json)的 env 里:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.suanlimao.shop",
"ANTHROPIC_AUTH_TOKEN": "<你的 Key>"
}
}$ claude> /statusAnthropic base URL: https://api.suanlimao.shop
.claude/settings.json:它会被提交到仓库,等于公开了你的 Key。VS Code 扩展不读 shell 的环境变量,要在 VS Code 的用户设置(JSON)里写 claudeCode.environmentVariables:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.suanlimao.shop" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "<你的 Key>" }
]
}步骤 5 · STEP 0x05
选择模型
> /model(在列表里选,或者用环境变量指定)$ export ANTHROPIC_MODEL=<模型名>
/model 里看不到我们的模型名时,用 ANTHROPIC_MODEL 指定为从模型广场复制的名字。不同模型的价格不同,贵的模型用量大了花费会明显增加。
✓ 怎么确认成功了
/status显示的Anthropic base URL是你的接入地址。- 发一条消息能正常回答,控制台「用量」页出现这次请求。
常见问题
启动后还是让我登录 claude.ai?
变量没有传进 Claude Code。写进 ~/.claude/settings.json 的 env,或者在同一个终端里设置后再运行 claude。已经登录过 claude.ai 想改用网关:先运行 /logout。
返回 401?
先确认 Key 没复制错。凭证放错变量也会 401:ANTHROPIC_AUTH_TOKEN 走 Bearer,ANTHROPIC_API_KEY 走 x-api-key,我们两种都接受,但建议统一用 ANTHROPIC_AUTH_TOKEN,这样不会弹出「是否使用这个 API Key」的确认。
提示 400,内容里有 `Extra inputs are not permitted` 或 `context_management`?
这是新版 Claude Code 发了模型接口不认识的实验字段。官方排错表建议设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 后重试;仍然不行,提交工单并附上 request_id。
有些功能不能用(网页搜索、MCP 连接器、超大上下文)?
需要模型厂商另行计费的服务端功能暂不支持,详情见文档的「Claude Code 与 Anthropic 原生接口」。
花费怎么看?
控制台「用量」页按日、按模型汇总,Claude Code 一次对话会产生很多次请求,是正常的。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。