目录

🚀 Codex CLI 命令大全：CLI指令与斜杠命令速查手册

📅 更新于 2026年5月 | ✍️ 原创文章，转载请注明出处

本系列共12篇，本文是第2篇

📌 目录

1. 命令行启动参数

🚀 基本启动

# 启动交互模式
codex

# 直接执行任务（非交互模式）
codex "创建一个 Hello World 的 Python 脚本"

# 指定目录启动
codex --dir /path/to/project

# 使用特定模型
codex --model gpt-5-codex

📋 完整参数列表

参数 缩写 说明 示例
--help -h 显示帮助信息 codex -h
--version -v 显示版本号 codex -v
--model -m 指定模型 codex -m gpt-4o
--dir -d 指定工作目录 codex -d ./myproject
--theme -t 设置主题 codex -t dark
--verbose 详细输出模式 codex --verbose
--quiet -q 静默模式 codex -q
--no-color 禁用颜色输出 codex --no-color
--approval-mode 设置审批模式 codex --approval-mode auto-edit
--sandbox 启用沙箱模式 codex --sandbox
--config -c 指定配置文件 codex -c custom.json

💡 常用启动示例

# 使用 GPT-4o 模型，自动批准编辑
codex -m gpt-4o --approval-mode auto-edit

# 在指定项目目录启动，详细输出
codex -d ~/projects/myapp --verbose

# 静默模式，适合脚本调用
codex -q "运行测试并生成报告"

# 指定配置文件
codex -c ~/.codex/work-config.json

2. 交互模式斜杠命令

进入 Codex 交互模式后，可以使用以下斜杠命令：

📖 帮助与信息

命令 说明 示例
/help 显示帮助信息 /help
/version 显示当前版本 /version
/usage 显示使用量统计 /usage
/status 显示当前状态 /status

🔧 会话管理

命令 说明 示例
/clear 清空当前对话 /clear
/reset 重置会话和上下文 /reset
/history 查看历史对话 /history
/save 保存当前对话 /save my-session
/load 加载历史对话 /load my-session
/export 导出对话为 Markdown /export session.md

⚙️ 配置与设置

命令 说明 示例
/model 切换模型 /model gpt-4o
/theme 切换主题 /theme light
/approval 设置审批模式 /approval suggest
/sandbox 切换沙箱模式 /sandbox on
/verbose 切换详细模式 /verbose
/config 打开配置文件 /config

📁 文件与项目

命令 说明 示例
/ls 列出当前目录文件 /ls
/cd 切换目录 /cd src
/pwd 显示当前目录 /pwd
/read 读取文件内容 /read src/main.py
/diff 显示文件差异 /diff
/revert 撤销文件修改 /revert src/main.py

🤖 AI 控制

命令 说明 示例
/approve 批准当前操作 /approve
/reject 拒绝当前操作 /reject
/retry 重试上一个请求 /retry
/stop 停止当前生成 /stop
/context 查看当前上下文 /context
/compact 压缩上下文 /compact

🔌 扩展与集成

命令 说明 示例
/mcp MCP 服务器管理 /mcp list
/skills 技能管理 /skills list
/plugins 插件管理 /plugins list
/hooks 钩子管理 /hooks list

💻 终端操作

命令 说明 示例
/run 执行终端命令 /run npm test
/shell 打开子 shell /shell
/git Git 操作 /git status

🎨 输出控制

命令 说明 示例
/copy 复制上次输出 /copy
/scroll-up 向上滚动 /scroll-up
/scroll-down 向下滚动 /scroll-down
/page-up 上一页 /page-up
/page-down 下一页 /page-down

❓ 其他

命令 说明 示例
/quit 退出 Codex /quit
/exit 退出 Codex /exit
/bug 报告 bug /bug
/feedback 提交反馈 /feedback
/docs 打开官方文档 /docs

3. 快捷键大全

⌨️ 通用快捷键

快捷键 说明
Ctrl + C 取消当前输入/停止生成
Ctrl + D 退出 Codex
Ctrl + L 清屏
Ctrl + Z 挂起进程（fg 恢复）
Ctrl + A 移动到行首
Ctrl + E 移动到行尾
Ctrl + K 删除到行尾
Ctrl + U 删除到行首
Ctrl + W 删除前一个单词
Ctrl + Y 粘贴（yank）

