2.3.2.2 方案二:使用第三方API中转服务(国内用户)

如果你在国内无法直接访问 Anthropic 的服务,这个方案是你的最佳选择。

注意:很多个人搭建的中转平台,溢价严重,甚至有作假的情况,请仔细甄别。而且避免封号的情况也无法保证,这里不做推荐。

主流中转服务对比:

服务商价格倍率支持模型注册门槛特点
OpenRouter1.0-1.1xClaude全系列 + GPT + 开源低模型最全,国际化
API2D1.2-1.5xClaude + GPT低中文界面,支持支付宝
OhMyGPT1.1-1.3xClaude + GPT + 多种低价格较优
CloseAI1.2-1.5xClaude + GPT低国内老牌服务

(价格倍率会随市场波动,请以各服务商官网最新价格为准)

提示:所谓”价格倍率”,是指相比 Anthropic 官方价格的加价比例。例如官方 $3/百万Token,1.2x 倍率就是 $3.6/百万Token。中转服务需要维护服务器和线路,所以会有一定加价,这是正常的。

以 OpenRouter 为例的注册流程:

  1. 访问 https://openrouter.ai/
  2. 点击 “Sign in” 注册账号(支持 Google 账号登录)
  3. 登录后,进入 “Keys” 页面
  4. 点击 “Create Key” 创建 API Key
  5. 复制并保存你的 API Key(以 sk-or- 开头)
  6. 在 “Credits” 页面充值(支持信用卡)

需要记录的关键信息:

API Base URL: https://openrouter.ai/api/v1
API Key: sk-or-v1-xxxxxxxxxxxxx(你的实际Key)

注意:不同的中转服务有不同的 API Base URL 格式。注册后请仔细查看服务商提供的文档,找到他们的 Base URL 和支持的模型列表。

原理回顾:

你的 Claude Code ──请求──→ 中转服务器(国内可达)──转发──→ Anthropic API
    ↑                                         │
    └──────────────── 返回 AI 回复 ←───────────────────────┘

中转服务本质上就是一个”代理”,帮你把请求转发给 Anthropic,再把结果返回。你在 Claude Code 中需要做的就是把”目的地地址”从 Anthropic 官方改成中转服务。

Step 1:获取中转服务的信息

在 0.3.2 节你已经注册了中转服务,现在需要两个关键信息:

API Base URL:中转服务的地址(每个服务商不同)
API Key:在中转服务上创建的 Key(不是 Anthropic 官方的 Key)

以 OpenRouter 为例:

API Base URL: https://openrouter.ai/api/v1
API Key: sk-or-v1-你的OpenRouter-Key

Step 2:设置环境变量

Claude Code 通过 ANTHROPIC_BASE_URL 环境变量来指定API地址。

Windows 用户(PowerShell):

# 临时设置(当前窗口有效)
$env:ANTHROPIC_BASE_URL = "https://openrouter.ai/api/v1"
$env:ANTHROPIC_API_KEY = "sk-or-v1-你的中转服务Key"
​
# 永久设置(推荐)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://openrouter.ai/api/v1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-or-v1-你的中转服务Key", "User")

macOS / Linux 用户:

# 编辑 shell 配置文件
$ vim ~/.zshrc  # 或你喜欢的编辑器
​
# 在文件末尾添加以下两行:
export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-你的中转服务Key"
​
# 保存后使配置生效
$ source ~/.zshrc

Step 3:验证配置

# 重新打开终端(重要!)
# 启动 Claude Code
$ claude

输入测试消息:

> 你好,请告诉我今天是星期几

如果收到正常回复,说明中转配置成功。

验证:Claude Code 正常回复即表示中转服务配置成功。

不同中转服务的配置参考:

中转服务ANTHROPIC_BASE_URLKey 前缀
OpenRouterhttps://openrouter.ai/api/v1sk-or-
API2Dhttps://oa.api2d.net参见服务商文档
OhMyGPT参见服务商文档参见服务商文档
CloseAI参见服务商文档参见服务商文档

注意:不同中转服务的 Base URL 格式不同,请务必查阅你所使用的服务商的文档。有些服务商要求 URL 末尾带 /v1,有些不需要,配错会导致连接失败。

中转服务常见问题:

问题原因解决方案
连接成功但回复乱码中转服务返回格式与Claude Code不兼容检查中转服务是否支持 Anthropic 的 Messages API 格式
余额不足提示中转服务账户余额用完到中转服务网站充值
特定模型不可用中转服务可能不支持所有 Claude 模型检查中转服务支持的模型列表
响应特别慢中转链路延迟尝试换一个中转服务商,或在非高峰时段使用
2.3.2.3 方案三:接入其他模型(DeepSeek/千问/GLM)

