接入指南 / 在 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 文档。