Skip to content

Codex CLI ​

Codex 是 OpenAI 推出的终端 AI 编程助手。您可以通过调整配置来使用 ChatECNU 的模型,详见 Responses API 兼容。Codex 的 VS Code 插件和桌面应用与命令行共用同一份配置。

安装工具 ​

bash
npm install -g @openai/codex
codex --version

设置环境变量 ​

在 我的令牌 中创建并复制您的 API Key,然后保存到环境变量 CHATECNU_API_KEY。

macOS / Linux(zsh 用户写入 ~/.zshrc,bash 用户写入 ~/.bashrc):

bash
echo 'export CHATECNU_API_KEY="your_api_key"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell(执行后重新打开终端):

powershell
[Environment]::SetEnvironmentVariable("CHATECNU_API_KEY", "your_api_key", "User")

注意:环境变量名不能包含连字符 -,否则 export 和 PowerShell 都会报错,请使用 CHATECNU_API_KEY 这样的写法。

修改配置文件 ​

将下面的内容保存为 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml),添加 ChatECNU 作为 provider:

toml
model = "ecnu-max"
model_provider = "chatecnu"
model_context_window = 512000
web_search = "disabled"

[model_providers.chatecnu]
name = "ChatECNU"
base_url = "https://chat.ecnu.edu.cn/open/api/v1"
wire_api = "responses"
env_key = "CHATECNU_API_KEY"

如果 config.toml 已经存在,请把上面的内容合并进去:model 等顶层配置项要写在所有 [...] 小节之前,[model_providers.chatecnu] 小节追加在文件末尾即可。

配置说明 ​

字段说明
model使用的模型,可选 ecnu-max、ecnu-plus。改用 ecnu-plus 时,请把 model_context_window 改为 256000
model_provider提供方标识,需与 [model_providers.xxx] 中的 xxx 一致
model_context_window模型的上下文窗口:ecnu-max 为 512000,ecnu-plus 为 256000
web_search平台不提供原生联网搜索,设为 "disabled" 后 Codex 不会在请求中携带 web_search 工具
base_url平台的 Responses 兼容端点
wire_apiAPI 协议类型,固定为 "responses",这是 Codex 目前唯一支持的协议
env_key保存 API Key 的环境变量名

启动工具 ​

启动 Codex,即可使用 ChatECNU 的模型能力:

bash
cd /path/to/my-project
codex

注意:启动时 Codex 会提示 Model metadata for ecnu-max not found. Defaulting to fallback metadata,表示它不认识这个模型名,改用默认的模型信息。上面已经通过 model_context_window 指定了上下文窗口,可以忽略该提示。

注意:ecnu-max 同时最多处理 3 个请求,ecnu-plus 为 5 个,超出会返回 429,详见 配额限制。

指定思考强度 ​

思考强度可通过 reasoning.effort 指定。在 config.toml 的顶层加入 model_reasoning_effort 即可,例如:

toml
model_reasoning_effort = "high"

ecnu-max 支持 low / high / max,ecnu-plus 支持 low / medium / xhigh,Codex 的其他档位会由平台映射,详见 Responses API 兼容 思考强度支持。

您的请求将按 credits 配额统一处理,详见 配额限制。