支持哪些工具
CodeGateway 提供三种兼容对接面,当前主流的 Agent CLI 大部分可以直接接入:
Claude Code:设置两个环境变量即可,见 Claude Code 一键脚本。
OpenAI Codex CLI:设置基线地址与密钥即可,见 Codex CLI 接入教程。
加载中…
三种兼容端点、模型通路规则与逐工具配置入口一览——主流 Agent CLI 接入 CodeGateway 的起点。
CodeGateway 提供三种兼容对接面,当前主流的 Agent CLI 大部分可以直接接入:
Claude Code:设置两个环境变量即可,见 Claude Code 一键脚本。
OpenAI Codex CLI:设置基线地址与密钥即可,见 Codex CLI 接入教程。
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 官网 点击右上角注册,邮箱 + 密码完成注册,注册即赠 2 美元试用额度。
登录 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 等)受上游服务商地区政策限制,从部分国家或地区发起会返回 400,提示更换模型或切换网络区域。
Claude 系与 Gemini 系模型在 OpenAI 补全协议下不可用;反之 GPT 系在消息协议下同样受地区限制。
完整模型清单随时可在 Dashboard「模型清单」页面查看,也可以直接调用模型清单接口获取。
选择建议:代码场景优先 deepseek-v4-pro、kimi-k2.7-code 或 glm-5.3(OpenAI 协议工具);Claude Code 场景直接用 claude-sonnet-4-6。
Q:一个密钥能同时用于多个工具吗? 可以。密钥只区分账号与项目,不区分协议;同一个密钥既可用于 Claude Code,也可用于 Qwen Code。
Q:配置后报 401 Unauthorized? 检查密钥是否完整复制(sk-cg- 开头整串)、是否过期;密钥在 Dashboard 可重新生成。完整排查见 常见报错排查。
Q:用 GPT 模型时提示 400 不支持地区? GPT 系模型受上游地区政策限制。改用 DeepSeek / Kimi / GLM / Qwen 系模型即可,或换用受支持的网络区域后重试。
Q:Claude Code 里能用 Gemini 模型吗? 可以。Anthropic 消息协议下 gemini-3.8-flash 可用,在 Claude Code 的配置文件里把模型换成 gemini-3.8-flash 即可(需要该模型在你的模型中可见)。
Q:文档里的模型名去哪里确认最新值? Dashboard → 模型清单,或调用模型清单接口(见上文验证命令)。帮助中心文档会标注核对日期,但以清单接口为准。
Q:忘记密钥怎么办? 密钥只显示一次。丢失后在 Dashboard 删除旧密钥并新建即可,不影响账号余额。
Q:可以开发票吗? 可以。充值后可联系支持团队开具发票,详见 充值 & 费用指南。