准备工作
在 CodeGateway 官网 注册账号（绑定支付方式后可获得起步试用额度，具体金额以注册/定价页实时展示为准）。
在 Dashboard「API 密钥」页创建密钥（sk-cg- 开头）。
更新之前先确认你的 Reasonix 版本：
reasonix --version。
版本区分（重要）
Reasonix 有两个大版本线，配置方式不同，不要混用：
0.53.x（当前 npm 主流）：JSON 配置
~/.reasonix/config.json，顶层baseUrl/apiKey/model字段。v1.x（Go 重写版）：TOML 配置
~/.reasonix/config.toml，[[providers]]表 +api_key_env（密钥存全局.env）。
下文按版本分别给出配置。
方式一：环境变量（0.53.x）
最省事的接入方式，两个环境变量即可：
export DEEPSEEK_BASE_URL="https://api.codegateway.dev/v1"
export DEEPSEEK_API_KEY="sk-cg-你的密钥"DEEPSEEK_API_BASE_URL 是 DEEPSEEK_BASE_URL 的别名，二选一。配置后直接启动 reasonix 即可。
方式二：配置文件 ~/.reasonix/config.json（0.53.x）
{
"baseUrl": "https://api.codegateway.dev/v1",
"apiKey": "sk-cg-你的密钥",
"model": "deepseek-v4-pro"
}baseUrl：CodeGateway OpenAI 兼容基线地址，固定https://api.codegateway.dev/v1。apiKey：你的密钥。注意与方式一同时设置时，环境变量优先（成对生效：baseUrl + apiKey 必须来自同一来源）。model：默认模型，id 与 模型清单 一致。
v1.x（Go 重写版）配置
~/.reasonix/config.toml：
[[providers]]
name = "cg"
kind = "openai" # openai | anthropic
base_url = "https://api.codegateway.dev/v1"
models = ["deepseek-v4-pro"]
default = true
api_key_env = "CG_KEY"密钥放到 Reasonix 的全局 .env（如 ~/.reasonix/.env）：
CG_KEY=sk-cg-你的密钥可用模型建议
Reasonix 通过 DeepSeek 兼容端点调用，CodeGateway OpenAI 协议面推荐的模型（实测可用）：
deepseek-v4-pro：首选，前缀缓存友好。deepseek-v4-flash：轻量任务。kimi-k2.7-code/glm-5.3：同为 OpenAI 兼容模型，可按需替换（Reasonix 信任自定义端点的模型命名空间）。
注意：GPT 系模型受上游地区政策限制；Claude / Gemini 系模型不支持 OpenAI 兼容协议，请勿配置。
常见问题
Q：如何确认当前用的是哪个版本？ reasonix --version。0.53.x 显示 x.y.z；v1.x 系列以 Go 重写版标记（一般 ≥ 1.x）。
Q：环境变量和配置文件都设置了，生效哪个？ 环境变量优先。且两者成对生效——环境变量设置了 baseUrl 时也要用环境变量放 key，否则 key 会从配置文件读取，造成端点与密钥不匹配。
Q：启动后报认证失败？ Reasonix 对自定义端点不做预校验，第一次调用才会暴露问题。检查密钥是否有效（用文末的模型清单接口验证）。
Q：可以只改模型不改端点吗？ 可以。model 字段单独改即可，但 id 必须在 模型清单 中存在。
相关资料
参考资料
模型清单接口 说明（Dashboard → 模型清单）