Codex CLI

Codex CLI 是 OpenAI 的本地终端编程代理，支持通过自定义模型服务商接入 OpenAI 兼容接口。接入 WisGate 后，可以在终端中使用 WisGate 模型完成代码生成、项目分析、文件修改和调试任务。

一、安装 Codex CLI

请先按照 Codex CLI 官方说明完成安装。安装完成后，运行以下命令确认可用：

codex --version

二、配置 WisGate

Codex CLI 通常读取 ~/.codex/config.toml。如果文件不存在，请手动创建。

model_provider = "wisgate"
model = "gpt-5.5"
model_reasoning_effort = "high"

[model_providers.wisgate]
name = "WisGate"
base_url = "https://api.wisgate.cn/v1"
env_key = "WISGATE_API_KEY"

然后在 shell 中设置 WisGate API Key：

export WISGATE_API_KEY="your_wisgate_api_key"

如果希望长期生效，请把这行写入 ~/.zshrc、~/.bashrc 或对应 shell 配置文件。

三、开始使用

进入项目目录后启动 Codex CLI：

cd /path/to/your/project
codex

启动后，Codex CLI 会通过 https://api.wisgate.cn/v1 调用所配置的模型。

使用场景

• 终端内开发：在命令行中分析项目、生成代码和修改文件。
• 代码审查：让 Codex CLI 检查变更、总结风险并给出修复建议。
• 重构任务：拆分复杂模块、调整结构并运行验证命令。
• 团队统一配置：通过同一套 config.toml 模板统一接入 WisGate。

常见问题

鉴权失败

请确认 WISGATE_API_KEY 已设置，且 env_key 与环境变量名称一致。

模型不可用

请确认 model 填写的是 WisGate 支持的模型 ID。OpenAI 兼容入口必须使用 https://api.wisgate.cn/v1。