Claude Code 接入
两个环境变量,把 Claude Code 跑在平台任意模型上。
GoodPut AI 完整实现 Anthropic Messages 协议(含流式、工具调用与思考过程回传),Claude Code 可直接把平台作为网关使用。
配置环境变量
export ANTHROPIC_BASE_URL="https://api.goodputai.cn"
export ANTHROPIC_AUTH_TOKEN="你的 GoodPut API Key"
export ANTHROPIC_MODEL="z-ai/glm-5.2"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.goodputai.cn", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的 GoodPut API Key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "z-ai/glm-5.2", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "deepseek/deepseek-v4-flash", "User")如果本机还配置过 ANTHROPIC_API_KEY,建议将其置空,避免与 ANTHROPIC_AUTH_TOKEN 冲突。
启动
重新打开终端运行 claude 即完成接入。
模型选择
主模型与轻量模型都可以指定为模型库中的任意模型:
| 模型 | 适用场景 |
|---|---|
z-ai/glm-5.2 | 工程化任务与中文场景表现突出,编码 Agent 主力(自营算力供给) |
deepseek/deepseek-v4-pro | 旗舰推理能力,复杂任务可用 |
deepseek/deepseek-v4-flash | 轻快便宜,适合作为 ANTHROPIC_SMALL_FAST_MODEL |
即使不设置 ANTHROPIC_MODEL,Claude Code 默认请求的 Claude 系列模型名也会被平台自动映射到兼容模型,不会因模型名不存在而报错;仍建议显式指定,行为更可控。
协议兼容说明
平台网关会对上游差异做协议清洗(如历史消息中思考块的 signature 字段兼容、content 空值修正),无需在客户端做任何适配。/v1/messages/count_tokens 端点同样可用,Claude Code 的上下文用量统计可正常工作。
常见问题
修改环境变量后不生效
环境变量在终端启动时读取——修改 rc 文件后需要重新打开终端(或 source ~/.zshrc)再运行 claude。
如何确认走的是 GoodPut 网关
启动 Claude Code 后执行 /status,检查 API Base URL 是否为 https://api.goodputai.cn。
网络搜索能用吗
可以。Claude Code 的 WebSearch 工具会由平台的网络搜索服务承接,详见网络搜索。
长任务偶发超时
单请求默认超时较长,一般无需调整;如自建代理链路有更短的空闲超时,建议将代理的空闲超时调到 600 秒以上。