📝 输入编辑

快捷键 说明
Enter 发送消息
Shift + Enter 换行（不发送）
Alt + Enter 换行（不发送）
↑ 上一条历史命令
↓ 下一条历史命令
Tab 自动补全
Ctrl + R 搜索历史命令

📜 输出浏览

快捷键 说明
Ctrl + ↑ 向上滚动
Ctrl + ↓ 向下滚动
Page Up 上一页
Page Down 下一页
Home 跳到输出开头
End 跳到输出末尾
Ctrl + C 复制选中文本

🔧 模式切换

快捷键 说明
Esc 取消/返回
Ctrl + X 切换到扩展模式
Ctrl + S 保存当前状态
Ctrl + O 打开文件

4. 模式切换

🎛️ 审批模式（Approval Mode）

Codex 有三种审批模式，控制 AI 操作的确认程度：

1. Suggest 模式（默认）
codex --approval-mode suggest
  • 行为：AI 只提供建议，所有修改需要手动批准
  • 适用：初次使用、学习阶段、谨慎操作
你：帮我重构这个函数
AI：我建议做以下修改：
    - 将 calculateTotal() 拆分为 3 个子函数
    - 添加错误处理
    
    [Approve] [Reject] [Modify]
2. Auto-Edit 模式
codex --approval-mode auto-edit
  • 行为：AI 自动编辑文件，但执行命令前需要确认
  • 适用：信任 AI 的编辑能力，但想控制命令执行
你：帮我重构这个函数
AI：正在编辑 src/utils.py...
    ✏️ 已修改 3 个文件
    
    现在运行测试？ [Approve] [Reject]
3. Full-Auto 模式
codex --approval-mode full-auto
  • 行为：AI 自动执行所有操作（编辑文件 + 运行命令）
  • 适用：高度信任、快速迭代、熟悉项目
你：帮我重构这个函数
AI：正在编辑 src/utils.py...
    ✏️ 已修改 3 个文件
    🔄 运行测试...
    ✅ 所有测试通过
    📝 已创建 commit
💡 模式切换建议
场景 推荐模式
新手学习 Suggest
日常开发 Auto-Edit
快速迭代 Full-Auto
敏感项目 Suggest
CI/CD 集成 Full-Auto

🌐 主题模式

# 暗色主题
codex --theme dark

# 亮色主题
codex --theme light

# 跟随系统
codex --theme auto

🔒 沙箱模式

# 启用沙箱（限制文件系统访问）
codex --sandbox

# 禁用沙箱（默认）
codex --no-sandbox

沙箱限制：

  • 只能访问当前目录及子目录
  • 不能访问系统关键目录
  • 不能修改系统配置
  • 网络访问受限

5. 配置管理命令

📋 查看配置

# 查看所有配置
codex config list

# 查看单个配置项
codex config get model

# 查看配置文件位置
codex config path

⚙️ 设置配置

# 设置模型
codex config set model gpt-5-codex

# 设置主题
codex config set theme dark

# 设置审批模式
codex config set approval_mode auto-edit

# 设置最大 tokens
codex config set max_tokens 4096

# 设置温度
codex config set temperature 0.7

🗑️ 重置配置

# 重置单个配置项
codex config unset model

# 重置所有配置
codex config reset

# 编辑配置文件
codex config edit

📄 配置文件结构

{
  "model": "gpt-5-codex",
  "theme": "dark",
  "approval_mode": "suggest",
  "max_tokens": 4096,
  "temperature": 0.7,
  "verbose": false,
  "sandbox": false,
  "auto_compact": true,
  "history_size": 100,
  "proxy": null
}

📁 项目级配置

在项目根目录创建 .codex/config.json 可覆盖全局配置：

{
  "model": "gpt-4o",
  "approval_mode": "suggest",
  "sandbox": true
}

优先级：项目配置 > 全局配置 > 默认值

6. 实用命令组合

🔄 常用工作流

1. 代码审查工作流
# 启动 Codex
codex

# 在交互模式中
> /git diff
> 请审查这些修改，找出潜在问题
> /approve
> /git commit -m "refactor: optimize user service"
2. 测试驱动开发
# 启动 Codex，使用 Auto-Edit 模式
codex --approval-mode auto-edit

