客户端接入
接入 Claude Code
把 Anthropic Claude Code CLI 的请求路由到 CokeAPI,无需修改业务代码。
Claude Code 可以直接通过 CokeAPI 的 Anthropic Messages 兼容接口调用 Claude 系列模型，也可以切到 OpenAI 兼容模式调用 GPT / Grok / Gemini 等模型。
准备
- 已安装 Claude Code CLI (npm i -g @anthropic-ai/claude-code 或
pip install claude-code) - 已在 www.cokeapi.com 拿到
sk-...形式的 API Key
推荐配置 (Anthropic 原生格式)
export ANTHROPIC_BASE_URL=https://cokeapi.com
export ANTHROPIC_API_KEY=sk-xxxxxxxx
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxx
export ANTHROPIC_MODEL=claude-sonnet-4-6
claude -p "解释一下我这个目录里的代码"可选默认模型:
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8OpenAI 兼容模式
export OPENAI_BASE_URL=https://cokeapi.com/v1
export OPENAI_API_KEY=sk-xxxxxxxx
claude --provider openai --model gpt-4o-mini "解释一下我这个目录里的代码"或写入 ~/.claude/config.toml:
[provider.openai]
base_url = "https://cokeapi.com/v1"
api_key = "sk-xxxxxxxx"
default_model = "gpt-4o-mini"推荐模型
| 任务 | 模型 |
|---|---|
| 快速响应 / 低成本 | claude-haiku-4-5 |
| 日常编码 / 解释代码 | claude-sonnet-4-6 |
| 复杂重构 / 架构设计 | claude-opus-4-8 |
| OpenAI 兼容模式 | gpt-5.5、grok-4.20-expert |
验证
claude --model claude-haiku-4-5 -p "只回复 pong"成功后,在 www.cokeapi.com 控制台「消费记录」可以看到本次扣费。
常见问题
| 问题 | 处理 |
|---|---|
model not configured | 使用 模型一览 中存在的模型 ID |
haiku4.5 卡住重试 | 推荐使用标准名 claude-haiku-4-5；如后台配置了别名，也可用 haiku4.5 |
| 429 | 当前 Key 或上游账号被限流，稍后重试 |
| 502 | 上游账号池暂无可用账号，检查后台账号状态 |