Codex 配置

按量付费的 MiMo API 和 Token Plan 均支持 Codex，可参考本文进行配置与使用。

前置工作

获取凭证

支持两种使用方式，但对应的凭证获取方式不同：

安装 Codex

前置要求： 需先安装 Node.js 18 或更新版本

安装命令：

npm install -g @openai/codex

验证安装（如有版本号输出，则表示安装成功）：

codex --version

编辑配置文件

配置文件路径如下：

• macOS/Linux：~/.codex/config.toml

• Windows：用户目录\.codex\config.toml

以下为完整配置示例，model 字段可按需修改为其他支持的模型（如 mimo-v2.5）。

按量付费

1. 编辑或创建配置文件 config.toml

model = "mimo-v2.5-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"
env_key = "MIMO_API_KEY"
wire_api = "responses"

2. 配置环境变量 MIMO_API_KEY

按量付费使用 sk- 开头的 API Key。

• macOS/Linux

  echo 'export MIMO_API_KEY="sk-your-api-key-here"' >> ~/.bashrc
  source ~/.bashrc
  

• Windows (CMD)

  # 在 CMD 中输入以下命令
  setx MIMO_API_KEY "sk-your-api-key-here"
  
  # 成功后，打开新的命令行窗口，运行以下命令，查看环境变量是否生效。
  echo %MIMO_API_KEY%
  

Token Plan

1. 编辑或创建配置文件 config.toml

model = "mimo-v2.5-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"
env_key = "MIMO_API_KEY"
wire_api = "responses"

2. 配置环境变量 MIMO_API_KEY

Token Plan 使用 tp- 开头的 API Key。

• macOS/Linux

  echo 'export MIMO_API_KEY="tp-your-api-key-here"' >> ~/.bashrc
  source ~/.bashrc
  

• Windows (CMD)

  # 在 CMD 中输入以下命令
  setx MIMO_API_KEY "tp-your-api-key-here"
  
  # 成功后，打开新的命令行窗口，运行以下命令，查看环境变量是否生效。
  echo %MIMO_API_KEY%
  

使用 Codex CLI

以上配置完成后，开启一个新终端，执行以下命令启动 Codex。

codex

使用 Codex IDE 插件

Codex 配套提供 VS Code 插件，前往 VS Code 扩展市场搜索「Codex」即可完成安装。插件会自动复用本地已存在的 Codex 配置；若你从未使用过 Codex 命令行工具，请参照「编辑配置文件」章节规范完成配置。

延伸阅读

自定义 MiMo 模型配置

Codex 支持自定义模型参数配置，可针对 MiMo 模型进行精细化个性化适配。配置完成后，在 Codex CLI 中输入 /model 即可在模型列表中看到 MiMo 模型及其对应的推理档位，并支持随时切换使用。

关键字段说明

配置步骤

1. 编辑或者创建 .codex/model-catalogs/model-catalogs.json 文件，用于 MiMo 模型的详细配置（以 mimo-v2.5-pro 和 mimo-v2.5 为例）

   {
     "models": [
       {
         "slug": "mimo-v2.5-pro",
         "display_name": "mimo-v2.5-pro",
         "description": "MiMo-v2.5-Pro: Trillion-parameter Flagship Agent Foundation",
         "default_reasoning_level": "high",
         "supported_reasoning_levels": [
           {
             "effort": "none",
             "description": "Disable Thinking"
           },
           {
             "effort": "high",
             "description": "Enabled Thinking"
           }
         ],
         "shell_type": "shell_command",
         "visibility": "list",
         "supported_in_api": true,
         "priority": 0,
         "base_instructions": "You are MiMo, an AI assistant developed by Xiaomi. Today's date: {date} {week}. Your knowledge cutoff date is December 2024.",
         "supports_reasoning_summaries": true,
         "default_reasoning_summary": "none",
         "support_verbosity": false,
         "truncation_policy": {
           "mode": "bytes",
           "limit": 10000
         },
         "supports_parallel_tool_calls": false,
         "supports_image_detail_original": false,
         "context_window": 1048576,
         "max_context_window": 1048576,
         "effective_context_window_percent": 95,
         "experimental_supported_tools": [],
         "input_modalities": ["text"],
         "supports_search_tool": false
       },
       {
         "slug": "mimo-v2.5",
         "display_name": "mimo-v2.5",
         "description": "MiMo-V2.5: Native Omni-modal Perception Model",
         "default_reasoning_level": "high",
         "supported_reasoning_levels": [
           {
             "effort": "none",
             "description": "Disable Thinking"
           },
           {
             "effort": "high",
             "description": "Enabled Thinking"
           }
         ],
         "shell_type": "shell_command",
         "visibility": "list",
         "supported_in_api": true,
         "priority": 1,
         "base_instructions": "You are MiMo, an AI assistant developed by Xiaomi. Today's date: {date} {week}. Your knowledge cutoff date is December 2024.",
         "supports_reasoning_summaries": true,
         "default_reasoning_summary": "none",
         "support_verbosity": false,
         "truncation_policy": {
           "mode": "bytes",
           "limit": 10000
         },
         "supports_parallel_tool_calls": false,
         "supports_image_detail_original": true,
         "context_window": 1048576,
         "max_context_window": 1048576,
         "effective_context_window_percent": 95,
         "experimental_supported_tools": [],
         "input_modalities": ["text", "image"],
         "supports_search_tool": false
       }
     ]
   }
   

2. 在 config.toml 文件的根级别中加上以下配置

• macOS/Linux

  model_catalog_json = "~/.codex/model-catalogs/model-catalogs.json"
  

• Windows

  model_catalog_json = "用户目录/.codex/model-catalogs/model-catalogs.json"