> 为 UserService 写单元测试，要求覆盖所有公开方法
> /run pytest tests/
> 修复失败的测试
> /run pytest tests/ -v
3. Bug 修复工作流
# 启动 Codex
codex

> 这里有个 bug：用户登录后 token 没有保存到 Redis
> /read src/auth/service.py
> /read src/auth/controller.py
> 请定位问题并修复
> /approve
> /run pytest tests/test_auth.py
4. 文档生成
# 非交互模式，直接生成
codex -q "为 src/ 目录下所有 Python 文件生成 API 文档，输出到 docs/"

# 或在交互模式
codex
> /ls src/
> 为所有 Controller 生成 Markdown 文档
> /export docs/api.md

🎯 快速操作

# 快速查看项目结构
codex "列出项目的主要目录结构和文件"

# 快速理解代码
codex "解释 src/main.py 的主要功能"

# 快速修复
codex "修复 src/utils.py 中的类型错误"

# 快速重构
codex "将 src/legacy/ 目录下的代码重构为新架构"

📊 批量操作

# 批量重命名
codex "将所有 .jsx 文件重命名为 .tsx"

# 批量修改
codex "将所有文件中的 var 替换为 const"

# 批量生成
codex "为每个 Controller 生成对应的 Service 和 Repository"

7. 命令行管道与重定向

🔀 管道操作

# 将输出传递给其他命令
codex "列出所有 TODO" | grep -i "fix"

# 从文件读取输入
cat requirements.txt | codex "根据需求文档生成代码"

# 与其他工具结合
codex "分析代码质量" | tee report.txt

📤 输出重定向

# 保存输出到文件
codex "生成 API 文档" > docs/api.md

# 追加到文件
codex "添加错误处理说明" >> docs/errors.md

# 同时显示和保存
codex "分析代码" | tee analysis.txt

📥 输入重定向

# 从文件读取任务
codex < tasks.txt

# 使用 Here Document
codex << EOF
请帮我：
1. 创建数据库迁移文件
2. 添加索引
3. 生成回滚脚本
EOF

🔗 脚本集成

#!/bin/bash
# 自动化脚本示例

# 获取代码分析
ANALYSIS=$(codex -q "分析 src/ 目录的代码质量，只输出评分")

# 检查结果
if [[ $ANALYSIS == *"评分: A"* ]]; then
    echo "代码质量优秀"
else
    echo "代码需要改进"
    codex "根据分析结果修复问题"
fi

🔄 CI/CD 集成

# GitHub Actions 示例
- name: Code Review with Codex
  run: |
    npm install -g @openai/codex
    codex -q "审查 PR #${{ github.event.pull_request.number }} 的代码" > review.md

8. 总结

🎯 核心命令速查表

类别 最常用命令
启动 codex, codex "任务", codex -m model
会话 /clear, /reset, /save, /load
配置 /model, /theme, /approval
文件 /read, /diff, /revert
控制 /approve, /reject, /stop
终端 /run, /git

💡 使用技巧

  1. 善用斜杠命令：比鼠标操作更快
  2. 记住快捷键：Ctrl+C（取消）、Ctrl+L（清屏）
  3. 选择合适模式：新手用 Suggest，老手用 Auto-Edit
  4. 利用管道：与其他 Unix 工具结合
  5. 项目配置：用 .codex/config.json 定制项目行为

📚 下一步

📝 系列文章导航

💡 遇到问题？ 欢迎在评论区留言，我会及时回复！

👍 觉得有用？ 点赞收藏，帮助更多开发者！

Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

cover

试了6款AI编程工具，我只留这2个

avatar AI Agent技术社区

为什么AI功能越发达，电商客服的差评反而越多？

但一个矛盾的现象正在越来越多的客服管理者之间蔓延：技术预算花了，机器人上线了，可客服团队的疲惫感没有减轻，大促期间的排队时长没有显著缩短，而用户投诉中关于“机器人答非所问”“转人工后要重复说三遍”的声音反而增加了。一线客服不再盯着几十个聊天窗口同时回复，而是监控AI Agent的运行状态，处理那些AI无法独立完成的边缘案例——情绪激动的投诉、涉及多方协调的纠纷、超出知识库范围的新品问题。人员流失率

avatar AI Agent技术社区
cover

你的AI Agent为什么越跑越慢？UCSD这个新系统把记忆瓶颈从82%压到了3%

avatar AI Agent技术社区