Claude Code 不仅可以使用 Claude 模型,还可以通过配置接入其他AI模型。这对国内用户特别有价值 —— 你可以使用国内直连的模型服务,不需要任何代理。

工作原理:

Claude Code 内部有一个三级模型槽位体系。无论你用哪个模型提供商,它始终维护三个”角色位”:

槽位(别名)用途对应环境变量
opus复杂推理、架构决策ANTHROPIC_DEFAULT_OPUS_MODEL
sonnet日常编码主力模型ANTHROPIC_DEFAULT_SONNET_MODEL
haiku后台轻量任务(自动压缩、文件分析等)ANTHROPIC_DEFAULT_HAIKU_MODEL

接入第三方模型有两种方式:

方式原理优点适用场景
Anthropic 兼容接口(推荐)模型厂商提供 Anthropic Messages API 格式的接口,三个槽位自动映射配置简单,无需逐个指定模型名智谱 GLM 等已提供兼容接口的厂商
直接指定模型通过 --model 或环境变量指定具体模型名称灵活,适用任何 OpenAI 兼容接口DeepSeek、通义千问、Ollama 等

方式一:直接指定模型(通用方式)

# 设置 API Key 和 Base URL(大部分第三方模型都兼容 OpenAI 格式)
export ANTHROPIC_AUTH_TOKEN="你的模型API-Key"
export ANTHROPIC_BASE_URL="模型的API地址"

然后在启动 Claude Code 时指定模型:

# 使用指定模型启动
$ claude --model "模型名称"

方式二:Anthropic 兼容接口(自动映射,包含 DeepSeek、GLM、Kimi)

目前官方提供 Anthropic Messages API 兼容端点的国产厂商越来越多,包括:

厂商Anthropic 兼容端点官方文档
DeepSeekhttps://api.deepseek.com/anthropichttps://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
智谱 GLMhttps://open.bigmodel.cn/api/anthropichttps://docs.bigmodel.cn/cn/coding-plan/tool/claude
Kimi(月之暗面)https://api.moonshot.ai/anthropichttps://platform.moonshot.cn/docs/guide/agent-support

配置后,Claude Code 界面仍然显示 Opus/Sonnet/Haiku 的别名,但实际调用的是厂商的模型——这就是服务端模型映射。

以智谱 GLM 为例:

# 智谱 GLM 最简配置
export ANTHROPIC_AUTH_TOKEN="你的智谱API-Key"
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"

智谱 GLM 默认的服务端自动映射关系(根据官方文档最新表述):

Claude Code 界面显示实际调用的模型
OpusGLM-4.7
SonnetGLM-4.7
HaikuGLM-4.5-Air

提示:要用上旗舰型号 GLM-5.1,需要手动覆盖三个槽位(详见下面「接入智谱 GLM」部分)。不要误以为默认就是 GLM-5.1。

现在GLM的Coding Plan非常抢手,不一定能买到,而且有限额、高峰期翻倍消耗额度。

图片[1]-2.3.2.2 方案二:使用第三方API中转服务(国内用户)-大赛人网

方式三:通过配置文件(推荐持久化配置)

除了环境变量,还可以在 settings.json 的 env 块中配置,效果相同但更持久、更清晰:

// ~/.claude/settings.json(全局生效)
{
 "env": {
  "ANTHROPIC_AUTH_TOKEN": "你的API-Key",
  "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
  "API_TIMEOUT_MS": "3000000"
}
}

提示:三种配置方式的优先级为:启动参数 --model > 环境变量 ANTHROPIC_MODEL > 配置文件 settings.json 中的 model 字段。选择最适合你工作习惯的方式即可。

接入智谱 GLM 的完整步骤:

智谱 AI 提供了 Anthropic Messages API 兼容接口,是目前国内配置最简单的方案之一。

官方文档:https://docs.bigmodel.cn/cn/coding-plan/tool/claude

最简配置(使用默认 GLM-4.7 映射):

# 环境变量方式
export ANTHROPIC_AUTH_TOKEN="你的智谱Key"
export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"

或使用配置文件(智谱官方推荐方式):

