AI Agent / 系统课时

安装 Codex 桌面应用

安装 Codex 桌面应用

本课完成当前桌面端 Codex 的安装和首次本地项目接入。你会先确认操作系统与账号条件,再安装官方 ChatGPT 桌面应用、切换到 Codex,最后用一个最小测试目录验证文件读取权限,避免一开始就把整个主目录开放给代理。

学习目标

  • 识别当前 Codex 桌面端的正确安装入口和系统前置条件
  • 完成登录、切换到 Codex 与打开本地项目
  • 用最小目录验证本地文件访问,并处理常见权限或工作区限制

安装前先确认当前形态

截至 2026 年 9 月,Codex 已集成到新的 ChatGPT 桌面应用中,macOS 和 Windows 都可使用;如果你之前安装的是独立 Codex App,正常更新后会迁移到新的桌面应用。安装时应只使用 OpenAI 官方下载入口或系统官方应用商店,避免第三方安装包。

macOS 当前要求为 macOS 14,并支持 Apple Silicon M1 或更高版本以及 Intel 处理器。Windows 当前最低要求为 Windows 10 版本 17763.0 或更高,支持 x64 与 arm64。企业或教育工作区还可能由管理员单独关闭 Codex Local,此时即使应用安装成功也看不到或无法使用本地 Codex。

安装并完成首次启动

  1. 从 OpenAI 官方桌面应用下载入口获取与你操作系统匹配的安装包;Windows 也可使用官方 Microsoft Store 渠道。
  2. 完成系统安装后启动 ChatGPT 桌面应用,并使用有 Codex 权限的 ChatGPT 账号登录。
  3. 在应用左上角的全局切换入口选择 Codex,不要把普通 Chat 会话当成本地编码代理。
  4. 新建 Codex 会话或项目,选择打开本地文件夹。
  5. 系统出现文件访问或其他权限提示时,只授予当前任务需要的目录和能力。
  6. 如果是受管理工作区且 Codex 不可用,先确认账号所在工作区是否启用了 Codex Local。

ChatGPT 桌面应用中切换到 Codex 并打开本地文件夹

界面文字可能随着版本变化,但判断是否进入正确模式的关键是:当前视图明确是 Codex,并且可以选择本地文件夹、仓库、终端或开发工具,而不是只进行普通聊天。

准备一个最小测试项目

不要第一次就选择整个用户主目录。先创建一个只包含单个文件的测试目录,可以快速判断 Codex 是否拿到了正确的本地访问权限。下面命令要求本机已经安装 Python 3;Windows 如果命令名是 py,把开头的 python 改成 py 即可。

bash
python -c "from pathlib import Path; p=Path.home()/'codex-smoke-test'; p.mkdir(exist_ok=True); (p/'README.md').write_text('# Codex smoke test\n', encoding='utf-8'); print(p); print((p/'README.md').read_text(encoding='utf-8').strip())"

预期输出

text
<PATH>
# Codex smoke test

第一行是实际测试目录的绝对路径,因此会随操作系统和用户名变化。随后在 Codex 中只打开这个目录,并要求它“读取 README.md,返回标题,不修改任何文件”。如果返回 Codex smoke test 且目录内容未变化,基本可以确认读取路径与项目选择正确。

配置本地访问边界

本地 Codex 的权限应围绕项目根目录设置,而不是围绕“方便”设置。通常只需要让它读写当前仓库;访问父目录、SSH 配置、云凭据、浏览器数据或其他项目都应有明确任务理由。

当 Codex 请求执行超出当前沙箱或权限范围的动作,例如额外目录写入、联网或高权限命令时,先阅读它准备执行的具体操作。对于安装依赖、访问私有仓库等合理需求,可以按任务临时批准;对用途不清楚的宽泛权限请求应取消并缩小任务范围。

验证安装和处理典型失败

安装完成后,用三个结果做验收:应用能够正常登录并进入 Codex;Codex 能读取测试目录中的 README.md;没有在未经你授权的情况下访问测试目录之外的路径。通过后再逐步换成真实仓库。

如果看不到 Codex,先更新到最新桌面应用,再检查当前账号与工作区的 Codex Local 权限。若本地文件夹无法打开,优先检查操作系统的文件访问授权和企业设备策略;若应用商店或下载入口受公司网络限制,应由管理员提供合规安装渠道,而不是改用第三方镜像。

完成最小目录验证后,再选择真实项目根目录开始工作。这样即使首次配置有误,影响范围也只落在专门的测试文件夹内,同时你已经建立了之后每个项目都可复用的“最小授权后再扩展”习惯。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Codex 桌面应用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通