Codex 配置
按量付费的 MiMo API 和 Token Plan 均支持 Codex,可参考本文进行配置与使用。
前置工作
获取凭证
支持两种使用方式,但对应的凭证获取方式不同:
| 使用方式 | 说明 | 获取方式(以下为 BASE_URL 和 API Key 均为示例) |
|---|---|---|
| 按量付费 API 调用 | 按实际使用量计费,适合轻度使用 |
前往 API Keys 创建 API Key |
| Token Plan | 固定订阅费,按套餐限量调用 |
成功订阅后,前往 Token Plan 获取专属 Base URL 和 API Key |
安装 Codex
前置要求: 需先安装 Node.js 18 或更新版本
安装命令:
npm install -g @openai/codex
验证安装(如有版本号输出,则表示安装成功):
codex --version
编辑配置文件
注意
- 在配置基本信息时,先检查是否存在
MIMO_API_KEY的环境变量,如果存在,请先清除或者将值替换为对应使用方式获取的 API Key。
配置文件路径如下:
-
macOS/Linux
-
config.toml:~/.codex/config.toml -
model-catalogs.json:~/.codex/model-catalogs.json
-
-
Windows
-
config.toml:用户目录\.codex\config.toml -
model-catalogs.json:用户目录\.codex\model-catalogs.json
-
以下为完整配置示例,model 字段可按需修改为其他支持的模型(如 mimo-v2.6-pro),其中 model_catalog_json 配置请根据所使用的系统配置文件路径,文件下载地址:model-catalogs.json。
按量付费
编辑或创建配置文件 config.toml
# 配置模型元数据
model_catalog_json = "~/.codex/model-catalogs.json"
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"
# 开启模型推理摘要,如果设置为false,即使设置了 model_reasoning_effort 也不会生效
model_supports_reasoning_summaries = true
model_reasoning_summary = "none"
model_context_window = 1048576
web_search = "disabled"
[model_providers.mimo]
name = "mimo"
base_url = "https://api.xiaomimimo.com/v1"
experimental_bearer_token = "sk-your-api-key-here"
wire_api = "responses"
Token Plan
编辑或创建配置文件 config.toml
# 配置模型元数据
model_catalog_json = "~/.codex/model-catalogs.json"
model = "mimo-v2.6-pro"
model_provider = "mimo"
model_reasoning_effort = "high"
# 开启模型推理摘要,如果设置为false,即使设置了 model_reasoning_effort 也不会生效
model_supports_reasoning_summaries = true
model_reasoning_summary = "none"
model_context_window = 1048576
web_search = "disabled"
[model_providers.mimo]
name = "mimo"
base_url = "https://token-plan-cn.xiaomimimo.com/v1"
experimental_bearer_token = "tp-your-api-key-here"
wire_api = "responses"
使用 Codex CLI
以上配置完成后,开启一个新终端,执行以下命令启动 Codex。
codex
配置模型源数据文件后,可在 Codex 中通过 /model 命令切换模型。
使用 Codex IDE 插件
Codex 配套提供 VS Code 插件,前往 VS Code 扩展市场搜索「Codex」即可完成安装。插件会自动复用本地已存在的 Codex 配置;若你从未使用过 Codex 命令行工具,请参照「编辑配置文件」章节规范完成配置。
使用 Codex 桌面端
Codex 桌面端会复用本地 Codex 中的配置,使用前请参照「编辑配置文件」章节完成配置。
常见问题
Codex 报错 “ custom tools require MiMo freeform Responses lite mode.”?
不支持在非 lite 模式下使用 custom 工具,如果遇到此报错,请按照「编辑配置文件」章节配置模型元数据文件 model-catalogs.json,并重启 Codex。