网飞笔记

主题

Codex 安装与使用指南 ​

Codex 是 OpenAI 的编程助手：你用日常语言告诉它要做什么，它可以先阅读项目、解释代码，再在你同意后修改文件和运行检查。新手推荐直接下载桌面客户端，无需配置终端；偏好命令行的开发者也可选用 CLI 版本，本文两种方式都会讲到。

📌 写在前面 ​

  • Codex 有桌面客户端和 CLI 两种使用方式。 桌面客户端界面直观，新手无需配置终端即可上手；CLI 运行在终端中，适合偏好命令行的开发者。本文优先介绍桌面客户端。
  • 它只该在项目文件夹里工作。 比如你的网站、App 或小程序项目。不要在“桌面”或个人文件总目录里直接启动，以免它读到无关文件。
  • 默认不会随便动手。 Codex 有沙盒和审批机制，普通用法下修改文件、访问网络、执行命令都会先经过限制或询问，具体见后文。
  • 普通新手首次使用，选择 Sign in with ChatGPT 登录就可以，不需要先申请 API Key，也不要把任何密钥复制进项目文件。

🌐 网络推荐：Codex 需要连接 OpenAI 服务器完成安装、登录与每一次对话，国内网络直连经常安装失败或登录卡住，推荐使用 NetFlow —— CN2GIA 三网优化直连，节点稳定、速度快，安装、登录、日常使用都更顺畅。

👉 获取 NetFlow 订阅

🧰 开始前要准备什么 ​

需要准备说明
操作系统macOS、Linux 或 Windows 10/11（原生运行或 WSL2）
网络能稳定访问 OpenAI 服务器（见上方网络推荐）
ChatGPT 账号Plus、Pro、Business、Edu 或 Enterprise 计划均可直接使用；也可用 API Key 按量计费
一个代码项目文件夹建议项目已经能正常打开或运行；有 Git 更方便查看和撤销改动
终端（仅 CLI 需要）macOS 用"终端（Terminal）"，Windows 用 PowerShell，Linux 用系统终端

如果使用 CLI 方式，本文中的命令请整行复制到终端，再按 Enter 回车；不要手动逐字输入。

🚀 第一步：安装 Codex ​

方式一：桌面客户端（推荐，新手首选） ​

无需打开终端，直接下载安装即可：

安装完成后打开应用，用 ChatGPT 账号登录即可直接使用，无需额外配置。桌面客户端用户可跳过第二步，直接看第三步。

以下为 CLI 方式，适合偏好终端操作的开发者：

方式二：CLI 官方安装脚本 ​

macOS / Linux：

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows（PowerShell）：

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装完成后关闭终端、重新打开一个新窗口，再验证安装（见下文）。

方式三：已安装 Node.js 的用户，可用 npm 安装 ​

bash
npm install -g @openai/codex

方式四：macOS 用户也可用 Homebrew ​

bash
brew install --cask codex

验证 CLI 安装 ​

bash
codex --version

能看到版本号，就说明 CLI 安装成功。

⚠️ CLI 安装方式均来自官方渠道（chatgpt.com、npm 官方仓库、Homebrew）。不要把第三方网站提供的"加速版""破解版"或来源不明的脚本粘贴进终端。

🔐 第二步：登录 Codex（CLI 专属，桌面客户端用户可跳过） ​

桌面客户端用户直接在应用内用 ChatGPT 账号登录即可，无需以下步骤。

CLI 用户：

  1. 在终端输入：

    bash
    codex

  2. 第一次运行时，终端会提示你登录，并自动打开浏览器。

  3. 浏览器中选择 Sign in with ChatGPT，登录你的 ChatGPT 账号并完成授权，即可使用 Plus / Pro / Business / Edu / Enterprise 计划内的额度。

  4. 如果你想改用按量计费的 API Key，可在登录时选择用 API Key 登录，但需要额外在 OpenAI 平台开通计费，不建议新手首次使用就这样配置。

  5. 回到终端。登录成功后，Codex 会显示欢迎界面，等待你输入任务。

⚠️ 如果浏览器登录页迟迟无法打开或转圈超时，多数是网络无法稳定访问 OpenAI 服务器，先按上方「网络推荐」切换一个稳定节点再重试。

📂 第三步：让 Codex 进入你的项目文件夹（CLI） ​

💡 以下第三步至第七步均为 CLI 操作步骤。桌面客户端用户在应用内直接打开项目即可。

这一步很重要：先进入项目文件夹，再启动 Codex。

macOS / Linux：最简单的进入方法 ​

  1. 在 Finder（或文件管理器）里找到你的项目文件夹。
  2. 回到终端，输入 cd，后面留一个空格，先不要回车。
  3. 直接把项目文件夹拖进终端窗口，终端会自动补全文件夹路径。
  4. 按 Enter。
  5. 输入下面命令确认当前位置：
bash
pwd

终端显示的路径末尾应当是你的项目文件夹名称。

Windows：最简单的进入方法 ​

  1. 在资源管理器中打开项目所在文件夹。

  2. 点击窗口顶部的地址栏，复制完整路径。

  3. 回到 PowerShell，输入 cd（后接一个空格），粘贴路径并按 Enter。例如：

    powershell
    cd "C:\Users\你的用户名\Desktop\我的项目"

  4. 输入下面命令确认当前位置：

    powershell
    Get-Location

现在输入：

bash
codex

Codex 就只会以这个项目作为主要工作范围。

🔒 第四步：先了解沙盒与审批模式，用得更放心 ​

Codex 启动时会根据项目是否已经是 Git 仓库，自动选择一种默认模式：已用 Git 管理的项目默认是「Auto」（可读写工作区，联网和越权操作需要确认）；没有用 Git 管理的项目默认更严格的「只读」。新手不需要手动配置，了解下面两张表即可看懂 Codex 在做什么、什么时候会弹出确认。

