算力猫
← 返回教程列表

接入软件

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 方式发送)。

bash
export ANTHROPIC_BASE_URL=https://api.suanlimao.shop
export ANTHROPIC_AUTH_TOKEN=<你的 Key>
terminal
$ export ANTHROPIC_BASE_URL=https://api.suanlimao.shop$ export ANTHROPIC_AUTH_TOKEN=<你的 Key>
这样设置只对当前终端窗口有效。想长期生效,看第 4 步。
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 Key →

步骤 2 · STEP 0x02

先用一条命令验证地址和 Key

在同一个终端里,向接入地址发一个只生成 1 个 token 的请求。先确认这一步是通的,再打开 Claude Code,出问题时更容易判断是哪一边的问题。

terminal
$ 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 并确认走的是我们的地址

terminal
$ claude> /statusAnthropic base URL: https://api.suanlimao.shopAuth token: ANTHROPIC_AUTH_TOKEN
  • /status 里应该有一行 Anthropic base URL,值是你设置的地址。没有这一行说明变量没传进来,回第 1 步检查。
  • 接着发一句话,正常回答就成功了。
只要设置了网关凭证,请求就走我们的接口、按我们的价格计费,不会占用你的 claude.ai 订阅额度。

步骤 4 · STEP 0x04

让设置长期生效

把变量写进用户级设置文件 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json)的 env 里:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.suanlimao.shop",
    "ANTHROPIC_AUTH_TOKEN": "<你的 Key>"
  }
}
terminal
$ claude> /statusAnthropic base URL: https://api.suanlimao.shop
不要把 Key 写进项目里的 .claude/settings.json:它会被提交到仓库,等于公开了你的 Key。

VS Code 扩展不读 shell 的环境变量,要在 VS Code 的用户设置(JSON)里写 claudeCode.environmentVariables:

json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.suanlimao.shop" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "<你的 Key>" }
  ]
}

步骤 5 · STEP 0x05

选择模型

terminal
> /model(在列表里选,或者用环境变量指定)$ export ANTHROPIC_MODEL=<模型名>

/model 里看不到我们的模型名时,用 ANTHROPIC_MODEL 指定为从模型广场复制的名字。不同模型的价格不同,贵的模型用量大了花费会明显增加。

Anthropic 官方说明:Claude Code 不支持通过网关路由到非 Claude 模型。请只选 Claude 系列。

✓ 怎么确认成功了

  • /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)。