通过 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]):
# ~/.codex/config.toml
[model_providers.minimax]
name = "MiniMax"
base_url = "https://api.minimax.io/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "responses"
# ~/.codex/minimax.config.toml
model_provider = "minimax"
model = "MiniMax-M3"
model_context_window = 1000000
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 再决定要不要绝对路径的目录文件。