Codex App（codex桌面客户端）使用手册

Posted on Views:

1.Codex App 定位（核心认知）

Codex app 是一个多 Agent 编程指挥中心

核心能力：

  • 多智能体并行执行任务
  • 操作整个代码仓库（不仅仅是单文件）
  • 自动执行：写代码 + 修改 + 测试 +提交
  • 支持长期任务 & 自动化

👉 本质：
IDE + CLI + Agent Orchestrator 的融合体

cea505aae89bb289cfb79632f1131b30.png

2.安装与初始化

2.1 安装流程

下载codex app
1eba4ce832911b8ae747f0a32569a1bc.png

1
2
3
1. 下载 Codex App
2. 拖入 Applications（macOS）
3. 启动应用

2.2 登录

1
2
方式1：ChatGPT账号登录（推荐）
方式2：API Key（企业环境）

👉 Plus/Pro 可直接使用

2.3 初始化项目

新建项目
a580d7973504d83de991dfc5bc56ccfb.png

1
2
3
1. 打开 Codex App
2. 选择本地目录 / Git 仓库
3. 创建项目 Workspace

👉 App 会自动加载代码上下文(工作目录下的)

3.核心界面结构

a63624b42c9185ca7a1926b1247a7d89.png

3.1 模块说明

① Sidebar（左侧）

  • 项目列表
  • Agent线程（每个任务一个线程）

② 主工作区

  • Prompt 输入
  • Agent执行状态
  • 输出结果

③ Diff / Review区

  • 查看代码修改
  • 手动审批
  • 评论修改

👉 支持代码差分审查

④ Worktree（关键）分支模式开发

  • 每个 Agent 在独立副本运行
  • 不污染主代码

👉 避免多任务冲突

4.核心使用流程（标准操作）

4.1 第一个任务

1
2
3
4
5
6
7
8
9
输入：
“帮我写一个Gin服务”

流程：
1. Agent分析项目
2. 生成代码
3. 修改文件
4. 提供diff
5. 等待确认

4.2 修改已有项目

1
2
输入：
“优化这个项目的错误处理逻辑”

Codex 会：

  • 扫描 repo
  • 找相关文件
  • 修改多文件
  • 自动测试（如果有）

👉 支持跨文件修改

4.3 执行任务（Agent能力）

1
“运行测试并修复失败用例”

👉 Codex 会：

  • 执行 shell
  • 分析错误
  • 修改代码
  • 重跑测试

5.高级能力（重点）

5.1 多 Agent 并行（核心优势）

1
2
3
Agent1：开发API
Agent2：写测试
Agent3：优化性能

👉 同时运行，不冲突
👉 每个 Agent 有独立上下文

5.2 Skills（技能系统）

定义

1
Skill = Prompt + 工具 + 脚本

示例

  • CI分析Skill
  • Kubernetes部署Skill
  • 日志分析Skill

👉 Codex 可以自动调用 Skill ([note（ノート）][8])

5.3 Automations（自动化）

用法

1
2
3
设置定时任务：
- 每天分析CI失败
- 每周生成报告

👉 后台自动执行任务 ([手机新浪网][9])

5.4 Plan Mode（强烈推荐）

执行前先规划：
👉 避免误操作（生产必开）

6.与 CLI 的关系

工具 定位
Codex CLI 自动化 / 脚本
Codex App 可视化 + 多Agent
IDE插件 编辑器增强

👉 App = 控制中心

7.常见坑

多Agent冲突

  • 未使用 worktree 会污染代码