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

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

## 安装 Codex

从 [OpenAI Codex 页面](https://developers.openai.com/codex/) 下载并安装 Codex 桌面客户端。

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

---

## 配置 MiniMax API

### Step 1：编辑配置文件

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

> 将 `<MINIMAX_API_KEY>` 替换为你从 [MiniMax 开放平台](https://platform.minimaxi.com/user-center/payment/token-plan) 获取的 Key。

```toml
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：

1. 访问 [MiniMax 开放平台 - Token Plan](https://platform.minimaxi.com/user-center/payment/token-plan)
2. 注册并登录账户
3. 获取 Token Plan 或创建 API Key
4. 将 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 是否正确 |

摘要

标签多个标签用逗号分隔

分类