// ~/.claude/settings.json
{
 "env": {
  "ANTHROPIC_AUTH_TOKEN": "你的智谱Key",
  "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
  "API_TIMEOUT_MS": "3000000",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}

另外智谱官方要求在 ~/.claude.json 中添加(跳过首次启动的引导流程):

// ~/.claude.json
{
 "hasCompletedOnboarding": true
}

配置完成后重启终端,运行 claude 即可。默认服务端映射如上表(Opus/Sonnet → GLM-4.7,Haiku → GLM-4.5-Air)。

使用 GLM-5.1(需手动覆盖三个槽位):

GLM-5.1 / GLM-5-Turbo 作为高阶模型,对标 Claude Opus,使用时会按“高峰期 3 倍、非高峰期 2 倍”系数消耗套餐额度(”高峰期”为每日 14:00~18:00 UTC+8)。如需使用,手动覆盖:

// ~/.claude/settings.json
{
 "env": {
  "ANTHROPIC_AUTH_TOKEN": "你的智谱Key",
  "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5-turbo",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
  "API_TIMEOUT_MS": "3000000",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}

注意: 版本兼容提醒:第三方 Anthropic 兼容接口可能会受到 Claude Code 新功能影响。如果遇到工具调用或 Beta 参数报错,优先查看对应厂商官方文档的兼容说明,不要盲目复制旧版本配置。

提示: 一键脚本:macOS / Linux 用户可以直接运行官方脚本自动完成上述配置:

curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

接入 Kimi(月之暗面)的完整步骤(严格按 Kimi 官方文档):

Kimi 为 Claude Code 提供了 Anthropic 兼容端点,推荐使用 kimi-k2.5 模型(在 Agentic / 工具调用场景下的主力型号)。

官方文档:https://platform.moonshot.cn/docs/guide/agent-support

Step 1:在 https://platform.kimi.com/console/api-keys 创建 API Key。建议同时在项目设置里设置「项目日消费预算」防超支。

Step 2:设置环境变量

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 Moonshot API Key>"
$env:ANTHROPIC_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.5"
$env:CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.5"
$env:ENABLE_TOOL_SEARCH="false"
claude

macOS / Linux:

export ANTHROPIC_BASE_URL=https://api.moonshot.ai/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 Moonshot API Key>
export ANTHROPIC_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=kimi-k2.5
export CLAUDE_CODE_SUBAGENT_MODEL=kimi-k2.5
export ENABLE_TOOL_SEARCH=false
claude

Step 3:进入 cc 后输入 /status 验证模型状态。如需启用 kimi-k2.5 的思考(Thinking)能力,进入 cc 后按 Tab 键切换,看到 “Thinking on” 即为生效。

注意: 重要:不要使用老写法 https://api.moonshot.cn/v1 + moonshot-v1-128k。它们是 Kimi 的 OpenAI 兼容端点与早期模型名,在 Claude Code 中会遇到工具调用不可靠。官方为 Claude Code 提供的是 /anthropic 端点 + kimi-k2.5。

所有模型配置速查表(以各厂商官方文档为准):

模型接口类型API Base URL模型名称 / 映射是否需 --model官方文档
Claude (官方)Anthropic 原生默认建议使用 sonnet / opus / haiku 别名或官方当前模型 ID否https://docs.anthropic.com
Claude (中转)Anthropic 兼容中转服务商地址同上否中转服务商网站
DeepSeekAnthropic 兼容https://api.deepseek.com/anthropic官方示例:deepseek-v4-pro[1m]、deepseek-v4-flash否api-docs.deepseek.com
智谱 GLMAnthropic 兼容https://open.bigmodel.cn/api/anthropic默认 Opus/Sonnet→GLM-4.7、Haiku→GLM-4.5-Air否docs.bigmodel.cn
KimiAnthropic 兼容https://api.moonshot.ai/anthropic三个槽位都用 kimi-k2.5否platform.moonshot.cn
通义千问MaxOpenAI 兼容https://dashscope.aliyuncs.com/compatible-mode/v1qwen-max是dashscope.aliyun.com

注意: 重要区分:

  • 官方提供 Anthropic 兼容端点的厂商(DeepSeek、GLM、Kimi):使用完整的 ANTHROPIC_* 环境变量集进行三级槽位映射,无需 --model。
  • OpenAI 兼容端点厂商(千问、Ollama、其他中转):仍需 --model 指定具体模型名。
  • 统一使用 ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL 进行认证;不要使用已废弃的 OPENAI_API_KEY + OPENAI_BASE_URL 方式。
2.3.2.4 配置验证与诊断

无论使用上述哪种方案,配置完成后都应进行验证:

快速验证三步走:

# Step 1:启动 Claude Code
$ claude
​
# Step 2:在对话中检查当前状态
> /status
# 查看当前使用的模型、API Endpoint 是否正确
​
# Step 3:发送测试消息
> 你好,请告诉我你是什么模型

如果 AI 正常回复,说明配置成功。如果出现错误,请参考第三部分 3.7 节的 FAQ 进行排查。

提示:使用 /model 命令可以查看和切换当前模型,使用 /cost 命令可以实时查看 Token 消耗和费用。

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容