转载自知乎：https://zhuanlan.zhihu.com/p/2047061151566008470
与一
与一
相信AI是普通人的“外挂”，致力于分享AI
​关注
9 人赞同了该文章
Linux 环境很适合使用 Codex CLI。

终端操作、项目管理、脚本执行、代码审查这些场景，本身就和 Codex CLI 的使用方式比较契合。

不过 Linux 发行版较多，不同系统安装 Node.js 的方式也不完全一样。

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

OpenAI Codex CLI 配置教程
最后更新于 2026/6/7

PS：已支持最新的 gpt-5.5，需要用的，在配置文件那里修改即可，下面的教程配置文件默认用 gpt-5.5。

Codex CLI 安装与配置教程
Linux 版本教程
系统要求
主流 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
打开终端 Terminal，运行：

sudo npm install -g @openai/codex
3. 验证安装
打开终端 Terminal，运行：

codex --version
配置 API

1. 获取 Auth Token
   访问AI编程助手 站点页面进行以下操作：

点击 接口密钥 页面
点击 创建新密钥
密钥类型选择：codex（务必选择此分组，否则无法使用）
令牌名称随意

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 替换为您的密钥。

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

{“OPENAI_API_KEY”: “sk-xxx”}
注意：auth.json 文件里，只保留上面这一行内容，其他全部删除，否则会报 401。

3、编辑 config.toml 文件
vi ~/.codex/config.toml
按 i 进入插入模式，粘贴以下内容。

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

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 文件末尾，添加以下配置。

注意：这里的 apikey 字段无需更改，以下内容原封不动粘贴即可。

“chatgpt.apiBase”:“https://letaicode.cn/codex”,
“chatgpt.config”:{
“preferred_auth_method”:“apikey”
}
codex 桌面客户端
配置方法和上面的 codex cli 一样，没生效可能需要手动更改一下配置文件。

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

常见问题
出现错误请按照如下步骤排查：

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

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

写在最后
Linux 版 Codex CLI 配好以后，适合放进日常开发流程里使用。

比如：

分析项目结构
检查代码问题
写 Shell 脚本
辅助排查报错
生成测试用例
整理技术文档
如果是在服务器环境使用，建议先在测试目录验证，不要直接操作生产项目。

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

进入测试项目目录
启动 codex
让它先读取项目结构
再让它分析问题
最后再决定是否修改文件
这样会比直接让它自动改代码更稳。

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