接入指南 / 在 Claude Code 中使用国产大模型

在 Claude Code 中使用国产大模型

Claude Code 通过 Anthropic 协议和模型服务通信。token中泽信业 同时提供 Anthropic 兼容的 /v1/messages 接口,所以只需要改几个环境变量,就能让 Claude Code 使用国产大模型,国内网络直接可用。

1. 准备 API Key

在控制台注册并创建一个 API Key。建议给 Claude Code 单独建一个 Key,并设置每日消费上限,避免长时间自动运行时消费失控。

2. 写入配置

编辑 ~/.claude/settings.json(Windows 为用户目录下的 .claude\settings.json),加入:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token.zzxytech.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro"
  }
}

说明:ANTHROPIC_DEFAULT_OPUS_MODEL 和 ANTHROPIC_DEFAULT_SONNET_MODEL 决定 Claude Code 里“大模型”实际调用哪个模型,ANTHROPIC_DEFAULT_HAIKU_MODEL 用于轻量任务,可以选便宜的小模型来省钱。模型名称见模型与价格。

3. 启动

claude

启动后发一句话测试。每次调用的 Token 和费用都能在控制台的用量明细里看到。

常见问题

  • 返回 401:检查 ANTHROPIC_AUTH_TOKEN 是否填了完整的 Key,Base URL 不要带 /v1。
  • 返回 402:余额不足,去控制台充值。
  • 返回 403 key_quota_exceeded:这个 Key 达到了你设置的消费上限,可在控制台调整。
  • 工具调用相关的报错:部分模型不支持某些专有工具,可以尝试在 env 里加入 "ENABLE_TOOL_SEARCH": "false"。
  • 回答是空的:多数模型会先“思考”,思考内容计入输出 Token,请不要把 max_tokens 设得过小。

更多错误码见 API 文档。