手把手教程｜Linux 安装 Codex CLI，并接入 GPT-5.6

更新于2026 年 7 月 21 日Linux 安装 Codex CLI命令本身并不复杂真正容易出错的是 Node.js 版本、API 密钥类型和配置文件。按照下面的顺序操作即可完成 Codex CLI 安装并通过 AI编程助手 接入 GPT-5.6安装 Node.js → 安装 Codex CLI → 配置 API → 启动验证目前支持gpt-5.6-sol、gpt-5.6-terra和gpt-5.6-luna本教程默认使用gpt-5.6-sol。 一、环境要求安装前先确认 Linux 环境满足以下要求项目要求操作系统Ubuntu 20.04、Debian 10、CentOS 7 等主流发行版Node.js22npm10网络保持正常连接⚠️ Node.js 或 npm 版本过低可能导致 Codex CLI 安装或运行失败。⚙️ 二、安装 Node.js根据使用的 Linux 发行版选择对应命令。1. Ubuntu / Debiansudo apt update curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs2. Fedorasudo dnf install nodejs npm3. CentOS / RHELsudo yum install nodejs npm4. Arch Linuxsudo pacman -S nodejs npm安装完成后确认 Node.js 不低于 22、npm 不低于 10再继续下一步。 三、安装 Codex CLI打开终端运行sudo npm install -g openai/codex安装完成后检查版本codex --version正常返回版本号即表示 Codex CLI 安装成功。 四、创建 API 密钥进入 AI编程助手 站点依次完成打开「接口密钥」页面点击「创建新密钥」密钥类型选择codex填写令牌名称创建并复制 API 密钥。⚠️ 密钥必须选择codex分组并且不要限制模型否则可能无法正常使用。下文使用sk-xxx作为占位符配置时请替换为自己创建的真实 API 密钥。⚙️ 五、配置 APICodex 的配置文件保存在~/.codex 使用vi编辑文件按i开始编辑完成后按Esc输入:wq并回车保存。1. 创建配置文件运行mkdir -p ~/.codex touch ~/.codex/auth.json touch ~/.codex/config.toml需要配置两个文件文件用途auth.json保存 API 密钥config.toml配置模型和 API 地址2. 配置 auth.json打开文件vi ~/.codex/auth.json按i进入编辑模式写入{OPENAI_API_KEY:sk-xxx}将sk-xxx替换为自己创建的真实 API 密钥然后保存退出。⚠️auth.json只保留这一行不要添加其他内容否则可能出现401错误。3. 配置 config.toml打开文件vi ~/.codex/config.toml按i进入编辑模式写入model_provider letaicode model gpt-5.6-sol model_reasoning_effort high disable_response_storage true preferred_auth_method apikey [model_providers.letaicode] name letaicode base_url https://api.letaicode.cn/codex wire_api responses写入完成后保存退出。⚠️ 上述内容需要从config.toml文件顶部开始写入。如果文件中已有旧配置请先确认是否需要保留再进行替换。✅ 六、启动验证配置保存后关闭并重新打开终端。进入自己的项目目录cd your-project-folder将your-project-folder替换为实际项目路径然后运行codex正常进入 Codex CLI即表示安装和 API 配置已经生效。 七、配置总结Linux 安装 Codex CLI 的完整流程→ 检查环境 → 安装 Node.js → 安装 Codex CLI → 创建 codex 密钥 → 配置 auth.json → 配置 config.toml → 重新打开终端 → 运行 codex最后确认三项API 密钥选择codex分组auth.json只保留 API Keyconfig.toml从文件顶部开始写入。正常进入 Codex CLI即表示 Linux 版 Codex CLI 已完成安装并成功接入 GPT-5.6。