桌面端入门的第一步是安装 App、登录账号、选择项目,并确认 Codex 能安全地访问当前工作区。
下载、安装和登录 Codex App
桌面端教程不从 CLI 开始,而是从 App 开始。安装完成后,你应该先用一个低风险项目做练习。
安装前准备
- 准备一个可回滚的 Git 项目。
- 确认本机已经能正常运行项目测试或开发服务器。
- 不要用生产密钥、客户数据或不可回滚目录做第一轮练习。
下载入口
从 官方 Codex App 页面下载对应平台安装包。macOS 与 Windows 均提供桌面端。
登录方式
桌面端通常使用 ChatGPT 账号登录。部分场景也可能使用 API key 或组织级配置,具体取决于账号计划和企业策略。
建议:不要把 API key 写进仓库、AGENTS.md、截图或共享文档。企业场景优先使用组织级身份和审计策略。
第一次打开项目
- 打开 Codex App。
- 选择一个练习项目文件夹。
- 让 Codex 先只读分析项目结构。
- 确认它能说清楚技术栈、启动命令、测试命令和核心目录。
请先只读分析这个项目。输出技术栈、目录结构、启动方式、测试方式和核心模块。暂时不要修改任何文件。