必须降级codex至0.80.0并配置minimax专属参数:base_url为https://api.minimaxi.com/v1,wire_api设为"chat",通过环境变量minimax_api_key传密钥,否则将401报错或fallback至openai。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让 Codex CLI 工具调用 MiniMax 国产大模型跑代码、写文档、做推理,而不是默认连接 OpenAI 的昂贵接口,必须手动配置 API 地址、协议类型和认证方式——这一步漏掉任意字段,Codex 就会报错 401 或直接 fallback 到官方服务。
确认 Codex 版本与 wire_api 匹配
打开终端,执行 codex --version 查看当前版本号。【0.80.0 及以下必须用 wire_api = "chat";0.81.0 及以上必须用 wire_api = "responses"】。MiniMax 官方明确建议使用 0.57.0 或 0.80.0 版本,新版 Codex 若强行对接 MiniMax 且未降级,会因协议不兼容直接返回空响应。
若版本 ≥0.81.0,执行 npm install -g @openai/codex@0.80.0 降级安装;若已是 0.80.0,则跳过此步。
版本确认后,创建配置目录:mkdir -p ~/.codex && touch ~/.codex/config.toml。
编辑 config.toml 配置 MiniMax 接口
用任意文本编辑器打开 ~/.codex/config.toml,填入以下内容(Windows 用户路径为 %USERPROFILE%\.codex\config.toml):
model = "MiniMax-M2.7"
model_provider = "minimax"
[model_providers.minimax]
name = "MiniMax"
base_url = "https://api.minimaxi.com/v1"
wire_api = "chat"
env_key = "MINIMAX_API_KEY"
MiniMax 3.0.18 是一款高效、轻量级的系统优化与多媒体增强工具。该版本在核心性能上进一步升级,提供更稳定的运行环境与更低的资源占用。主要功能包括智能内存管理、启动项优化、网络加速及高清音视频解码增强,显著提升设备响应速度与影音体验。新版修复了已知兼容性问题,并优化了界面交互逻辑,适用于日常办公与娱乐场景。MiniMax 3.0.18 秉承简洁实用的设计理念,帮助用户轻松维护系统健康,提升整体使用效率。
注意:base_url 末尾必须带 /v1,缺斜杠会导致 404 错误;wire_api 值必须与你刚确认的 Codex 版本严格对应;env_key 是环境变量名,不是密钥本身。
设置环境变量 MINIMAX_API_KEY
方法一(推荐,安全):在终端中临时设置(仅当前会话生效)
export MINIMAX_API_KEY="sk-xxx-your-minimax-key"(macOS/Linux)
$env:MINIMAX_API_KEY="sk-xxx-your-minimax-key"(PowerShell)
方法二:永久写入 shell 配置文件(如 ~/.zshrc 或 ~/.bash_profile),然后执行 source ~/.zshrc。
方法三:Windows 系统 → 设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 新建用户变量,变量名填 MINIMAX_API_KEY,值填你的 Key。
不要把 Key 直接写进 config.toml 文件里——这是硬编码风险,一旦提交 Git 就泄露密钥。
验证配置是否生效
第一步:在任意项目目录下运行 codex --help,无报错即基础加载成功。
第二步:执行 codex chat "你是谁?",等待响应。
① 若返回 MiniMax-M2.7 相关身份声明,说明路由、认证、协议全部打通;
② 若提示 Error: unauthorized,检查环境变量名是否拼错、Key 是否复制完整、base_url 是否多写了端口号;
③ 若卡住超时或返回空内容,重点核查 wire_api 是否与 Codex 版本匹配,以及 MiniMax 账户是否已开通 Coding Plan 订阅服务。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










