Codex CLI / VS Code 接入

Codex 的自定义模型提供方使用 Responses API。因此先用 Responses 最小请求验证目标模型，再测试 Codex 的实际对话与工具调用。MOXII AI 当前可用的 Codex 模型名单尚未确认。

准备

安装最新版 Codex CLI 或 VS Code Codex 扩展。为 Codex 单独创建令牌，并在运行 Codex 的本机环境设置 MOXII_API_KEY。不要将密钥写进配置文件。

配置文件

编辑 ~/.codex/config.toml；在 VS Code 扩展中，可通过右上角齿轮打开 Codex Settings → Open config.toml。把以下内容与现有配置合并，避免覆盖已有设置：

model = "YOUR_RESPONSES_MODEL_ID"
model_provider = "moxii"

[model_providers.moxii]
name = "MOXII AI"
base_url = "https://api.moxii.cc/v1"
env_key = "MOXII_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

YOUR_RESPONSES_MODEL_ID 必须换成已在控制台确认、且实际支持 Responses 的模型 ID。重启终端或 VS Code，让新环境变量生效。CLI 中启动 codex 进行短对话，再验证读取文件等所需能力。若只支持 Chat Completions，不能通过修改 wire_api 让 Codex 兼容。

排查

• 401：检查环境变量是否在 Codex 进程中可见，令牌是否有效。
• 404 或协议报错：确认 URL 末尾为 /v1，目标模型和当前网关支持 Responses。
• 429：检查账户余额、令牌额度及频率限制。
• 对话能用而工具调用失败：检查该模型和渠道的工具调用能力，并向管理员提供脱敏错误信息。

参考：OpenAI Docs 配置基础、配置参考。