在 Codex 中使用 MiniMax-M3：config.toml 配置教程

安装 Codex

从 OpenAI Codex 页面下载并安装 Codex 桌面客户端。

支持 macOS、Windows、Linux，下载后按向导完成安装即可。

配置 MiniMax API

Step 1：编辑配置文件

打开 Codex 的配置文件 ~/.codex/config.toml，加入以下内容：

将 <MINIMAX_API_KEY> 替换为你从 MiniMax 开放平台获取的 Key。

model = "MiniMax-M3"
model_provider = "minimax"
model_context_window = 512000

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

配置说明：

配置项	说明
`model`	指定使用的模型为 MiniMax-M3
`model_provider`	指定 Provider 为 minimax
`model_context_window`	上下文窗口 512K tokens（Codex 支持的上限）
`base_url`	MiniMax 国内接口地址
`experimental_bearer_token`	填入你的 MiniMax API Key
`wire_api = "responses"`	使用 OpenAI Responses API 协议

Step 2：重启 Codex 并开始使用

保存配置文件后，重启 Codex 桌面客户端，即可开始使用 MiniMax-M3。

MiniMax API Key 获取

如果还没有 MiniMax API Key：

访问 MiniMax 开放平台 - Token Plan
注册并登录账户
获取 Token Plan 或创建 API Key
将 Key 填入配置文件的 experimental_bearer_token 中

配置文件路径参考

系统	配置文件路径
macOS	`~/.codex/config.toml`
Linux	`~/.codex/config.toml`
Windows	`C:\Users\<用户名>\.codex\config.toml`

常见问题

Q1：配置文件不存在

Codex 首次运行后会自动创建配置目录。如果 ~/.codex/ 不存在，先启动一次 Codex，再关闭，目录会自动生成。

Q2：重启后仍是默认模型

确认 config.toml 中 model 值已改为 MiniMax-M3（注意大小写），保存后完全退出 Codex 再重新启动。

Q3：API Key 无效

检查 experimental_bearer_token 是否正确填入（不要保留 < > 符号）。

Q4：上下文窗口为什么是 512K？

Codex 桌面客户端对 model_context_window 有上限限制，目前支持的最大值为 512K tokens。如果需要更大的上下文，可考虑其他支持 1M 的工具（如 Hermes Agent）。

常用命令速查

操作	说明
启动 Codex	点击桌面图标或应用列表中的 Codex
切换模型	编辑 `config.toml` 中的 `model` 值后重启
查看当前模型	Codex 设置面板或配置文件 `model` 字段
排查问题	检查 `config.toml` 语法和 Key 是否正确

📄 文档管理系统