要终端驱动codex完成开发任务,需先执行codex命令启动tui并完成oauth登录;必须进入目标项目目录后再运行codex;常用/slash指令管理会话状态、目标与变更;支持带参启动、/exec临时指令及--model/--sandbox定制化调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想用终端直接驱动 Codex 完成代码分析、文件修改、测试运行等真实开发任务,而不是只靠桌面 App 点点点——你得先搞懂 codex 这条命令在终端里到底怎么敲、怎么交互、怎么控制它的行为边界。光输入 codex 回车就干等,大概率卡在登录页或权限拒绝,连项目目录都进不去。
启动并完成首次认证
打开终端,直接输入:
codex
终端会立即拉起全屏 TUI 界面,并自动弹出浏览器窗口跳转到 ChatGPT 登录页。【必须用与 Codex 绑定的 ChatGPT 账号登录】,不能用 OpenAI API Key 直接跳过这步——CLI 首次运行强制走 OAuth 流程。
登录成功后,浏览器会显示「Authentication successful」,终端同步返回欢迎信息并进入交互模式,底部出现 > 提示符。此时 Codex 已绑定当前用户身份,后续所有命令均复用该凭证。
进入指定项目目录再启动
不要先敲 codex 再到处 cd ——Codex 启动时默认以当前工作目录为 project root,且不会主动切换路径。
正确做法是:
cd /your/project/path → codex
这一步决定 Codex 能读哪些文件、改哪些文件、运行哪些命令。如果误在 home 目录下启动,它可能扫描整个用户文件夹,触发 sandbox 保护或权限拒绝。
用于在用户想通过浏览器自动化与 Google Gemini 或 ChatGPT 交互时。触发短语包括“ask Gemini”“ask ChatGPT”“ask GPT”“让...”。
常用控制指令(slash command)
/status
随时敲这条,立刻看到当前模型名、工作目录绝对路径、approval 模式、sandbox 范围、上下文 token 占用。这是每次开始新任务前必查项。
/goal 重构登录逻辑,支持邮箱+密码+验证码三重校验
设定本轮会话的明确目标,Codex 会据此过滤无关文件、抑制发散性建议。目标一旦设定,后续所有操作都围绕它展开,直到你手动 /goal clear。
/diff
执行完修改后立刻输入,Codex 会列出本次会话中所有被改动的文件及具体行变更。不输这句,你根本不知道它偷偷删了哪行 config。
/approval full-auto
⚠️仅限可信本地项目且已备份时使用。启用后 Codex 将跳过所有文件写入/命令执行确认,包括 rm -rf、git push、npm publish 等高危操作。
脱离 TUI 模式,执行单行任务
方法一:带参数启动
codex "解释 src/utils/date.ts 的时区处理逻辑" ——这句话执行完即退出,输出结果直接打印在终端,适合脚本调用或 CI 中嵌入。
方法二:TUI 中临时切出
在 > 提示符下输入 /exec 后接自然语言指令,例如:
/exec 添加一个 Jest 测试用例验证 loginForm 的空字段校验
执行完毕自动回到 TUI 输入状态,不中断当前会话上下文。
方法三:指定模型与沙箱
codex --model gpt-4o-mini --sandbox ./src -- "重写 useAuth hook,移除 localStorage 依赖"
--sandbox 参数必须是相对当前目录的路径,且不能跨出 project root,否则报错退出。










