准备工作
在 CodeGateway 官网 注册账号，绑定支付方式后可获得起步试用额度，具体金额以注册/定价页实时展示为准。
在 Dashboard「API 密钥」页创建密钥（sk-cg- 开头）。
本教程只改 Qwen Code 的用户级配置，不修改项目文件。
第一步：安装 Qwen Code
npm install -g @qwen-code/qwen-code安装完成后运行 qwen --version 确认版本（本次实测针对 0.21.x）。
第二步：登记 CodeGateway 为模型服务商
Qwen Code 的用户级配置文件是 ~/.qwen/settings.json。把以下内容写入（如文件已存在，仅合并 modelProviders 字段）：
{
"modelProviders": {
"openai": [
{
"id": "deepseek-v4-pro",
"name": "DeepSeek V4 Pro via CodeGateway",
"envKey": "CG_KEY",
"baseUrl": "https://api.codegateway.dev/v1"
}
]
}
}字段说明：
id：模型 id，必须与 CodeGateway 模型清单中的 id 一致。baseUrl：CodeGateway 的 OpenAI 兼容基线地址，固定https://api.codegateway.dev/v1。envKey：存放密钥的环境变量名（推荐），也可以省略后使用默认的OPENAI_API_KEY。
然后在 ~/.qwen/.env 中写入密钥：
CG_KEY=sk-cg-你的密钥需要更多模型时，在 modelProviders.openai 数组里追加条目即可，例如：
{
"id": "kimi-k2.7-code",
"name": "Kimi K2.7 Code via CodeGateway",
"envKey": "CG_KEY",
"baseUrl": "https://api.codegateway.dev/v1"
}想完全替换 Qwen 官方服务（不保留原模型），可追加 providerProtocol 不必要——openai 是内置键，直接覆盖数组内容即可。
第三步：验证调用
先验证网关链路：
curl https://api.codegateway.dev/v1/models \
-H "Authorization: Bearer sk-cg-你的密钥"再运行 Qwen Code 非交互模式：
qwen -p "只回复两个字：你好" --model deepseek-v4-pro返回回复即接入成功。之后在工作目录直接运行 qwen 进入交互模式，按 Tab 或 /model 选择已登记的模型。
可用模型建议
OpenAI 兼容协议下，CodeGateway 推荐以下模型（均为实测可用）：
deepseek-v4-pro：代码场景主力，性价比高。kimi-k2.7-code：长代码任务表现好。glm-5.3：综合平衡。qwen3.8-27b：纯推理轻量选择。
注意：GPT 系模型（gpt-5.3-codex、gpt-5.5 等）受上游服务商地区政策限制，从部分国家或地区调用会返回 400。Claude 系与 Gemini 系模型在 OpenAI 兼容协议下不可用（它们走 Anthropic 消息协议，见 Claude Code 接入）。
常见问题
Q：配置后提示找不到模型？ 检查 id 是否与 模型清单 中的 id 完全一致（大小写敏感）；再确认 baseUrl 末尾是 /v1。
Q：报 401 Unauthorized？ 检查 ~/.qwen/.env 中的密钥是否完整、是否以 sk-cg- 开头；envKey 字段名必须与环境变量名一致。
Q：如何换回 Qwen 官方模型？ 删掉 ~/.qwen/settings.json 里的 modelProviders 字段（或恢复原备份）即可。
Q：Qwen Code 会读取项目里的设置吗？ 会。项目级 settings.json（项目根目录）优先级高于用户级 ~/.qwen/settings.json，如果你在项目里也配置过模型服务商，以项目为准。
Q：为什么推荐模型里没有 Gemini/Claude？ Gemini 系与 Claude 系模型仅支持 Anthropic 消息协议；Qwen Code 走 OpenAI 兼容协议，因此只能选用 OpenAI 兼容的模型（DeepSeek/Kimi/GLM/Qwen 等）。需要用 Gemini 模型的话参考 Gemini CLI 兼容性说明 里的替代方案。