Debian/Ubuntu 上安装 Codex 并接入 MiniMax 模型实战指南

随着 AI 编程工具的发展，越来越多开发者开始使用 终端 AI Agent 来辅助开发。相比 IDE 插件，这类工具更轻量、更适合服务器环境。

OpenAI 开源的 Codex CLI 就是这样一个工具，它可以在终端中读取项目代码、生成补丁、修改文件甚至执行命令。

本文将一步一步演示如何在 Debian 系统上：

• 安装 Codex CLI
• 配置 MiniMax Coding 模型
• 在终端中使用 AI 编程助手

最终搭建一个完整的 AI Coding CLI 环境。

一、准备 Node.js 环境

Codex CLI 是一个 Node.js 工具，因此需要先安装 Node.js 和 npm。

在 Debian 中执行：

sudo apt update
sudo apt install -y nodejs npm

安装完成后检查版本：

node -v
npm -v

如果成功输出版本号，说明 Node.js 环境已经准备完成。

二、安装 Codex CLI

Codex CLI 可以通过 npm 直接安装。

推荐安装 0.57.0 版本：

npm install -g @openai/codex@0.57.0

说明：

• npm install：安装 npm 包
• -g：全局安装
• @openai/codex：OpenAI 发布的 Codex CLI
• @0.57.0：指定安装版本

之所以指定版本，是因为某些最新版本可能与部分第三方模型 API 兼容性不稳定。

安装完成后验证：

codex --version

如果成功输出版本号，说明安装成功。

三、创建 Codex 配置目录

Codex 默认从以下路径读取配置文件：

~/.codex/config.toml

如果目录不存在，可以手动创建：

mkdir -p ~/.codex
vim ~/.codex/config.toml

四、配置 MiniMax 模型

在 config.toml 中写入以下内容：

[model_providers.minimax]
name = "MiniMax Chat Completions API"
base_url = "https://api.minimax.io/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "chat"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

[profiles.m21]
model = "codex-MiniMax-M2.5"
model_provider = "minimax"

这段配置主要完成两件事：

1. 添加 MiniMax API 作为模型提供商
2. 创建一个名为 m21 的 profile，使用 codex-MiniMax-M2.5 模型

保存后退出编辑器。

五、配置 MiniMax API Key

在终端中设置环境变量：

export MINIMAX_API_KEY="你的API_KEY"

如果之前配置过 OpenAI 变量，建议先清理：

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

这样可以避免 API 调用冲突。

如果希望每次登录自动加载，可以写入：

~/.bashrc

六、启动 Codex

使用刚才创建的 profile 启动：

codex --profile m21

启动后即可进入 Codex CLI。

例如可以输入：

Explain this repository

或者：

Write a Python script to download a webpage

Codex 会读取当前目录代码，并生成修改建议或代码补丁。

七、Codex CLI 工作模式

Codex CLI 支持多种自动化程度：

例如启用自动编辑模式：

codex --auto-edit

这样 Codex 可以直接修改项目文件。

八、实际使用示例

进入一个项目目录：

cd my-project
codex --profile m21

输入指令：

Add a REST API using FastAPI

Codex 会自动：

1. 分析当前项目结构
2. 生成 FastAPI 代码
3. 输出 patch diff
4. 询问是否应用修改

整个过程类似一个 AI 编程助手 + 自动化开发 Agent。

九、推荐搭配工具

为了提升 CLI 开发效率，建议搭配以下工具：

这些工具可以显著提升 Codex 的使用体验。

十、总结

通过本文，我们完成了一个完整的 AI Coding CLI 环境搭建：

Debian
   + Node.js
   + Codex CLI
   + MiniMax M2.5
   + Terminal AI Agent

这种模式相比传统 IDE 插件，更适合：

• Linux 服务器开发
• DevOps 自动化
• 远程 SSH 编程
• AI Agent 工作流

随着 AI Agent 的发展，未来越来越多的开发工作会在 终端 + AI 的模式下完成。