Appearance
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 官方文档
更多资源
- 官方文档: https://developers.openai.com/codex/app
- 功能特性: https://developers.openai.com/codex/app/features
- 排障指南: https://developers.openai.com/codex/app/troubleshooting
时效说明
本文档基于 Codex App 官方教程整理。如官方更新导致界面、功能或流程变化,请以官方文档为准。