---
title: "通过 MiniMax 连接模型服务"
summary: "用户层 [model_providers.minimax]，国际站 base_url 是 https://api.minimax.io/v1，wire_api = responses。env_key 读 MINIMAX_API_KEY，不要把密钥写进 experimental_bearer_token。"
category: config
level: intermediate
surfaces: [cli, app, ide]
tags: ["model_providers", "MiniMax", "wire_api", "profile"]
canonical: /tips/minimax-codex-gateway/
---

# 通过 MiniMax 连接模型服务

用户层 [model_providers.minimax]，国际站 base_url 是 https://api.minimax.io/v1，wire_api = responses。env_key 读 MINIMAX_API_KEY，不要把密钥写进 experimental_bearer_token。

MiniMax 官方 Codex 网关：profile 写 [model_providers.minimax]，base_url 是 https://api.minimax.io/v1，密钥用 env_key 不要 experimental_bearer_token。

这是换 Codex **使用的模型**，流量打到 MiniMax Responses 入口，不是添加 MCP 服务。官方 Codex 页给了 `[model_providers.minimax]` 和 `wire_api = "responses"`，但把密钥写进 `experimental_bearer_token`——那是把密钥写进 TOML。改成 `env_key`（变量**名**），在启动 Codex 的进程里 `export MINIMAX_API_KEY`。不要和 `experimental_bearer_token` / `requires_openai_auth` / `[model_providers.*.auth]` 叠在同一张供应商表。

国际站 `base_url` 是 `https://api.minimax.io/v1`。大陆 Token Plan 换成 `https://api.minimaxi.com/v1`，密钥从 platform.minimaxi.com 开，不要混站。**Codex 不会在 `base_url` 里展开环境变量**。不要写 `openai_base_url`，也不要抄 OpenAI SDK 页的 `OPENAI_BASE_URL`。

不要把顶层 `model_provider = "minimax"` 一上来写进用户 config，除非你就是要把**所有**会话都改走 MiniMax。官方手册和一键向导都会改成默认。更稳妥是独立 profile（0.134 起不要再写 `[profiles.minimax]`）：

```toml
# ~/.codex/config.toml
[model_providers.minimax]
name = "MiniMax"
base_url = "https://api.minimax.io/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "responses"
```

```toml
# ~/.codex/minimax.config.toml
model_provider = "minimax"
model = "MiniMax-M3"
model_context_window = 1000000
```

```bash
export MINIMAX_API_KEY=YOUR_MINIMAX_API_KEY
codex --profile minimax
codex --profile minimax -m MiniMax-M3
```

官方一键向导是 `npx -y mmx-cli@latest agent setup`。只要 Codex 时加 `--agent codex`，先 `--dry-run` 看会改 `~/.codex/config.toml` 和 `~/.codex/mmx-model-catalog.json`。不要 `--all`，那会改 Claude Code / OpenCode / Grok CLI。非交互还要 `--region global` 或 `cn`。向导会把 MiniMax 写成默认模型，并可能写 `experimental_bearer_token`；跑完改回 `env_key`。已有 `model_catalog_json` 时向导会停手，改走手写。

可选目录：`model_catalog_json` 必须是启动时能读到的**绝对路径**，不要写 `~`。本地 JSON **覆盖**内置目录，不是追加。官方示例里的 `base_instructions` 是人格段，不要整段抄进站点或仓库。需要 `/model` 列出 MiniMax-M3 时，只留 slug、reasoning 档（`none` 关思考、`high` 开 Adaptive Thinking）和 `shell_command`。Token Plan 密钥是 `sk-cp-`，按量是 `sk-api-`，配额不共用。

配置说明：

- 不要再写 `[profiles.minimax]` 或把密钥写进 `experimental_bearer_token`。
- 不要覆盖内置 ID `openai`、`ollama`、`lmstudio`。`minimax` 是新 ID，可以。
- 不要写进项目 `.codex/config.toml`。项目文件无法修改 `model_provider` / `model_providers`。
- 不要把这张表当成 MCP。

改完新开会话。`codex --profile minimax` 启动后，发送一条简短请求验证连接。401 先看国际站 / 大陆站是不是和密钥同一边；`/model` 仍显示 Custom 时，先 `codex debug models` 再决定要不要绝对路径的目录文件。

## 来源

- [MiniMax · Codex](https://platform.minimax.io/docs/token-plan/codex)
- [MiniMax · One-click setup wizard](https://platform.minimax.io/docs/token-plan/agent-setup)
- [MiniMax · Create Response](https://platform.minimax.io/docs/api-reference/responses-create)