Skip to content

Codex App 使用

Codex App 是官方提供的桌面版命令中心,为 Codex 提供可视化界面、并行任务支持、内置 Git 工具等功能。App 与 CLI、IDE 扩展共享配置,无需重复配置即可使用。

前提条件

使用 Codex App 前,需要先完成 CLI 配置:

重要: App 与 CLI/IDE 扩展共享以下配置,无需重复配置:

  • Skills(自定义技能)
  • MCP(Model Context Protocol)
  • Config 文件(~/.codex/config.toml
  • 认证信息(~/.codex/auth.json

下载与安装

macOS 用户

Codex App 当前仅支持 macOS (Apple Silicon)

下载地址: https://chatgpt.com/codex

下载后按照提示安装即可。

Windows / Linux 用户

Codex App 暂不支持 Windows 和 Linux 平台。

如需获取支持通知,可访问官方表单注册:https://openai.com/form/codex-app/

使用步骤

1. 打开应用并登录

启动 Codex App,使用以下方式之一登录:

  • ChatGPT 账号(推荐):享受完整功能,包括云端线程
  • OpenAI API Key:部分功能可能受限(如云端线程不可用)

2. 选择项目

登录后,选择你想要 Codex 工作的项目文件夹。

如果之前使用过 Codex App、CLI 或 IDE 扩展,会显示历史项目列表,可直接选择。

3. 确保选择 Local 模式

在项目界面中,确保选择 Local 模式,让 Codex 在本地机器上工作。

4. 发送第一条消息

现在可以向 Codex 发送任务了!例如:

  • "Tell me about this project"(了解项目)
  • "Build a classic Snake game in this repo."(构建经典贪吃蛇游戏)
  • "Find and fix bugs in my codebase with minimal, high-confidence changes."(查找并修复代码库中的 bug)

更多示例见官方 Explore 页面

主要功能

Codex App 提供以下核心功能:

  • 并行多任务: 同时运行多个任务,快速切换不同线程
  • Git 集成: 查看 diff、内联评论、暂存/恢复变更、提交代码
  • Worktrees 支持: 使用 Git worktree 隔离不同线程的变更
  • Skills 支持: 与 CLI/IDE 扩展共享自定义技能
  • 自动化任务: 后台执行定期任务,结果推送到收件箱
  • 内置终端: 每个线程独立终端,运行测试或开发服务器
  • IDE 同步: 与 IDE 扩展共享 Auto Context 和活动线程
  • MCP 支持: 连接外部服务和工具

详细功能说明: 请查看 Codex App 官方文档

更多资源

时效说明

本文档基于 Codex App 官方教程整理。如官方更新导致界面、功能或流程变化,请以官方文档为准。