codex cli需先cd进入项目根目录再运行,否则无法识别技术栈;首次启动须检查沙盒模式、模型服务商及api地址配置;接着用结构提问验证理解;指令需精确到文件路径和函数名;/approve auto启用自动执行;最后通过diff预览确认修改并落地。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

刚装好Codex CLI,打开终端输入codex却卡在空白界面,或一上来就直接让写需求,结果改错文件、跑崩测试、连入口在哪都找不到——这不是工具问题,是跳过了最关键的初始化动作。
先进项目目录,再启动Codex
打开终端,用cd切换到你真正要开发的项目根目录,例如:cd ~/projects/my-nextjs-app。
【必须是完整项目根目录,不能是父文件夹或空文件夹】。Codex靠读package.json、pyproject.toml或go.mod等文件识别技术栈,路径不对就当普通文本目录处理,后续所有分析都会失准。
确认当前路径正确后,执行:codex。
首次启动后,立刻做这三件事
进入TUI界面后,别急着打字。先按Tab键切换到状态栏右侧的「⚙️ Settings」,回车进入配置检查页。
核对三项关键状态:
✅ sandbox_mode = "workspace-write"(允许修改当前项目文件)
✅ model_provider 显示为已配置的国内服务商(如acedatacloud或qnaigc)
✅ openai_base_url 不是默认的https://api.openai.com/v1
任一未生效,立即退出(Ctrl+C),编辑~/.codex/config.toml修正后再重进。
通读项目全貌,不改代码先问结构
在对话区直接粘贴并发送以下提示词:
先不要修改任何代码。
请用不超过200字告诉我:
1. 这个项目用什么语言和框架;
2. src/和lib/目录各负责什么;
3. 启动命令是什么;
4. 当前是否有未提交的Git变更。
这一步不是走流程。Codex会扫描git status、ls -R | head -50和关键配置文件,输出结果能立刻验证它是否真读懂了你的项目。如果回答含糊(如“可能是React”“应该有API”),说明沙盒权限或路径仍有问题,得退回上一步排查。
锁定问题范围,缩小到单个文件
假设你要修复登录页按钮点击无响应,不要说“修一下登录功能”。改成:
定位src/pages/login.tsx中handleSubmit函数,检查它是否被正确绑定到表单onSubmit事件。
这种指令带具体路径+函数名+上下文,Codex会自动打开该文件、高亮对应行、对比调用链。若你说“登录页有问题”,它可能去改auth.service.ts甚至删掉整个middleware/目录。
确认范围后,再输入:/approve auto——这会把审批策略从手动确认切为自动执行确定性操作(如语法修复、日志添加),但涉及delete、rm、数据库迁移的命令仍会暂停。
执行修改并核对Diff
现在发最终指令:“把src/pages/login.tsx第42行的onClick改为onSubmit,并确保表单event.preventDefault()被调用。”
Codex执行后,自动弹出Git Diff预览。重点看三处:
• 左侧显示原文件路径是否真实存在
• 中间-/+行是否严格对应你要求的修改点
• 右下角标注的「已写入磁盘」是否为绿色勾选
看到绿色勾选,按Enter确认落地;若某处标红警告“写入失败”,说明文件被IDE独占锁住,先关VS Code再重试。











