转载自知乎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/7PS已支持最新的 gpt-5.5需要用的在配置文件那里修改即可下面的教程配置文件默认用 gpt-5.5。Codex CLI 安装与配置教程Linux 版本教程系统要求主流 Linux 发行版例如 Ubuntu 20.04、Debian 10、CentOS 7 等Node.js 22npm 10网络连接安装步骤安装 Node.jsUbuntu/Debiansudo apt updatecurl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -sudo apt-get install -y nodejsCentOS/RHEL/Fedora使用 dnf适用于 Fedorasudo dnf install nodejs npm或使用 yum适用于 CentOS/RHELsudo yum install nodejs npmArch Linuxsudo pacman -S nodejs npm2. 安装 codex打开终端 Terminal运行sudo npm install -g openai/codex3. 验证安装打开终端 Terminal运行codex --version配置 API获取 Auth Token访问AI编程助手 站点页面进行以下操作点击 接口密钥 页面点击 创建新密钥密钥类型选择codex务必选择此分组否则无法使用令牌名称随意配置文件重要提示请将下方的 sk-xxx 替换为您在 LetAiCode 生成的实际 API 密钥1、创建目录和文件mkdir -p ~/.codextouch ~/.codex/auth.jsontouch ~/.codex/config.toml2、编辑 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 truepreferred_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运行以下命令启动codexVSCode 插件 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 桌面客户端也可以复用同一套配置。