沙盒模式（Codex 技术上能做什么）：

模式能力
read-only（只读）只能读取文件、回答问题，不能修改文件或联网
workspace-write（工作区可写，默认）可以在当前项目目录内读写文件；默认仍不能联网，除非单独开启
danger-full-access（完全权限）可读写任意目录、可联网，不建议新手使用

审批策略（什么时候需要你确认）：

策略行为
untrusted只自动执行明确安全的只读操作，其余都要你确认
on-request（默认，配合 workspace-write）项目内的读写自动进行，涉及项目外文件或联网时会询问
never从不询问，配合只读沙盒常用于自动化脚本，不建议交互式新手使用

如果只想让 Codex 分析、不做任何修改，可在会话中输入 /permissions 切换到只读模式；想查看当前工作范围，可输入 /status。

🧭 第五步：第一次怎么提问 ​

不要一上来就让它“大改整个项目”。先让它阅读并解释，确认你们对项目的理解一致。

可以直接复制这段话给 Codex：

text
请先阅读这个项目的 README、目录结构和 package.json，不要修改任何文件。
用中文告诉我：这个项目是做什么的、怎么本地启动、怎么检查改动是否正确。

看完回答后，再让它规划一个小改动：

text
我想修改首页的一段文字。请先告诉我需要改哪个文件、会改成什么，不要立刻修改。

确认计划没有问题，再发送：

text
可以，按刚才的方案修改。完成后运行项目已有的检查或构建命令，并把结果告诉我。

这种“先阅读 → 先计划 → 再修改 → 最后验证”的顺序，最适合新手，也最不容易改错范围。

📝 第六步：给项目建立长期说明（可选） ​

在 Codex 对话里输入：

text
/init

它会生成一个叫 AGENTS.md 的项目说明文件（作用和 Claude Code 的 CLAUDE.md 类似），用来记录项目结构、启动命令、测试命令和编码约定，让 Codex 以后每次都能更准确地理解项目。

生成后请：

  1. 打开 AGENTS.md 看一遍，删掉不准确的内容；
  2. 如果对团队成员也有用，就和普通代码一样审查、提交。

不要把密码、Token、账号或付费信息写进 AGENTS.md。

✅ 第七步：修改后你该看什么 ​

当 Codex 说“已完成”时，先不要急着相信。按下面顺序检查：

  1. 看它列出的改动文件，确认没有碰到 .env、账号密钥或你没授权的目录。

  2. 让它用一句话说明“每个文件为什么要改”。

  3. 在项目终端运行：

    bash
    git status
git diff

    git status 会列出改了哪些文件；git diff 会显示具体改动。若你的项目没有 Git，也可以在编辑器里查看文件的修改记录。

  4. 按它说明的命令启动或构建项目，亲自打开页面试一遍。

  5. 确认无误后再提交代码或发布。

⚠️ 如果它准备删除大量文件、执行你看不懂的命令、修改支付/部署/数据库配置，先选择拒绝或暂停，并要求它解释影响。你随时可以按 Ctrl + C 中断当前操作。

🛠️ 常用操作 ​

你想做什么怎么做
在当前项目开始聊天在项目文件夹中输入 codex
看帮助输入 codex --help
查看登录状态输入 codex login status
继续之前的会话输入 codex resume
查看当前工作范围和状态会话中输入 /status
切换只读 / 可写模式会话中输入 /permissions
切换模型会话中输入 /model
开始一个全新任务在 Codex 内输入 /new
停止当前操作按 Ctrl + C

🔁 常见问题（FAQ） ​

Q：国内网络能直接用吗？
A：Codex 需要联网访问 OpenAI 服务器，国内网络直连常常安装失败或登录卡住，建议使用稳定的海外网络节点，见文章开头的「网络推荐」。

Q：输入 codex --version 后提示找不到命令？
A：先完全关闭并重新打开终端，再试一次。官方安装器默认把命令放在 ~/.local/bin；若仍失败，先重新运行官方安装命令，不要到第三方网站下载可执行文件。

Q：我没有代码项目，也能使用吗？
A：可以聊天，但 Codex 最擅长在一个明确的项目文件夹中工作。建议先打开已有的网站、App 或 GitHub 项目，再从那个文件夹启动它。

Q：它会不会未经同意删我的文件、联网发送数据？
A：默认的 workspace-write 沙盒只能改动当前项目目录，且默认不联网；越权操作会先询问你（on-request 审批策略）。新手应保持默认设置，重要项目先做好 Git 提交或备份。

Q：浏览器登录后，终端还是没有反应？
A：回到原来的终端窗口等待几秒；如果没有完成，按 Ctrl + C 退出后重新运行 codex login，确认网络稳定后再走一次登录流程。

Q：Windows 上可以用吗？
A：可以原生运行，也可以在 WSL2 中运行；用 VS Code 插件时，可在设置里开启 chatgpt.runCodexInWindowsSubsystemForLinux 让插件始终通过 WSL2 执行。

Q：以后怎么继续用？
A：每次先进入项目文件夹，再输入 codex。要继续最近一次对话可使用 codex resume。

✅ 小结 ​

  1. 打开终端，用官方脚本（或 npm、Homebrew）安装 Codex，确保网络能稳定访问 OpenAI 服务器；
  2. 输入 codex，用 ChatGPT 账号完成登录；
  3. 进入项目文件夹后再启动，了解默认的沙盒与审批模式；
  4. 按“先阅读、先计划、再修改、最后验证”的顺序提问；
  5. 每次修改后查看 git diff，确认无误再提交或发布。

📚 官方参考 ​

内容仅供学习与技术交流使用，采用 CC BY-NC-SA 4.0 许可协议。

© 网飞笔记