这是一份从零开始的 Codex 中文说明书：功能、场景、安装、命令行、IDE、Git、浏览器、电脑操作、远程控制、自动化、插件与安全权限全部放在同一页。
Codex 不是只给你一段答案的聊天机器人，而是能够进入指定工作环境、读取上下文、执行操作、检查结果，再把成品交给你的工作型智能体。
它最擅长软件开发，但现在也能借助浏览器、电脑操作、文件预览、图片生成、技能和插件完成更多真实工作。新版桌面端已将 Chat、Work 和 Codex 合并到 ChatGPT 应用中：Codex 重点负责开发与技术执行，Work 更适合研究、文档、表格、演示和综合交付。
它们使用的是同一类 Codex 智能体，但工作方式不同。新手优先桌面应用，开发者常用 CLI 或 IDE，长任务可用云端。
Windows / macOS 图形界面。管理多个项目和任务、查看文件与 Diff、使用浏览器、电脑操作、插件、技能和定时任务。
最适合：大多数用户在终端里运行。直接进入项目目录，读取文件、编辑代码、执行命令，也能通过 codex exec 接入脚本和 CI。
最适合：命令行与服务器在 VS Code、Cursor、Windsurf、Xcode 或 JetBrains 中使用，能直接引用当前文件、选中的代码和编辑器上下文。
最适合：边写边改连接 GitHub，为仓库创建独立环境，让较长任务在云端继续运行，完成后审阅 Diff、继续追问或创建 PR。
最适合：后台长任务在 ChatGPT 手机或平板应用里连接 Windows / Mac 主机，开始任务、批准命令、查看终端、Diff、截图和测试结果。
最适合：离开电脑后继续控制每一项都写明了实际做法。不同功能可能受系统、账户方案、地区或灰度发布影响，页面中已把“通用能力”和“需要插件/权限的能力”分开说明。
扫描目录、依赖、配置、Git 历史和关键代码，解释项目架构、运行方式、数据流和风险点。
根据需求跨文件修改前端、后端、数据库、配置和测试，完成可运行的功能。
读取日志、复现问题、提出假设、执行诊断命令、定位根因，再做最小范围修复。
清理重复代码、拆分模块、升级框架/依赖、迁移数据库或语言，并尽量保持行为不变。
运行已有测试，补单元测试/集成测试，执行 lint、类型检查、构建和端到端验证。
查看变更、逐文件或逐代码块审阅，暂存、撤销、创建分支、整理提交信息和 PR 说明。
不同任务可以在独立线程和 Git worktree 中同时进行，避免互相覆盖；复杂任务还可拆给多个专业子智能体并行研究或实现。
执行电脑上已经安装的 Git、Node.js、Python、Docker、编译器、数据库客户端等工具。
在内置浏览器中打开本地网页，检查布局、点击交互、表单、移动端效果和控制台错误。
在支持的环境中通过独立光标看、点、输入和操作桌面应用，适合没有 API 的软件和重复界面流程。
生成界面素材、概念图、海报、插图和产品视觉，并和网页/应用开发放在同一工作流中迭代。
新版桌面应用中更推荐切到 Work 模式制作研究报告、Word、Excel、演示文稿、PDF 和数据可视化；Codex 可继续处理与项目相关的文件生成和自动化。
把固定步骤、规则、参考资料和辅助脚本封装成技能，让 Codex 每次都按同一流程完成任务。
连接 GitHub、Slack、Gmail、Google Drive、Jira 等工具，读取上下文或执行授权操作；也能接入自建 MCP 服务。
记住有用偏好；通过 AGENTS.md 固定项目规则，通过 config.toml 设置模型、权限、沙箱和工具行为。
桌面应用可创建计划任务；CLI 可用 codex exec 接入系统定时器、脚本、CI/CD 和流水线。
桌面应用可连接 SSH 主机上的项目，命令和文件读写在远程服务器执行，本机负责显示和控制。
用 TypeScript/Python SDK 控制本地 Codex 线程，或把 Codex 作为 MCP Server 接入自己的智能体、后台和内部工具。
下面不是抽象功能，而是可以直接交给 Codex 的完整任务。点击代码框右上角可复制指令。
规划、设计、编码、响应式适配、本地预览和部署说明一并完成。
在当前文件夹做一个中文产品介绍网站。必须适配手机和电脑，包含功能、教程、价格、FAQ。完成后启动本地服务，实际打开页面检查布局和按钮，再把部署步骤写清楚。
分析缓存、路由、异常处理和兼容性，修复后给出可直接部署文件。
检查当前 Worker 项目。先画出请求流程，找出缓存、UA 判断、订阅更新和错误回退中的风险。只在证据充分时修改，完成后运行语法检查，并输出可直接部署的最终文件。
根据日志和命令输出逐步定位，不凭感觉乱改。
根据我提供的日志排查服务故障。先列出最可能的三个原因和验证命令；每次根据新结果缩小范围。确认根因后给出最小修复、回滚方法和防复发措施。
重命名、分类、抽取、清洗、合并和生成统计结果。
读取当前目录中的 CSV 和 Excel，统一字段名、清理重复和空值，保留原文件不覆盖。输出清洗后的文件、异常记录表和一份关键指标摘要，并验证行数是否对得上。
先研究材料，再生成 Word/PDF/PPT；新版应用中建议使用 Work 模式。
根据当前资料制作一份给新手看的中文操作手册。结构必须是：用途、准备、逐步操作、常见错误、排查表、FAQ。不要省略命令和按钮路径，完成后检查目录和排版。
让 Codex 每次按相同标准检查并输出结果。
建立一个可重复执行的检查流程：拉取最新代码，运行测试和构建，审查高风险改动，生成 Markdown 报告。失败时保留日志，不执行发布。把流程做成脚本或定时任务。
新版 Codex 已经合并进 ChatGPT 桌面应用。你可以只装桌面应用，也可以同时安装 CLI 和 IDE 扩展；三者可以配合使用。
新版应用包含 Chat、Work 和 Codex。Windows 原生模式会在 PowerShell 中运行 Codex，也可以切换到 WSL2。
winget install --id 9PLM9XGG6VKS -s msstore
使用你有 Codex 权限的 ChatGPT 账号登录。已有旧 Codex 应用的用户正常更新即可迁移到新版。
进入 Codex，选择“打开文件夹/新建项目”，只授权你希望它处理的目录。
新手建议使用 Ask for approval / 工作区写入权限，不要一开始就开启 Full access。
适合在 PowerShell、服务器或脚本里使用。官方独立安装命令：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
也可以先安装 Node.js，再通过 npm 安装：
npm install -g @openai/codex
cd D:\你的项目目录
codex
首次运行选择 Sign in with ChatGPT。
codex --version
从官方 ChatGPT 下载页选择 macOS 版本，拖入“应用程序”，打开后登录并选择 Codex。
按系统提示允许访问你选择的项目文件夹。需要 Computer Use 时再单独授予辅助功能/屏幕相关权限。
选择 Codex → 打开文件夹。建议项目先使用 Git，以便查看和撤销改动。
计划用手机控制时，在 Settings → Connections 中启用 Remote，并设置接电时保持唤醒。
官方独立安装脚本适用于 macOS：
curl -fsSL https://chatgpt.com/codex/install.sh | sh也可以通过 Homebrew 或 npm：
brew install --cask codex # 或 npm install -g @openai/codex
cd ~/你的项目目录 codex
codex app
桌面应用已安装时会直接打开；未安装时会启动安装流程。
重新运行官方安装脚本，或执行 npm install -g @openai/codex@latest。
VS Code 及兼容编辑器安装官方 Codex 扩展；Xcode 和 JetBrains 使用各自集成。
点击侧边栏 Codex 图标；找不到时打开命令面板，运行 Codex: Open Codex Sidebar。
登录 ChatGPT，打开仓库；可把当前文件、选中代码或已有线程加入上下文。
任务前提交或建立 checkpoint，任务后审阅 Diff，避免大范围改错后难以恢复。
进入 Codex Web / Cloud，使用 ChatGPT 账号登录。
只授权需要处理的仓库，不要一次开放全部私有仓库。
配置依赖、工具、环境变量、Secrets 和 setup 脚本，使云端能复现项目。
任务可在云端继续运行；完成后检查摘要和 Diff，继续追问或创建 Pull Request。
官方 Remote 不是把整个电脑桌面缩到手机上，而是把手机变成 Codex 的“控制台”：可以启动任务、继续追问、批准命令、审阅 Diff 和测试结果。
文件、账号、插件、浏览器登录态和开发工具留在主机；手机只通过安全连接发送指令、审批和查看结果。支持 iOS、Android；iPad 使用同一 ChatGPT 应用，外接键盘时效率更高。
电脑安装最新版 ChatGPT 桌面应用；手机/iPad 安装最新版 ChatGPT；两端登录同一个账号和工作区；电脑保持开机、联网，桌面应用保持运行。
桌面应用侧边栏选择 Set up Remote，生成二维码。手机扫描二维码，确认相同账号并完成可能出现的 MFA、SSO 或 Passkey 验证。
打开 ChatGPT → Remote，选择已连接的 Mac/Windows 主机和项目。可以新建任务、发送追问、批准动作、查看文件变化、终端输出、测试与截图。
电脑 Settings → Connections 可开启接电时保持唤醒。笔记本合盖可能停止连接；Windows 使用 Computer Use 时通常需要会话保持解锁。
每台手机与每台主机都要分别配对。支持时也可从另一台 Mac/Windows 的“Control other devices”控制主机，或把项目连接到 SSH 开发机。
先更新手机和电脑应用；确认账号有 Codex 权限、两端工作区一致。团队账号可能需要管理员开启 Remote Control。Remote 不能从 CLI 或 IDE 扩展中完成首次设置。
这部分适合开发者和希望把 Codex 变成固定生产流程的人。普通用户只需理解用途，不必全部配置。
在当前项目里打开完整终端会话。
cd /path/to/project codex
适合分析、修改、运行命令和持续追问。
脚本、CI、定时任务只需要最终输出时使用。
codex exec "检查最近 10 个提交并生成发布说明" | tee release-notes.md
默认只读；需要写工作区时使用最小必要沙箱权限。
把 Codex 线程接入 Node.js 后台或内部工具，要求 Node.js 18+。
npm install @openai/codex-sdk
适合程序化开始、继续和恢复任务。
通过本地 app-server 控制 Codex，要求 Python 3.10+。
pip install openai-codex
可为不同轮次指定只读、工作区写入或完整访问沙箱。
让其他 MCP 客户端或 Agents SDK 调用 Codex 作为专业开发智能体。
codex mcp-server
适合更大的多智能体编排。
在 PR、发布或 CI 事件中自动运行 Codex 审查、生成补丁或质量门禁。
uses: openai/codex-action@v1
优先使用官方 Action，减少自己处理 CLI 凭据的风险。
把必须长期遵守的构建命令、代码风格、目录说明和禁止事项写进仓库。
# AGENTS.md - 修改后必须运行 npm test - 不得改动 migrations/old - 新接口必须补参数校验和错误处理
越短、越准确越有效；子目录可放更具体的 AGENTS.md。
用户级配置位于 ~/.codex/config.toml；项目级可放 .codex/config.toml。
# 示例：优先限制在工作区 sandbox_mode = "workspace-write"
可设置模型、审批、网络、MCP、规则和可信项目。
先写 SSH 别名并确认本机可登录。
Host devbox HostName devbox.example.com User you IdentityFile ~/.ssh/id_ed25519 ssh devbox
然后在桌面应用 Settings → Connections → SSH 添加主机。
本机图形界面可创建 Scheduled Task；服务器可用 cron 或 Windows 任务计划程序调用 codex exec。
# 示例：每天生成仓库健康报告 0 8 * * * cd /srv/app && codex exec "运行检查并生成 health.md"
自动化必须使用最小权限，并把失败日志保留下来。
这里只讲用量，不再比较其他功能。Codex 不是按“固定可用几小时”出售，而是按使用额度消耗；任务长度、模型、上下文、生成量和工具调用都会影响消耗速度。
作为比较基准，包含一定 Codex 使用额度。轻量修改、小项目和偶尔使用通常够用；高频长任务可能提前达到额度。
不能保证固定天数或小时数。同一类使用条件下，额度约为 Plus 的 5 倍。适合每天较频繁使用、多个项目并行或更长任务。
是“额度 5 倍”，不是“速度 5 倍”。同一类使用条件下，额度约为 Plus 的 20 倍。适合重度专业使用、持续长任务、多智能体和大量自动化。
仍受合理使用与独立模型限额影响。好指令的核心是：目标、材料、限制、权限和验收。不要只说“帮我看看”，要说明什么算完成。
适合网页、Worker、后台、API 和工具。
请在当前项目实现【功能名称】。 目标用户：【谁使用】 必须满足：【具体要求】 不能改动：【限制范围】 验收标准：【页面/接口/数据应该怎样】 请先读取项目和现有约定，制定简短计划后直接实现。完成后运行相关测试、类型检查和构建；实际打开能运行的页面或接口验证。最后列出修改文件、验证结果和仍需我确认的风险。
强调证据和最小修复，避免盲目改代码。
现象：【错误表现】 复现步骤：【如何出现】 期望结果：【正确表现】 已有日志：【粘贴或指出文件】 请先复现或通过日志建立证据，列出最可能原因和验证方法。确认根因后做最小范围修复，不要顺手重构无关代码。补充能防复发的测试，并运行所有相关检查。若无法验证某一环节，请明确说明原因。
适合刚拿到项目或准备上线前。
请全面审查当前项目，但先不要修改。 重点检查：安全、数据丢失、缓存、并发、错误处理、兼容性、依赖、部署和回滚。 只报告有证据的问题，按严重程度排序；每个问题给出文件位置、触发条件、影响和建议修复。最后给出一份“最先应该处理的 5 项”清单。
适合日报、测试、检查、发布准备。
把下面的重复流程做成可自动执行的任务：【流程】。 运行频率：【每天/每周/代码提交时】 允许权限：【只读/可写工作区/可访问网络】 失败处理：【停止、记录日志、不要发布】 输出：【Markdown 报告/邮件草稿/文件】 请优先使用最小权限，生成脚本和配置，先在本地试运行一次，并说明如何启用、暂停、查看日志和回滚。
在小屏幕上要让边界更明确。
在【主机/项目】上新建独立工作树处理这个任务： 【任务目标】 先只读取和分析，不执行高风险命令。需要安装软件、删除文件、修改系统配置、发布或访问项目外目录时必须等我批准。完成后把 Diff、测试结果和截图发给我审阅，不要自动合并。
Codex 越能执行真实操作，越要把权限边界设置清楚。最安全的原则不是完全不让它做事，而是只给完成当前任务所需的最小权限。
2026 年 7 月起，Codex 合并进入新版 ChatGPT 桌面应用，应用中同时提供 Chat、Work 和 Codex。已有 Codex 用户正常更新后，项目、任务和设置应继续保留；可以把 Codex 设为默认视图，macOS 还可选择 Codex 图标。
云端同步的内容通常跟账号走，但桌面本地线程、工作区、未提交文件、CLI 会话和本机配置可能只保存在电脑。重装前应备份项目、Git 改动以及用户目录中的 .codex 配置；不要把“登录同一账号”当成所有本地状态都会自动恢复。
Codex CLI 官方发布包含 macOS x86_64 版本，可在 Intel Mac 使用。桌面应用需以官方下载页当前提供的兼容安装包为准；若桌面版不兼容，CLI 与支持的 IDE 扩展仍是可靠方案。
官方 Remote 的首次配对需要 ChatGPT 桌面应用，不能从 CLI 或 IDE 扩展发起。配对后手机控制的是连接主机上的桌面任务和环境。纯 CLI 服务器可先通过 SSH 接到桌面应用，或使用安全的传统远程终端方案。
不能。不同 ChatGPT 方案有不同额度，Pro 5x 与 20x 表示相对 Plus 的使用额度，不是无限。任务越长、上下文越大、输出越多，消耗越快。
ChatGPT 套餐中的 Codex 使用与 OpenAI API 计费不是同一回事。使用 API Key、SDK、部分 CI/CD 或自建系统时，可能需要单独的 API 配置与费用。
适合，但应从桌面应用和清晰模板开始。你只需描述目标、材料、限制和验收；让 Codex 负责技术实现。涉及文档、表格、PPT 和综合研究时，新版应用中可切换到 Work 模式。
在指令中写明“信息不足但风险不高时可做合理假设并继续；只有涉及不可逆动作、权限、费用或会改变最终方向的关键选择时再问我”。高风险操作仍应保留确认。
Codex 更新很快，安装包、功能入口、额度和灰度范围应以官方实时页面为准。本页只链接 OpenAI 官方资料。