主题
ChatGPT 桌面端（Codex）安装与权限设置
想在电脑上打开项目、让 AI 修改代码，建议先从桌面端开始；不必为了安装桌面应用先装 Node.js。本文的权限设置针对本地项目中的 Codex，不等同于 ChatGPT 网页端或 Codex 云端的权限。
核对日期：2026-09-23。产品入口和设置名称可能变化；遇到界面不一致时，以文末官方资料和应用内实际界面为准。
ChatGPT 是桌面应用名称。在应用内选择 Codex，可以在本地项目中读取文件、修改代码和运行命令；日常问答或文档工作则可以选择 ChatGPT 的 Chat / Work。需要纯终端操作时，再看 Codex CLI。
下载安装
打开 ChatGPT 桌面应用官方入门页，按你的操作系统选择安装包。不要从不明镜像下载。
Windows 11：也可通过 Microsoft Store 安装；习惯使用终端的用户可在 PowerShell 中执行以下官方提供的命令：
powershellwinget install --id 9PLM9XGG6VKS -s msstoremacOS：从官方入门页选择适合设备的版本下载安装。
Linux：桌面端目前为预览版；先查看官方 Linux 桌面应用指南确认发行版与安装方式，不要直接套用 Windows / macOS 步骤。
安装完成后打开 ChatGPT。Windows 默认运行原生 Codex Agent，使用 PowerShell 和 Windows 沙箱；只有项目明确依赖 Linux 环境时，才考虑在应用设置中切换为 WSL2，并按提示重启应用。Git 有助于检查与撤销项目改动；Node.js、Python 等开发工具按项目需要安装，不是安装桌面应用的前提。
选择登录方式
| 方式 | 操作 | 适合谁 | 注意 |
|---|---|---|---|
| ChatGPT 账号（建议新手先用） | 未登录界面选择 Continue to sign in，在浏览器中完成登录 | 已有 ChatGPT 账号，希望使用工作区与订阅权益 | 实际可用功能受账号与工作区权限限制 |
| OpenAI Platform API Key | 未登录界面选择 Sign in another way，输入从 OpenAI Platform 控制台创建的密钥，选择 Continue | 希望按 API 用量计费、主要使用本地 Codex 工作流 | 不消耗 ChatGPT 订阅额度；部分依赖 ChatGPT 工作区或云服务的功能可能不可用 |
不要混淆两种密钥：上表的 API Key 是 OpenAI Platform 密钥，不是 ChatGPT 账号密码，也不是任意第三方模型服务的密钥。Codex 云端需要 ChatGPT 账号登录；若要使用云端任务，不要仅凭 API Key 登录。登录后在个人资料菜单确认当前账号或 API Key 状态；切换方式时先退出当前登录，再选择另一种方式。切勿把密钥写进文档、项目代码或 Git 仓库。
第三方服务商的 API Key（进阶）
第三方服务商的密钥不能直接填入上面的 OpenAI API Key 登录框。需要切换第三方模型时，建议通过 CC Switch 安装与快速开始 的图形界面管理供应商，而不是让新手手动编辑 Codex 的认证文件或模型配置：
- 先在 ChatGPT 桌面端完成官方账号登录；安装 CC Switch 后，进入 Codex 页面，优先选择对应服务商的预设。
- 在 CC Switch 的供应商表单填写服务商提供的 API Key，核对请求地址与模型；如果没有预设，先查服务商和 CC Switch 供应商说明，不要盲目套用别人的配置片段或导入来源不明的供应商链接。
- 保存并启用供应商，完全退出后重新打开桌面应用，用小任务验证实际使用的模型与账单归属。若要切回官方账号，通过 CC Switch 的官方供应商入口切换，再核对应用内登录状态。
桌面端兼容提示：CC Switch 管理的第三方模型不一定会出现在 ChatGPT 桌面端的模型列表，即使 Codex CLI 可以使用。CC Switch v3.16.1 及以后提供 Settings > General > Codex App Enhancements > Keep official login when switching third-party providers 选项；部分服务商还需开启本地路由。启用前先阅读其桌面端模型可见性说明，仍不可用时不要手改凭据文件，先切回官方供应商。第三方工具会接触你填写的密钥，可能将密钥写入 Codex 的本地配置，并修改登录或供应商状态；只从项目官方渠道安装，并确认服务商的隐私与计费规则。
打开项目并开始对话
- 在 ChatGPT 中打开一个本地项目文件夹。先选一个有 Git 版本记录的小项目，避免首次使用时直接开放整个磁盘。
- 从产品选择器进入 Codex，新建对话；在输入框下方将权限设为 Ask for approval（请求批准）。
- 先试一个可检查的任务，例如：“阅读这个项目的 README 和目录结构，提出三条改进建议，先不要修改文件。”
- 需要实施时再明确要求修改；检查变更与命令输出，必要时运行项目测试。沙箱允许工作区内写入，不意味着每一次修改都会弹出确认框；重要文件先备份或使用 Git。
权限、沙箱与网络
权限由两层共同决定：沙箱限制文件和网络访问范围；批准方式决定越过范围时由谁审核。在输入框下方的权限菜单选择当前对话模式；在 Settings > General > Permissions 中只是启用可选模式，不会自动替当前对话切换权限。
| 模式 | 工作区内文件 | 越界 / 命令联网 | 推荐场景 |
|---|---|---|---|
| Ask for approval | 可读写工作区文件并运行常规本地命令 | 需要时请求用户批准 | 日常开发，推荐默认使用 |
| Approve for me（设置里称 Auto-review） | 与上面相同的工作区边界 | 将符合条件的请求交给自动审查，可能判断失误 | 熟悉风险后再按需启用 |
| Full access | 不受项目文件夹边界限制 | 可访问本机其他文件并运行联网命令，无需逐项批准 | 高风险，不建议作为日常默认 |
| 只读 / 自定义配置 | 按配置只读或限定路径 | 按所选配置处理 | 只想先分析、或有细粒度安全要求 |
本地写入：默认的 workspace-write 沙箱可以修改当前工作区，超出工作区时请求提升权限。不要为了跨目录偶尔写一个文件就长期打开 Full access；优先选择正确的项目目录、使用一次性批准，或用自定义权限配置精确增加可写范围。
网络访问：在默认工作区沙箱中，命令的出站网络访问默认关闭，需要时在对话中批准具体请求即可；不建议新手为了联网长期放宽整个工作区的权限。网页搜索、浏览器或插件各有自己的权限控制，不能用“命令禁止联网”推断它们也被一并禁用。如果业务确实需要持续开放命令联网或按域名限制，目前官方文档提供的是高级网络配置说明，而不是本文所述的桌面端开关；请由熟悉权限边界的人按需配置。也不要把“从不询问批准”误认为“每步都要我同意”；前者会取消批准弹窗，并不自动赋予沙箱外权限。
安装后建议检查
- 在 Settings 查看默认编辑器、通知与主题；Windows 可选集成终端（PowerShell / WSL 等），但“集成终端用哪个 shell”和“Agent 在 Windows 还是 WSL 中运行”是两项独立设置。
- 在 Settings > General 按需设置长任务防休眠、后续消息的处理方式；不熟悉权限时保持 Ask for approval。
- 在个人资料菜单核对登录方式；如使用 API Key，留意 OpenAI Platform 的费用与组织策略。受管理的工作区可能禁止某些权限模式或登录方式。
- 遇到“无法写入”先核对当前工作区和权限模式；遇到“无法联网”区分是命令、浏览器还是插件，再决定是否批准或调整对应设置。