目标很简单：本地 Claude Code 继续负责工具和文件，A1CoderClaude 负责模型请求入口、 鉴权、余额、路由、计费和日志。你只需要一个 a1_ Key。
ANTHROPIC_BASE_URL=https://api.a1coder.xyz OPENAI_BASE_URL=https://api.a1coder.xyz/v1
进入 API Keys & Models，生成一个 a1_ 开头的 Key。完整 Key 只显示一次，浏览器会临时保存一份方便复制。
Console → API Keys & Models → Generate Key
把 Claude Code 的 Anthropic 入口指向 A1 Gateway。Claude Code 仍在本地执行文件和工具，服务器只做模型请求中转。
export ANTHROPIC_BASE_URL="https://api.a1coder.xyz" export ANTHROPIC_API_KEY="a1_xxxxxxxxx" claude
A1 会保持 Anthropic SSE 事件原样返回，包括 tool_use、message_delta、usage，避免破坏 Claude Code 的本地工具循环。
POST https://api.a1coder.xyz/v1/messages x-api-key: a1_xxxxxxxxx content-type: application/json
默认走平台自营。后续商户市场启用后，可用请求头指定商户、最低价或稳定优先策略。
x-a1-provider: platform_self x-a1-provider: channel:<channelId> x-a1-provider: auto_cheapest x-a1-provider: auto_stable
base_url = "https://api.a1coder.xyz/v1" api_key = "a1_xxxxxxxxx" # POST /v1/chat/completions # Authorization: Bearer a1_xxxxxxxxx
OpenAI 流式请求建议带 stream_options.include_usage=true，这样能更准地统计 token。
用户扣费 = inputPricePerM × inputTokens / 1e6
+ outputPricePerM × outputTokens / 1e6
上游连接失败 → 不扣费
中途断流 → 按实际输出扣费
平台错误 → 不扣费| HTTP | 含义 | 处理方式 |
|---|---|---|
401 | API Key 无效、过期或被禁用 | 重新创建 Key，确认复制的是完整 a1_ 明文。 |
402 | 余额不足 | 进入 Wallet 充值或联系管理员加余额。 |
403 | 模型权限不足 | 检查 Key 的 allowedModels，或创建不限模型的新 Key。 |
409 | 供应暂不可用 | 切换供应方，或稍后重试。 |
502 / 504 | 上游错误或超时 | 查看 Usage & Logs 中的 request log，必要时换模型或供应策略。 |