codex提供交互式tui和非交互式exec两种模式:交互模式需在项目根目录运行codex,支持/init理解项目、/status查权限、/model切模型等斜杠命令;exec模式支持单行任务执行、指定模型与沙箱策略、图片辅助诊断,提示词须置于最后且不加引号。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

启动Codex交互式终端界面
想立刻进入可对话、能改代码、实时反馈的AI编程环境,直接在项目根目录下运行命令即可启动全屏TUI界面。
打开终端,cd到你的代码仓库根目录,执行:
codex
这一步会自动加载当前目录结构、读取配置文件、初始化沙箱权限,并进入带对话区/输入框/状态栏的交互界面。首次运行时若未配置认证,会弹出OAuth登录页或提示输入API Key。
【必须确保当前目录是你要操作的项目根目录,否则Codex无法感知代码上下文】
非交互模式:一句话执行具体任务
适合自动化脚本、CI流水线、快速验证,不进UI、不维持会话、执行完立即返回终端。
方法一:用codex exec + 提示词
codex exec "修复src/utils/date.ts中formatISODate函数对null输入的崩溃"
方法二:指定模型和沙箱策略
codex exec --model gpt-5 --sandbox workspace-write "给package.json添加eslint-config-prettier依赖"
方法三:带图片辅助理解(如截图报错)
codex exec -i ./error.png "解释这个TypeScript编译错误并给出修复方案"
注意:exec模式下所有选项必须写在提示词之前,提示词放在最后且不可加引号包裹(除非含空格)。
常用斜杠命令与即时操作
进入交互模式后,所有操作都通过斜杠命令或自然语言发起,不能再加codex前缀。
第一步:让Codex全面理解项目
/init
第二步:查看当前会话状态与权限范围
/status
第三步:临时切换模型(不影响全局配置)
/model gpt-5.5
第四步:强制刷新当前目录文件列表(例如你刚git pull了新代码)
/refresh
/init是唯一能自动生成AGENTS.md的命令,它会扫描package.json、pyproject.toml、.gitignore等17类元文件,推断技术栈、风格约束和架构惯例——跳过这步,Codex后续所有修改都缺乏项目语境支撑。
关键安全控制与沙箱策略
Codex默认启用workspace-write沙箱,只允许修改当前工作目录及子目录下的文件,这是兼顾效率与安全的平衡点。
查看当前沙箱等级:
/sandbox
升级为danger-full-access(允许执行任意系统命令、读写家目录、访问网络):
/sandbox danger-full-access
【执行此操作后Codex将绕过所有文件系统隔离,可能删除~/.ssh或格式化磁盘,请仅在可信离线环境测试使用】
降级回只读模式:
/sandbox read-only
退出与持久化会话
交互模式下按Ctrl+C不会退出,只会中断当前AI响应;真正退出需输入:
/quit
会话历史默认保存在~/.codex/sessions/下,按日期+哈希命名;如需导出当前会话供团队复现:
/export ./session-backup.json
下次启动codex时,它会自动加载最近一次会话的记忆摘要,但不会恢复未完成的代码修改——所有文件变更只在你明确确认审批后才写入磁盘。










