桌面端入门的第一步是安装 App、登录账号、选择项目,并确认 Codex 能安全地访问当前工作区。

下载、安装和登录 Codex App

桌面端教程不从 CLI 开始,而是从 App 开始。安装完成后,你应该先用一个低风险项目做练习。

安装前准备

  • 准备一个可回滚的 Git 项目。
  • 确认本机已经能正常运行项目测试或开发服务器。
  • 不要用生产密钥、客户数据或不可回滚目录做第一轮练习。

下载入口

官方 Codex App 页面下载对应平台安装包。macOS 与 Windows 均提供桌面端。

登录方式

桌面端通常使用 ChatGPT 账号登录。部分场景也可能使用 API key 或组织级配置,具体取决于账号计划和企业策略。

建议:不要把 API key 写进仓库、AGENTS.md、截图或共享文档。企业场景优先使用组织级身份和审计策略。

第一次打开项目

  1. 打开 Codex App。
  2. 选择一个练习项目文件夹。
  3. 让 Codex 先只读分析项目结构。
  4. 确认它能说清楚技术栈、启动命令、测试命令和核心目录。
请先只读分析这个项目。输出技术栈、目录结构、启动方式、测试方式和核心模块。暂时不要修改任何文件。