问题根源在于api密钥写法、配置路径错误或auth.json与config.toml格式不规范；需确保node≥v22.0.0、npm≥10.0.0，auth.json为单行json且密钥属codex分组，config.toml正确指定gpt-5.6-sol等模型及letaicode提供方。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在本地终端直接调用 GPT-5.6 系列模型写代码、生成文档或调试逻辑，但装完 codex --version 有输出，一运行就报 401 错误、模型不生效、配置文件改了却没反应——问题大概率不出在安装环节，而是卡在 API 密钥写法、配置路径错误或两个核心文件的格式细节上。
确认系统环境与前置依赖
先打开终端（Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal），逐行执行：
node -v → 确保输出 ≥ v22.0.0；npm -v → 确保输出 ≥ 10.0.0。
Windows 用户必须额外安装 Git Bash：去 Git 官网 下载对应版本，安装时全程点「Next」，不要取消勾选「Add Git to PATH」选项。这一步漏掉，后续某些命令会提示“不是内部或外部命令”。
若 node/npm 版本不达标，请卸载旧版，从 Node.js 官网 下载并安装最新 LTS 版本（2026 年 7 月为 v22.14.0）。
安装 Codex CLI 工具
打开终端，直接运行：
npm install -g @openai/codex
国内用户若遇到下载卡在 fetching @openai/codex，换镜像源再试：
npm install -g @openai/codex --registry=https://registry.npmmirror.com
安装完成后立即验证：
codex --version → 正常输出类似 2.8.3 即成功。如果提示“command not found”，重启终端或检查 npm 全局 bin 路径是否已加入系统 PATH。
创建并配置 auth.json
这是最易出错的一步：文件名必须是 auth.json（不能叫 auth.txt 或带空格），内容必须严格为单行 JSON，无注释、无缩进、无多余逗号。
第一步：进入配置目录
Windows：打开文件资源管理器，地址栏粘贴 C:\Users\你的用户名\.codex → 若提示“找不到”，请先开启「显示隐藏的项目」，再手动新建名为 .codex 的文件夹。
macOS/Linux：终端执行 mkdir -p ~/.codex。
第二步：在该目录下新建文件 auth.json，用记事本（Windows）或 TextEdit（macOS，设为纯文本模式）或 vim（Linux）编辑，只写且仅写这一行：
{"OPENAI_API_KEY":"sk-xxx"}
【sk-xxx 必须替换成你从 LetAiCode 或其他支持 codex 分组的平台创建的真实密钥】。密钥类型必须选「codex」分组，选成「chat」或「api」会导致 401；复制时别把前后引号或空格一起带进去。
配置 config.toml 切换 GPT-5.6 模型
仍在 .codex 目录下，新建文件 config.toml，全部内容如下（覆盖任何已有内容）：
model_provider = "letaicode"<br>model = "gpt-5.6-sol"<br>model_reasoning_effort = "high"<br>disable_response_storage = true<br>preferred_auth_method = "apikey"<br><br>[model_providers.letaicode]<br>name = "letaicode"<br>base_url = "https://letaicode.cn/codex"<br>wire_api = "responses"<br>requires_openai_auth = false
如需切换模型，只需修改第二行：
→ model = "gpt-5.6-terra" 启用推理增强版
→ model = "gpt-5.6-luna" 启用低延迟对话版
改完保存，无需重启电脑，但必须关闭所有已打开的终端窗口再重新打开，否则旧配置仍被缓存。
启动并测试 Codex CLI
方法一：基础交互模式
终端进入任意项目文件夹，运行：codex → 回车后输入问题，例如 “写一个 Python 函数，计算斐波那契数列前 10 项”。
方法二：单次指令模式codex "生成一个 React 组件，包含按钮和点击计数状态" → 直接返回代码块，适合脚本集成。
首次运行时，CLI 会自动检测 .codex/auth.json 和 .codex/config.toml，读取成功则开始连接模型；若卡住或报错 401，请立刻检查 auth.json 是否有多余空格、引号是否为英文、密钥是否过期。
