先在终端验证 Key
请求 /v1/models，确认网络、鉴权和模型列表正常。
客户端与接口格式对照
| 客户端或工具 | 优先接口 | Base URL | 注意事项 |
|---|---|---|---|
| Claude Code | Anthropic Messages | https://claudeagent.com.cn | 使用 ANTHROPIC_BASE_URL 和 AUTH_TOKEN |
| Cursor / Cline / Roo Code | OpenAI-compatible | https://claudeagent.com.cn/v1 | 设置入口随版本和 provider 变化 |
| OpenCode / Continue | OpenAI-compatible | https://claudeagent.com.cn/v1 | 从 /v1/models 复制模型 id |
| Kiro | 取决于当前 provider 支持 | 按 Anthropic 或 OpenAI 格式填写 | 先确认版本允许自定义 endpoint |
| Windsurf | 取决于客户端版本 | https://claudeagent.com.cn/v1 | 若无法自定义地址，不要强行替换官方 provider |
| SillyTavern | OpenAI-compatible | https://claudeagent.com.cn/v1 | 先用非流式短请求验证 |
| Codex CLI | OpenAI-compatible provider | https://claudeagent.com.cn/v1 | 配置方式以当前客户端文档为准 |
“兼容”取决于客户端是否允许自定义 Base URL、API Key 和模型名。客户端升级后设置入口可能变化，本页不承诺每个版本都开放这些选项。
通用配置流程
再选择 provider 格式
Claude Code 使用 Anthropic 根地址；多数通用客户端使用 OpenAI-compatible /v1。
最后处理客户端映射
关闭自动模型替换，复制真实模型 id，并检查流式与超时选项。
配置后如何验收
- 发送“只回复 OK”的短请求，记录模型、分组、耗时和 request id。
- 再测试流式输出、工具调用或图片等业务必需能力。
- 在控制台日志核对模型名、Token 和扣费，不用客户端估算替代账单。
- 遇到 401、429 或 503 时按错误排查指南处理。
常见问题
所有客户端都能自定义 API 地址吗？
不能。是否开放 Base URL 和自定义 provider 取决于客户端及其版本。
客户端连接失败先查什么？
先在终端请求 /v1/models；终端成功后再检查客户端 provider 和模型映射。