https://cheapcoding.cc客户端会自行追加 Anthropic API 路径。
Documentation / Troubleshooting
从第一条请求，
到定位每一种错误。
面向 Claude Code 与 Anthropic SDK 的接入说明。先用最小请求验证连接，再按 HTTP 状态码、error.type 与响应头定位问题。
先检查这四项Base URL、API Key、账户余额和模型名。多数接入问题可在这里解决。
01
Quick start
先确认密钥与模型可用
Base URL 填写 https://cheapcoding.cc，不要额外拼接 /v1。可使用 x-api-key，或使用格式为 Authorization: Bearer YOUR_API_KEY 的请求头。
列出可用模型
curl https://cheapcoding.cc/v1/models \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01"返回模型列表说明地址与密钥已连通。请从列表复制模型 ID；不要凭记忆填写。
02
Configuration
客户端配置
sk-...在控制台创建并立即妥善保存；不要提交到仓库。
GET /v1/models只使用接口实际返回且当前可用的模型。
03
Error reference
用户可见错误码
网关自产错误采用 Anthropic 风格 JSON：{"type":"error","error":{"type":"…","message":"…"}}。除特殊处理的 401、403 和 429 外，上游非 2xx 响应可能按原状态与正文透传，因此客户端应允许未来状态码。
| HTTP | error.type | 常见原因 | 建议处理 |
|---|---|---|---|
| 400 | invalid_request_error | 鉴权头冲突、JSON 无效、参数或 stream 格式错误。 | 只保留一种密钥写法，校验请求体与参数。 |
| 401 | authentication_error | Gateway Key 缺失、无效、撤销、过期，或账户当前不可用。 | 重新复制控制台中的有效 Key；检查环境变量是否被旧值覆盖。 |
| 402 | billing_error | 余额不足、账户被禁用，或钱包准入暂时失败。 | 检查余额与账户状态；充值后重试。 |
| 403 | permission_error | Key 缺少 messages:create scope。 | 换用具备调用权限的 Key。 |
| 404 | not_found_error | API 路径不存在。 | 使用 /v1/messages、/v1/messages/count_tokens、/v1/models 或 /v1/usage。 |
| 405 | invalid_request_error | HTTP 方法不支持。 | 消息接口用 POST；模型与用量接口用 GET。 |
| 413 | invalid_request_error | 请求体超过 32 MiB 或读取失败。 | 压缩上下文、图片和工具结果后重试。 |
| 429 | rate_limit_error | 瞬时限速、额度窗口耗尽、消费上限、模型权限或 Workspace 限制。 | 查看 x-provider-limit-kind 与 Retry-After，按分类处理。 |
| 500 | api_error | 用量统计暂时不可用等网关内部错误。 | 保留 request-id，稍后重试。 |
| 501 | api_error | 当前 Provider 不支持 count_tokens。 | 在客户端估算，或改用支持该接口的模型。 |
| 502 | api_error | Provider 连接失败、响应过大、JSON 或 SSE 响应无效。 | 稍后重试；持续发生时提交请求 ID。 |
| 503 | api_error | 排队/容量不足、模型待验证、上游认证失败、暂时隔离或提交响应失败。 | 尊重 Retry-After；短暂退避后重试。 |
04
Rate limits
读懂 429 的限制分类
transient_rate瞬时请求速率限制。优先遵循 Retry-After，使用指数退避。
quota_exhausted当前额度窗口已耗尽。等待窗口恢复或降低并发与用量。
spend_cap上游消费上限已到。通常需要等待额度或配置恢复。
model_access_denied当前账号没有该模型权限，或模型需要额外 Credits。
workspace_limitWorkspace 级限制。降低 Workspace 用量后再试。
unknown证据不足，无法继续细分。按普通 429 退避并保留诊断头。
05
Troubleshooting
按现象排查
所有请求都返回 401
- 确认 Base URL 为
https://cheapcoding.cc。 - 确认没有同时发送两个不同的
x-api-key，也没有同时使用不一致的 Bearer Key。 - 检查 shell、IDE 与系统环境变量是否仍保存旧 Key。
- 在控制台确认 Key 未撤销或过期，然后用
/v1/models最小请求复测。
返回 404 或客户端提示找不到接口
不要把 Base URL 配成 https://cheapcoding.cc/v1 后又让客户端追加 /v1。最终请求路径应只有一段 /v1。
频繁出现 429
先看 x-provider-limit-kind。瞬时限速采用带抖动的指数退避；额度与消费上限不应高频重试；模型权限问题应从 /v1/models 重新选择模型。
返回 503
503 可能代表排队满、账号池暂不可用、模型验证中或上游认证失败。遵循 Retry-After；如果持续发生，提交 request-id、时间和模型名。
流式响应中途断开
HTTP 响应开始后，网关不会切换凭据或拼接替代流。客户端应把提前 EOF、连接中断或缺少 message_stop 视为失败，并以新的请求重试。
修改配置后仍然使用旧地址或旧 Key
完全退出并重启客户端，确认配置文件与环境变量的优先级。打印配置时只显示 Key 的前后少量字符，切勿输出完整密钥。
06
Diagnostics
提交有效的诊断信息
需要协助时，请将以下诊断信息发送至 support@cheapcoding.cc。
请提供
- 发生时间与时区
- 请求路径、HTTP 状态和
error.type request-id与x-cheapcoding-session-id- 模型名、是否流式、可复现步骤
请勿提供
- 完整 API Key 或 Authorization 头
- 用户消息、文件内容或工具输出
- Provider Token、Cookie 或生产数据库信息