跳到主要内容
Agent 实践室CODEX STUDY CLUB
返回学习路线
查看全部 14 篇教程 当前第 2 章
基础入门第 2 章 / 共 14 章

Codex 桌面安装与首次验证

从当前官方桌面入口安装并登录,选择 Codex 和项目文件夹,用一个只读任务核验是否能正常工作。

内容核对

先找到当前官方入口

打开 OpenAI 官方桌面应用说明,使用页面上的下载入口。当前文档以 ChatGPT 桌面应用介绍安装流程,并在应用内提供 Codex 入口。旧教程中的产品名称、截图和按钮位置可能与当前版本不同。

  • macOS、Windows:从官方页面选择适合自己系统的下载方式,按安装程序提示完成。兼容性要求以下载页当时的说明为准。
  • Linux:从官方快速开始进入其 Linux 安装指南,按发行版查看支持情况和安装步骤。

如果操作系统提示来源或签名异常,先核对下载来源和安装包,不把跳过系统提示当作通用安装步骤。安装失败时记录系统、应用版本和原始错误,再寻找对应处理方法。

登录并选择 Codex

按官方快速开始完成下面几步:

  1. 启动桌面应用,使用自己的 ChatGPT 账号登录。
  2. 在产品选择菜单中选择 Codex。
  3. 创建项目或打开一个供练习使用的文件夹,确认当前任务指向该目录。
  4. 新建任务,写清你要的结果与允许的操作。

官方也列出 API Key 登录路径,但功能范围可能不同;第一次练习可先核对现有账号的访问能力。不要把订阅与 API 使用方式混为一谈,详见账号与套餐核对。

用一个只读任务检查是否准备好

把下面这段话发送给当前项目中的 Codex:

请读取这个项目的 README,列出项目用途和启动前提。
说明你读了哪个文件;如果没有 README,就说明未找到。
仅阅读,不修改文件,不安装依赖,不执行启动命令。

按三层核验:应用能打开、账号能进入任务、任务能读取选定文件并给出可核查结果。仅看到界面正常加载,还不足以确认任务执行能力。

这段练习是本站建议的验收方法,不是本次维护已替你执行的安装测试。没有 README 时,如实报告缺失同样是有效结果。

卡住时先区分失败阶段

现象 下一步
下载或安装失败 回到官方入口,核对系统兼容性、文件来源和安装错误
无法登录 核对账号和组织要求,记录登录页错误,使用官方帮助入口或联系管理员
已登录但看不到 Codex 或所需功能 查看官方套餐与功能范围,再检查版本和工作区设置
能发任务但读不到文件 确认选定目录、文件是否存在,以及应用显示的权限请求

不要把换账号、升级套餐或切换地区当作所有错误的统一解法。反馈时提供脱敏后的错误文本即可,无需公开密码、验证码或密钥。

下一步

先完成第一个任务。需要了解使用限制时再看账号、套餐与可用范围。

本文基于 CodexGuide 的 MIT 授权内容收录,原作者 canghe。