Codex App 使用

Codex App 是官方桌面客户端，提供可视化界面、并行任务、内置 Git 工具等功能。与 CLI、IDE 扩展共享配置，无需重复设置。

前提条件

使用前需先完成 CLI 配置：

• 已完成 购买套餐 并获取 API Key
• 已完成 环境配置（~/.codex/config.toml 和 ~/.codex/auth.json）

App 与 CLI/IDE 扩展共享以下配置，无需重复配置：

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

下载与安装

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

使用步骤

1. 选择项目

登录后，选择 Codex 工作的项目文件夹。有历史项目时会显示列表，可直接选择。

2. 选择 Local 模式

在项目界面中选择 Local 模式，让 Codex 在本地机器上运行。

3. 发送第一条消息

发送任务，例如：

• "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."

更多示例见官方 Explore 页面。

主要功能

• 并行多任务：同时运行多个任务，快速切换线程
• 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 官方教程整理。如官方更新导致界面、功能或流程变化，请以官方文档为准。