GoodPut AI

Claude Code 接入

两个环境变量,把 Claude Code 跑在平台任意模型上。

GoodPut AI 完整实现 Anthropic Messages 协议(含流式、工具调用与思考过程回传),Claude Code 可直接把平台作为网关使用。

安装 Claude Code

前提:Node.js 18 或更新版本。

npm install -g @anthropic-ai/claude-code

配置环境变量

~/.zshrc 或 ~/.bashrc
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 秒以上。

本页目录