Linux 安装 Codex CLI 教程：Ubuntu、CentOS 配置到 API Key 全流程

相信AI是普通人的「外挂」。Linux环境很适合使用Codex CLI。终端操作、项目管理、脚本执行、代码审查这些场景，本身就和Codex CLI的使用方式比较契合。

本文整理Linux版Codex CLI的安装配置流程，覆盖Ubuntu、Debian、CentOS、Fedora、Arch等常见环境。

系统要求

• 主流Linux发行版（Ubuntu 20.04+、Debian 10+、CentOS 7+等）
• Node.js 22+
• npm 10+
• 网络连接

安装步骤

1. 安装 Node.js

Ubuntu/Debian：

sudo apt update
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL/Fedora：

# 使用 dnf，适用于 Fedora
sudo dnf install nodejs npm

# 或使用 yum，适用于 CentOS/RHEL
sudo yum install nodejs npm

Arch Linux：

sudo pacman -S nodejs npm

2. 安装 codex

打开终端，运行：

sudo npm install -g @openai/codex

3. 验证安装

codex --version

配置 API

1. 获取 Auth Token

1. 访问 AI编程助手 站点页面
2. 点击「接口密钥」页面
3. 点击「创建新密钥」
4. 密钥类型选择：codex（务必选择此分组，否则无法使用）
5. 令牌名称随意填写

2. 配置文件

重要提示：请将下方的 sk-xxx 替换为你在 LetAiCode 生成的实际 API 密钥！

1）创建目录和文件

mkdir -p ~/.codex
touch ~/.codex/auth.json
touch ~/.codex/config.toml

2）编辑 auth.json 文件

vi ~/.codex/auth.json

按 i 进入插入模式，粘贴以下内容，将 sk-xxx 替换为你的密钥：

{"OPENAI_API_KEY": "sk-xxx"}

注意：auth.json 文件里只保留上面这一行内容，其他全部删除，否则会报401。

按 ESC 键，输入 :wq 并回车保存退出。

3）编辑 config.toml 文件

vi ~/.codex/config.toml

按 i 进入插入模式，粘贴以下内容：

model_provider = "letaicode"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.letaicode]
name = "letaicode"
base_url = "https://letaicode.cn/codex"
wire_api = "responses"

其中，model = "gpt-5.5" 可指定具体模型。如需使用gpt-5.4，改为 model = "gpt-5.4" 即可。

注意：以上内容一定要放在config文件最上面，否则会报错。

启动 codex

重启终端，进入工程目录：

cd your-project-folder
codex

VSCode 插件 codex

以上配置完成后，在VSCode扩展商店中搜索并安装 codex 即可。

安装完成后会出现在侧边栏。找到并点击「Settings」，打开VSCode系IDE的 settings.json 文件。在 settings.json 文件末尾添加以下配置：

"chatgpt.apiBase":"https://letaicode.cn/codex",
"chatgpt.config":{
    "preferred_auth_method":"apikey"
}

这里的 apikey 字段无需更改，原封不动粘贴即可。

codex 桌面客户端

配置方法和codex cli一样，没生效可能需要手动更改配置文件路径：

设置 -> 配置 -> Custom config.toml settings 下面的 user config 换成你配置的路径。

常见问题

出现错误请按如下步骤排查：

1. 确认API Key创建是否正确：额度选择无限额度，不要限制模型，分组选择codex渠道。

更多codex配置及使用详情请参考 codex官方教程。

写在最后

Linux版Codex CLI配好以后，适合放进日常开发流程。比如：

• 分析项目结构
• 检查代码问题
• 写Shell脚本
• 辅助排查报错
• 生成测试用例
• 整理技术文档

如果是在服务器环境使用，建议先在测试目录验证，不要直接操作生产项目。

第一次使用可以按这个顺序：

1. 进入测试项目目录
2. 启动 codex
3. 让它先读取项目结构
4. 再让它分析问题
5. 最后再决定是否修改文件

这样会比直接让它自动改代码更稳。

配置成功后，VSCode插件和Codex桌面客户端也可以复用同一套配置。