MiniMax M3.1-Flash Codex 手工接入与模型目录配置

一句话结论

官方 Codex 接入页的 Manual setup 使用 Responses API，把 MiniMax-M3.1-Flash 写入 ~/.codex/config.toml；可选模型目录把 low、medium、high、xhigh、max 暴露给 /model，并明确禁止 none。

适用场景

• 适合的任务：在 Codex 中使用 MiniMax M3.1-Flash 进行终端编程和多轮 Agent 工作。

• 不适合的任务：需要关闭思考，或需要把手工编辑误当作自动备份配置的场景。

• 适用的模型版本：MiniMax-M3.1-Flash。

• 适用的客户端、Agent 或 API：Codex CLI/桌面应用；MiniMax Responses API。

• 推荐的推理档位和参数：模型目录默认 max，可选 low、medium、high、xhigh、max；none 不支持。页面建议日常编码使用 524288（512K）上下文。

可直接使用的内容

~/.codex/config.toml

打开 ~/.codex/config.toml，将 <MINIMAX_API_KEY> 替换为 MiniMax key。以下是官方 Manual setup 配置：

model = "MiniMax-M3.1-Flash"
model_provider = "minimax"
model_context_window = 524288
preferred_auth_method = "apikey"
forced_login_method = "api"

[model_providers.minimax]
name = "MiniMax"
base_url = "https://api.minimax.io/v1"
experimental_bearer_token = "<MINIMAX_API_KEY>"
wire_api = "responses"

模型目录（可选）

在 ~/.codex/config.toml 的顶层加入以下字段，放在任何 [model_providers.*] 表之前：

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

创建 ~/.codex/model-catalogs/custom-catalog.json：

{
  "models": [
    {
      "slug": "MiniMax-M3.1-Flash",
      "display_name": "MiniMax-M3.1-Flash",
      "description": "MiniMax M3.1 Flash",
      "default_reasoning_level": "max",
      "supported_reasoning_levels": [
        { "effort": "low", "description": "Low" },
        { "effort": "medium", "description": "Medium" },
        { "effort": "high", "description": "High" },
        { "effort": "xhigh", "description": "Extra high" },
        { "effort": "max", "description": "Maximum" }
      ],
      "shell_type": "shell_command",
      "visibility": "list",
      "supported_in_api": true,
      "priority": 0,
      "base_instructions": "You are Codex, a coding agent based on MiniMax-M3.1-Flash. You and the user share the same workspace and collaborate to achieve the user's goals.",
      "supports_reasoning_summaries": true,
      "default_reasoning_summary": "none",
      "support_verbosity": false,
      "truncation_policy": { "mode": "tokens", "limit": 10000 },
      "supports_parallel_tool_calls": true,
      "experimental_supported_tools": [],
      "prefer_websockets": false,
      "apply_patch_tool_type": "freeform",
      "web_search_tool_type": "text",
      "supports_image_detail_original": false,
      "tool_mode": "code_mode_only",
      "multi_agent_version": "v2",
      "use_responses_lite": false,
      "input_modalities": ["text", "image"],
      "context_window": 524288,
      "max_context_window": 524288,
      "effective_context_window_percent": 95,
      "auto_compact_token_limit": null,
      "reasoning_summary_format": "experimental",
      "supports_search_tool": true
    }
  ]
}

不能加入的推理档位

不要把以下值加入 supported_reasoning_levels：

{ "effort": "none" }

官方说明 M3.1-Flash 始终思考；选择 none 会让 Codex 发送 reasoning: {"effort": "none"}，API 返回 400。

测试或工作流步骤

1. 安装或打开 Codex。页面建议 Codex CLI 0.146.0 或更新版本。

2. 编辑 ~/.codex/config.toml，加入上面的 provider 配置。

3. 如需在 /model 中显示模型和推理档位，再创建模型目录文件，并在 config.toml 设置 model_catalog_json。

4. 修改模型目录后重启 Codex。

5. 在 /model 中选择 MiniMax-M3.1-Flash 和可用的推理档位。

原始证据与数据

• API 模型 ID、目录 slug 和 display_name 均为 MiniMax-M3.1-Flash。

• provider 使用 base_url = "https://api.minimax.io/v1"、wire_api = "responses"，认证方式由 preferred_auth_method = "apikey" 与 forced_login_method = "api" 指定。

• 官方目录将默认推理档位设为 max，支持 low、medium、high、xhigh、max。

• 目录把上下文窗口设为 524288，有效上下文比例设为 95，并保留最高 1M 上下文的说明。页面引用 ProgramBench 的 200 个任务对比：512K 平均总 token 为 111.42M，1M 为 136.76M；估算使用费用约低 19.9%，模型表现相近。这是页面披露的官方对比，不是本文独立复测。

• 一键向导命令为 npx -y mmx-cli@latest agent setup；选择 Codex 时会配置 ~/.codex/config.toml 和 ~/.codex/mmx-model-catalog.json。

• 启动向导前应关闭 Codex 和任何打开 ~/.codex/config.toml 的编辑器，避免其他进程把旧内容保存回去覆盖新配置；配置完成后重启 Codex。

• 官方 MiniMax CLI 文档说明向导会在修改已有文件前创建带时间戳的 .bak，失败时恢复已修改文件，并保留其他提供商及无关设置。该备份说明针对向导，手工编辑页面没有承诺自动备份。

适用边界

• 这是 MiniMax M Plan 的 Codex 配置，不能据此推断其他客户端或其他 MiniMax 型号的字段。

• MiniMax-M3.1-Flash 的 1M 是模型能力上限；本文配置按官方建议使用 524288（512K），需要保留更多代码或文档上下文时再评估 1M。

• default_reasoning_summary 为 none 不等于关闭思考；supported_reasoning_levels 仍不能包含 none。

• 页面未注明作者、发布日期、限流、超时、价格或订阅区域限制；这些参数不能从本配置补写。

• 本文没有完整模型 prompt，因此归类为 configuration，不宣称存在可复制 prompt。

复现说明

2026-10-21 通过 Tabbit 任务 M31 prompt05 codex 打开官方页面，展开 Option 2: Manual setup，提取 config.toml、模型目录、推理档位、上下文窗口和重启说明；并查看页面链接的官方 MiniMax CLI 说明以核对向导备份行为。证据保存于 /tmp/m31-codex-evidence.txt。未在本机安装 Codex 或 MiniMax CLI，未运行向导，未修改 ~/.codex 或其他实际用户配置。