准备工作
在 CodeGateway 官网 注册账号(赠 2 美元试用额度)。
在 Dashboard「API 密钥」页创建密钥(sk-cg- 开头)。
更新之前先确认你的 Reasonix 版本:
reasonix --version。
版本区分(重要)
Reasonix 有两个大版本线,配置方式不同,不要混用:
加载中…
Reasonix 只认 DeepSeek 兼容端点,填一个 baseUrl 就能用上 CodeGateway 的模型,支持 0.53.x 与 v1.x 两种配置。
在 CodeGateway 官网 注册账号(赠 2 美元试用额度)。
在 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)。
下文按版本分别给出配置。
最省事的接入方式,两个环境变量即可:
export DEEPSEEK_BASE_URL="https://api.codegateway.dev/v1"
export DEEPSEEK_API_KEY="sk-cg-你的密钥"DEEPSEEK_API_BASE_URL 是 DEEPSEEK_BASE_URL 的别名,二选一。配置后直接启动 reasonix 即可。
{
"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 与 模型清单 一致。
~/.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 → 模型清单)