支持哪些工具
CodeGateway 提供三种兼容对接面，当前主流的 Agent CLI 大部分可以直接接入：
Claude Code：设置两个环境变量即可，见 Claude Code 一键脚本。
OpenAI Codex CLI：设置基线地址与密钥即可，见 Codex CLI 接入教程。
OpenClaw：改一行配置地址加一个密钥，见 OpenClaw 接入教程。
Qwen Code：在用户配置里登记一个兼容服务商，见 Qwen Code 接入教程。
DeepSeek Harness：在模型设置里添加自定义供应商，见 DeepSeek Harness 接入教程。
Reasonix：改配置里的服务地址即可，见 Reasonix 接入教程。
GitHub Copilot CLI：通过四个环境变量指向自定义供应商，见 Copilot CLI 接入教程。
opencode / Aider / Crush：均为 OpenAI 兼容或 Anthropic 兼容工具，对应文档见 帮助中心。
Gemini CLI：官方仅支持 Gemini 原生协议，无法直连本网关，见 Gemini CLI 兼容性说明。
Cursor CLI：官方仅支持 Cursor 账号登录，无法直连本网关，见 Cursor CLI 兼容性说明。
第一步：注册与创建密钥
打开 CodeGateway 官网 点击右上角注册，邮箱 + 密码完成注册，注册并绑定支付方式后可获得起步试用额度，具体金额以注册/定价页实时展示为准。
登录 Dashboard，进入「API 密钥」页面创建一个密钥。
密钥以 sk-cg- 开头，创建时只显示一次，请立即保存。
一个账号可以创建多个密钥，建议按项目或工具各用一个。
第二步：选择对接端点
CodeGateway 对外提供三类兼容协议，工具选哪类取决于它"讲哪门语言"：
Anthropic 消息协议（Claude Code / Crush 等）：基线地址填写
https://api.codegateway.dev，调用路径为/v1/messages。OpenAI 补全协议（Codex CLI / Qwen Code / opencode / Aider / Copilot CLI 等）：基线地址填写
https://api.codegateway.dev/v1，调用路径为/v1/chat/completions。OpenAI Responses 协议（Codex CLI 的响应模式）：基线地址同上，路径为
/v1/responses。
第三步：按工具配置
每种工具的配置位置不同（环境变量或配置文件），逐工具的完整步骤见对应文档。最常用的两种：
Claude Code：
export ANTHROPIC_BASE_URL="https://api.codegateway.dev"
export ANTHROPIC_AUTH_TOKEN="sk-cg-你的密钥"Codex CLI：
export OPENAI_BASE_URL="https://api.codegateway.dev/v1"
export OPENAI_API_KEY="sk-cg-你的密钥"其余工具（Qwen Code / DeepSeek Harness / Reasonix / opencode / Aider / Crush / Copilot CLI）的配置片段，见各工具文档。
第四步：验证连通
任意工具配置完成后，先验证底层链路：
curl https://api.codegateway.dev/v1/models \
-H "Authorization: Bearer sk-cg-你的密钥"返回模型清单即链路已通。之后在对应工具里发起一条简单消息即可确认端到端可用。
模型通路规则（重要）
不同协议的模型支持范围不同，这是接入时最常见的踩坑点：
Anthropic 消息协议下：支持 Claude 系（如 claude-sonnet-4-6）与 Gemini 系（如 gemini-3.8-flash）。这两类模型在消息协议面返回标准结构，可放心使用。
OpenAI 补全协议下：支持 DeepSeek（deepseek-v4-pro）、Kimi（kimi-k2.7-code）、GLM（glm-5.3）、Qwen（qwen3.8-27b）等；GPT 系模型（gpt-5.3-codex、gpt-5.5 等）可能受上游服务商地区策略影响，请求可能被拒并返回 unsupported country/region/territory。这通常是瞬态（重试即可恢复），网关返回 503（可重试）并带 Retry-After，SDK 会自动重试；持续失败再更换模型或网络出口。
Claude 系与 Gemini 系的文本模型在 OpenAI 补全协议下不可用；反之 GPT 系在消息协议下也可能撞上游瞬态区域拒绝（503 可重试，先重试）。
完整模型清单随时可在 Dashboard「模型清单」页面查看，也可以直接调用模型清单接口获取。
选择建议：代码场景优先 deepseek-v4-pro、kimi-k2.7-code 或 glm-5.3（OpenAI 协议工具）；Claude Code 场景直接用 claude-sonnet-4-6。
计费与试用额度
按实际 token 用量计费，统一 1.07× 倍率见 统一倍率详解。
绑定支付方式后可获得起步试用额度（具体金额以注册/定价页实时展示为准），可用于任何模型的试用调用。
充值支持信用卡（Visa / Mastercard / AmEx）、Stripe Link、支付宝与银行转账，详见 充值 & 费用指南。
常见问题
Q：一个密钥能同时用于多个工具吗？ 可以。密钥只区分账号与项目，不区分协议；同一个密钥既可用于 Claude Code，也可用于 Qwen Code。
Q：配置后报 401 Unauthorized？ 检查密钥是否完整复制（sk-cg- 开头整串）、是否过期；密钥在 Dashboard 可重新生成。完整排查见 常见报错排查。
Q：用 GPT 模型时提示不支持地区（503 unsupported country/region/territory）？这通常是瞬态的：网关返回 503 并带 Retry-After，SDK 会自动重试；实测重试即可恢复（唯一一次受控重试 94 秒成功；48h 内 10 次的恢复中位数约 3 分钟，属上界口径）。若持续失败，再改用 DeepSeek / Kimi / GLM / Qwen 系模型，或换用受支持的网络区域。
Q：Claude Code 里能用 Gemini 模型吗？ 可以。Anthropic 消息协议下 gemini-3.8-flash 可用，在 Claude Code 的配置文件里把模型换成 gemini-3.8-flash 即可（需要该模型在你的模型中可见）。
Q：文档里的模型名去哪里确认最新值？ Dashboard → 模型清单，或调用模型清单接口（见上文验证命令）。帮助中心文档会标注核对日期，但以清单接口为准。
Q：忘记密钥怎么办？ 密钥只显示一次。丢失后在 Dashboard 删除旧密钥并新建即可，不影响账号余额。
Q：可以开发票吗？ 可以。充值后可联系支持团队开具发票，详见 充值 & 费用指南。