codex cli日常开发需明确各环节命令用法：安装要求node.js≥18，认证推荐codex login；项目前需确认package.json、无.codexignore、已配git用户信息；命令模式适用于一次性任务，交互模式（tui）支持多轮上下文对话，exec模式用于ci/cd；修改文件默认生成diff供审核，误操作需手动git回退；可切换模型与provider，vs code插件需配置正确apibase。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让 Codex CLI 真正融入日常开发，而不是装完就闲置在终端里？你需要的不是“它能做什么”的罗列，而是明确知道：在哪个环节用什么命令、为什么这么用、不这么用会卡在哪一步。
安装与认证：先让命令行认出你
第一步不是敲 codex，而是确认 Node.js 版本是否达标。Codex CLI 要求 Node.js 18 或更高版本，低于此版本会导致后续所有命令静默失败——【node -v 输出必须 ≥ v18.0.0】。
执行 npm install -g @openai/codex 完成安装后，不要急着运行 codex --version。先检查 PATH 是否生效：关闭当前终端窗口，重新打开一个全新终端，再执行 codex --version。如果仍提示 command not found，说明 shell 没加载新路径，此时需手动执行 source ~/.zshrc（macOS）或 source ~/.bashrc（Linux）。
认证推荐使用 codex login 命令，它会自动弹出浏览器授权页，全程无需复制粘贴密钥。如果你已在 OpenAI 平台创建过 API Key，且希望跳过浏览器流程，可改用环境变量方式：export OPENAI_API_KEY="sk-xxx" → 然后写入 ~/.zshrc 并 source。
进入项目前的三步准备
进入任意代码目录前，请确保以下三项已就绪：
① 当前目录下存在有效的 package.json 或 git 初始化记录（Codex 依赖此识别项目边界）；
② 项目根目录中没有 .codexignore 文件（若存在，Codex 会跳过其中列出的路径，可能导致上下文缺失）；
③ 本地 Git 已配置 user.name 和 user.email（Codex 在自动生成 commit 时会调用 git config --global user.name，未设置将导致 apply 失败）。
命令模式 vs 交互模式：什么时候该敲回车，什么时候该等它说话
方法一：命令模式（适合一次性任务）
直接输入自然语言指令并回车，例如 codex "给 UserController 添加 JWT 验证中间件"。Codex 会解析意图→读取项目结构→生成修改计划→在沙箱中执行→输出 diff。这一步操作起来很简单，但【务必确认终端当前路径是项目根目录，否则它无法定位 UserController 文件】。
方法二：交互模式（推荐日常使用）
运行 codex 启动 TUI 界面，它会自动加载当前项目的代码树和最近 5 次 commit 的变更摘要。进入后你可以连续输入多轮指令，比如先问“这个项目用了哪些数据库驱动”，再接着说“把 MySQL 连接池大小从 5 改成 20”。TUI 会保留上下文，不需要重复说明项目背景。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
方法三：非交互式执行（适合 CI/CD 流水线）
使用 codex exec "npm test && npm run build"。它不会等待人工确认，直接运行命令并将 stdout/stderr 返回。注意：该模式下 Codex 不会修改任何文件，仅执行传入的 shell 命令。
安全沙箱与文件修改：它改了什么，你得一眼看清
当你运行 codex "修复 LoginService 中的密码明文日志" 类似指令时，Codex 默认会在隔离沙箱中执行修改。它不会直接覆盖原文件，而是生成一个临时 patch 并展示 diff —— 这是你审核修改内容的唯一机会。
看到 diff 后，按 y 确认应用，按 n 放弃，按 s 跳过当前文件。如果误按 y 且修改有误，【请立刻执行 git checkout -- src/services/LoginService.ts 回退，Codex 不提供反向 undo 命令】。
若想跳过 diff 审核、全自动执行（仅限可信场景），可在命令末尾加 --never-prompt 参数，例如 codex -a never "添加 Swagger 文档注解"。但强烈建议首次使用时不加此参数。
模型切换与配置微调：别被默认模型框住思路
默认模型是 gpt-5，但不同任务需要不同推理强度。比如生成复杂算法逻辑时，可显式指定高推理模式：codex -m gpt-5 --reasoning-effort high "实现 Dijkstra 最短路径算法并附单元测试"。
若你已在 ~/.codex/config.toml 中配置了多个 model_provider（如 acedatacloud 和 openai），可通过 --provider 参数快速切换：codex --provider acedatacloud "用中文注释所有 controller 方法"。
修改 config.toml 后无需重启终端，但必须确保文件语法为 TOML 格式，键名严格区分大小写——model_provider ≠ modelProvider，写错会导致整个配置失效且无报错提示。
VS Code 插件协同：把终端能力搬进编辑器
安装 Codex 官方 VS Code 插件后，在任意 .ts/.js 文件中右键选择 “Codex: Ask about this file”，插件会自动提取当前文件全文作为上下文发送给 CLI。
关键设置项藏在 Settings.json 中：必须添加 "chatgpt.apiBase": "https://api.acedata.cloud/v1"（注意不是官网地址），否则插件仍会尝试连接 OpenAI 官方服务并返回 401 错误。
启用插件后，编辑器侧边栏会出现 Codex 面板，点击“+ New Chat”即可开启对话。此时所有指令都默认绑定当前打开的文件路径，无需 cd 切目录，也无需手动 mention 文件名。
