启动 Codex CLI

安装并配置好账号后,在项目目录下打开终端,输入 codex 即可启动交互式界面:

# 进入你的项目目录
cd ~/my-project

# 启动 Codex 交互界面
codex

# 带初始提示词直接启动
codex "帮我分析这个项目的结构"

# 启动时指定模型
codex --model gpt-5

三种审批模式(Approval Mode)

Codex CLI 提供三种不同级别的操作权限模式,你可以根据任务需求选择合适的模式:

模式 说明 适用场景
ask(默认) 只读模式:可以读取文件、制定方案,但执行任何操作前都需要你确认 陌生代码库探索、风险评估
auto-edit 自动编辑:可以读取和修改当前目录文件,但网络操作仍需确认 日常代码开发、重构任务
full-auto 完全自动:在禁用网络的沙箱中全自动运行,无需确认 批量任务、CI/CD 自动化
# 指定审批模式启动
codex --approval-mode ask        # 默认只读模式
codex --approval-mode auto-edit  # 自动编辑模式(缩写 -a auto-edit)
codex --approval-mode full-auto  # 完全自动模式

# 在交互界面中切换
/approvals  # 输入此命令切换审批模式

你的第一次对话

示例 1:分析项目结构

codex "分析这个项目的目录结构,告诉我主要文件的作用"
Codex 会自动读取文件,输出类似:
✓ 读取 package.json
✓ 扫描 src/ 目录(23 个文件)
📂 项目结构分析:
- src/index.ts:应用入口,初始化 Express 服务器
- src/routes/:API 路由定义(共 5 个端点)
...

示例 2:修复 Bug

codex "我的 login 函数有 bug,用户登录后 token 没有正确保存,帮我找出问题并修复"
Codex 会:
1. 读取相关文件
2. 分析代码逻辑
3. 提出修改方案
4. 等待你确认后执行修改

示例 3:生成新功能

codex "给我的 Express 应用添加一个用户注册接口,需要验证邮箱格式,密码至少8位,并把用户信息存入数据库"

传入图片上下文
codex -i design.png "按照这个设计图,实现对应的 React 组件"

图片输入

Codex CLI 支持将图片作为上下文输入,这在以下场景特别有用:

  • 分析报错截图
  • 根据 UI 设计图生成前端代码
  • 解读架构图并据此实现功能
方法一:命令行传入图片路径
codex -i screenshot.png "解释这个报错信息,并告诉我如何修复"
方法二:传入多张图片
codex --image img1.png,img2.jpg "对比这两个界面的区别,实现图一的设计"
方法三:在交互界面中粘贴图片(macOS)
复制图片后,在 Codex 输入框中直接按 Cmd+V 粘贴
方法四:Shift + 拖拽图片到终端窗口
Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