终端命令行可升级为智能编程搭档，需配置node.js 22.x/npm 10.x、用git bash/wsl2、安装@openai/codex cli、手动创建~/.codex/auth.json和config.toml、设置语言选项，并通过auto-edit模式语义化修复bug。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让终端里那个黑底白字的命令行，变成能读懂你项目结构、自动修 Bug、还能写测试的编程搭档——不是靠猜，不是靠复制粘贴，而是靠一套可复现、可验证、改完就生效的配置流程。
确认环境与安装 CLI
先打开终端，执行node -v和npm -v，确保输出的是 Node.js 22.x 和 npm 10.x 版本。低于这个版本的环境，codex cli 启动时会直接报错“unsupported engine”，不提示具体原因，只卡在 loading 状态。
Windows 用户必须使用 Git Bash 或 WSL2 终端，CMD 和 PowerShell 均无法正确解析 codex 的信号中断逻辑，会导致 auto-edit 模式中途崩溃且无日志。
运行 npm install -g @openai/codex 安装 CLI 工具。安装完成后执行 codex --version，看到类似 v2.4.1 的输出即表示安装成功。
配置 API 凭据与基础参数
在用户主目录下手动创建 ~/.codex/ 文件夹（不要用 codex init 自动生成，它会忽略 Windows 路径斜杠转义问题）。
进入该目录，新建 auth.json，内容为：
{"api_key": "sk-..."} —— 注意：key 必须是双引号包裹的字符串，不能用单引号，也不能有多余空格或逗号，否则启动时静默失败，不报错也不提示。
再新建 config.toml，填入以下最小必要配置：
[model]
provider = "openai"
name = "codex-hybrid-2026"
这一步不能跳过。即使你只想试用本地模型，也必须显式声明 provider，否则 CLI 默认尝试连接已弃用的 legacy endpoint，返回 404 并冻结 3 秒后退出。
中文支持与 prompt 语言控制
方法一：全局启用中文输入
在 config.toml 的 [ui] 区块下添加：language = "zh-CN"。这会让所有交互式提示（如 confirm edit? / retry?）显示为中文，但不影响模型生成代码的语言选择。
方法二：单次命令强制中文理解
执行 codex suggest --prompt-lang zh "把 src/api/user.ts 里的 getUserById 函数改成支持缓存"。注意 【--prompt-lang zh 必须紧挨着 codex suggest，不能放在最后】，否则参数被忽略，CLI 仍按英文解析指令。
方法三：项目级语言锁定（推荐）
在项目根目录新建 .codex/config.toml，写入：[project]
default_prompt_language = "zh"。此配置优先级高于用户级 config.toml，且仅对当前目录及子目录生效，避免污染其他项目。
首次实战：用 auto-edit 模式修复一个真实 bug
第一步：准备一个含 bug 的文件。比如在当前目录新建 buggy.js，内容为：
function sum(arr) { return arr.reduce((a, b) => a + b, 0); }
console.log(sum([1, 2, null, 4])); // 输出 NaN，应过滤 null
第二步：运行修复命令：codex auto-edit --file buggy.js --instruction "修复 sum 函数，跳过数组中的 null 和 undefined 值"。
第三步：CLI 会弹出确认窗口，显示 diff 预览。此时按 y 确认，它将直接修改原文件；按 n 则放弃。注意：auto-edit 模式不会备份原文件，【务必确保已 git commit 当前状态】。
第四步：检查结果。打开 buggy.js，你会看到函数已被重写为：function sum(arr) { return arr.filter(v => v != null).reduce((a, b) => a + b, 0); } —— 这不是简单替换，而是理解了“跳过 null 和 undefined”的语义后生成的健壮实现。
