保姆级教程：ChatGPT 官方 Codex 怎么用？ ✍ 一🕐 2026-04-30📦 11.5 KB 🟢 已读 𝕏 文章列表 鉴于 Claude Code 账号封禁风险高，本文推荐已拥有 ChatGPT 付费会员的用户尝试官方 Codex。文章详细介绍了 Codex 的适用人群、三种安装方式（CLI、桌面版、插件版），以及三种登录接入方法（官方登录、CC Switch、配置文件）。此外，还涵盖了 Node.js 环境配置、中转站设置、常见报错排查等实操细节。 CodexOpenAIChatGPTCLI教程中转站AI编程配置IDE插件 # 保姆级教程ChatGPT 官方 Codex 怎么用？ **作者**: 一 **日期**: 2026-04-30T04:18:44.000Z **来源**: [https://x.com/XChatScout/status/2049704985961869657](https://x.com/XChatScout/status/2049704985961869657) ---  最近很多人的Claude Code 官方账号容易被封，中转站也经常失效，还有没有别的 AI 编程工具可以顶上？ 还真有。 如果你本身就在用 ChatGPT Plus / Team / Pro，那现在其实可以直接试试 Codex。 它的好处很直接： > 官方入口更省心 > 支持 CLI / 桌面版 / IDE 插件 > 付费 ChatGPT 会员可直接用 > 也可以走 中转站 / 自定义配置 如果你之前没接触过 Codex，也不用担心。 这篇我尽量用保姆级步骤给你讲清楚：它适合谁、怎么安装、怎么登录、怎么走中转站、配置文件怎么写、常见方式有哪些。 你照着做，基本都能跑起来。 # 一、Codex 适合哪些人？ 先说结论： 目前 ChatGPT Plus、Team、Pro 等付费会员，都可以使用 Codex。 也就是说，如果你本来就有 ChatGPT 的付费账号，那你不一定非得继续死磕别的方案，直接去网页版看看有没有 Codex 入口就行。 这类用户尤其适合上手： > 已经是 ChatGPT 付费用户 > 想找一个更稳定一点的 AI 编程入口 > 习惯在终端里用工具 > 想在 IDE 里直接调 AI 辅助写代码 > 不想把所有鸡蛋都放在单一工具上 如果你平时就写脚本、跑命令、改配置文件，那 Codex 上手会非常快。 # 二、Codex 有哪几种使用方式？ 根据小帅目前整理，Codex 常见有 3 种使用路径： 1，直接用 GPT 付费账号登录 适合已经有 ChatGPT Plus / Team / Pro 的同学。 2，通过 CC Switch + 中转站使用 适合希望切换供应商、灵活管理接口的用户。 3，手动写配置文件，自定义接入中转站 适合折腾能力更强、希望完全自己控制配置的人。 你可以理解成： > 新手优先：直接登录 > 想少折腾但又要灵活：CC Switch > 想完全可控：配置文件方案 # 三、安装：CLI、桌面版、插件版都能用 Codex 不是只有一种形态。 你可以按自己的习惯选： > CLI 命令行版 > 桌面版 > IDE 插件版 如果你是开发者，我个人会更推荐先装 CLI，因为很多能力在终端里会更直接。 # 四、CLI 安装教程 如果你想在终端里直接用 Codex，先搞定 Node.js。 ## 4.1 安装 Node.js 如果你电脑里还没有 Node.js，Windows 用户直接去官网下 LTS 版本 就行。 下载地址： - https://nodejs.org/zh-cn/download - https://www.nodejs.com.cn/download.htm 下载 Windows Installer（.msi），然后一路下一步安装即可。 一般安装完成后，PATH 也会自动帮你配好。 安装完之后，打开终端验证一下： ``` POWERSHELL node -v npm -v ``` 比如文中的环境版本是： ``` TEXT node --version v22.13.0 npm -v 10.9.2 ``` 4.2 版本建议 这里提醒一句： 像 Claude Code、Codex、Gemini CLI 这一类新工具，对 Node.js 版本一般都比较敏感。 建议至少 Node.js 20+，太老的版本可能直接跑不起来。 这一点很关键，很多人不是不会装，而是卡在环境版本太旧。 > 建议你如果本机环境比较乱，优先确认 Node 版本，再继续后面的步骤。不然后面报错了，很容易白折腾。 ## 4.3 配置 npm 镜像（可选） 如果你网络不太稳定，或者装包速度比较慢，可以先把 npm 镜像换一下。 POWERSHELL npm config set registry http://registry.npm.taobao.org npm config get registry # 查看配置的镜像 备用镜像也可以用： POWERSHELL https://registry.npmmirror.com 确认输出是你配置的镜像地址就行。 ## 4.4 安装 Codex 接下来直接安装： POWERSHELL npm install -g @openai/codex 安装完成后，验证一下： POWERSHELL codex --version 如果能正常输出版本号，说明 CLI 已经装好了。 # 五、桌面版安装 如果你不喜欢命令行，也可以直接装桌面版。  支持平台： - Windows - macOS 下载地址： - https://openai.com/zh-Hans-CN/codex 桌面版更适合这几类人： - 不想碰太多命令 - 更习惯图形界面 - 想先快速体验一下 - 主要是轻量使用，不一定深度集成到开发流程里 如果你只是想先看看 Codex 到底能不能用，桌面版会更省事。 # 六、插件版安装 如果你常用 VS Code 或其他 IDE，那插件版也值得装。 安装方式很简单： 1. 打开 IDE 插件市场 2. 搜索 Codex 3. 点击安装 4. 登录 ChatGPT 账号，或者使用中转站方案接入 这种方式的好处是： - 写代码时不用来回切窗口 - 直接在编辑器里交互 - 更适合日常开发流 如果你本来就习惯 AI 插件协作写代码，那这一套几乎没有学习成本。 3 种登录 / 接入方式详解 下面进入重点。 装完之后，怎么真正用起来？ # 七、方式 1：GPT 账号直接登录 这是最适合新手的方案。 打开终端，输入： BASH codex 然后你就可以直接选择 GPT 账号登录。  如果你本身已经是 Plus 用户，这一步通常是最顺的。 不用额外折腾配置，也不用先研究各种 API 参数。 适合人群： - 已有 ChatGPT Plus / Team / Pro - 只想尽快用起来 - 不想先折腾配置文件 如果你只是想先体验 Codex，到这里通常就够了。 # 八、方式 2：CC Switch + 中转站 如果你不想完全依赖官方登录，也可以走 CC Switch + 中转站 的方案。 文中给的流程是这样的： ## 8.1 先准备中转站 比如示例里提到的付费中转站： - https://unity2.ai/register?ref=CdWzuhIw 8.2 打开 CC Switch 进入 Codex 图标选项卡，然后点击右上角 加号 新建供应商。  ## 8.3 填写供应商信息 把下面这些内容填进去： - API 地址 - Key - 相关模型配置 保存之后，就可以让 Codex 通过这个供应商去调用能力  ## 8.4 终端测试 配置完成后，打开终端输入： BASH codex 进去之后可以先随便打个招呼，看看能不能正常响应。 如果能正常返回内容，说明接入成功。  # 九、方式 3：自定义配置文件 + 中转站 这个方案更适合喜欢自己控全局的人。 核心就是编辑 Codex 的全局配置文件： BASH ~/.codex/config.toml 文中的示例配置如下： TOML model_provider = "unity2.ai" model = "gpt-5.4" model_reasoning_effort = "high" disable_response_storage = true personality = "pragmatic" [model_providers.unity2.ai] name = "unity2.ai" base_url = "https://unity2.ai/v1" wire_api = "responses" requires_openai_auth = true env_key = "my_key" ## 9.1 这几个字段怎么理解？ 简单解释一下： - model_provider：你当前使用的供应商名称 - model：指定模型，例如 gpt-5.4，也可以换成别的可用模型 - model_reasoning_effort：推理强度 - disable_response_storage = true：关闭响应存储 - personality = "pragmatic"：输出风格偏务实 而下面这段： TOML [model_providers.unity2.ai] 就是在定义这个供应商的详细配置，包括： - base_url - 接口类型 - 是否需要认证 - 使用哪个环境变量读取密钥 其中最关键的两个点： - base_url一般要带 /v1 - env_key要和你后面设置的环境变量名保持一致 # 十、API Key 怎么设置？ 配置完 config.toml 后，还要把密钥准备好。 文中给了两种方式。 ## 10.1 方式一：终端里设置环境变量 临时生效： BASH export my_key="sk-你的API密钥" 永久生效： BASH echo 'export my_key="sk-你的API密钥"' >> ~/.zshrc source ~/.zshrc 如果你是 Windows PowerShell，则可以这样写： POWERSHELL $env:my_key="sk-你的API密钥" ## 10.2 方式二：写到认证文件里 你也可以直接编辑： BASH ~/.codex/auth.json 内容类似这样： JSON { "my_key": "sk-你的API密钥" } 这两种方案怎么选？ - 想简单测试：用环境变量 - 想长期固定使用：写到配置文件里更省事 # 十一、插件版怎么测试是否正常？ 插件装完、登录或配置完成后，建议你做一个最小测试： - 打开 IDE - 呼出 Codex 插件 - 输入一个简单请求 - 看是否能正常响应 如果插件能返回结果，说明整条链路已经通了。  # 十二、几个容易踩坑的点，提前说清楚 这部分建议你收藏一下，真的很容易出问题。 1，Node 版本太低 很多安装失败、命令跑不起来，根本原因不是 Codex 本身，而是 Node 版本太老。 2，npm 镜像没配好 如果你网络环境一般，装包慢、超时、失败都很常见。 先换镜像，再装，会省很多事。 3**，base_url 少了 /v1** 这是典型小坑。 配置中转站时，如果地址没写完整，很容易请求失败。 4，env_key 和环境变量名对不上 比如你配置里写的是： TOML env_key = "my_key" 那你环境变量就得真叫 my_key，不能写成别的。 5，Windows、macOS、Linux 命令别混用 文里同时给了 Bash 和 PowerShell 写法。 你照自己系统选，不要一股脑全复制过去。 # 十四、最后总结一下 如果你最近正好遇到这些问题： > Claude Code 官方账号不稳定 > 中转站不好用 > 想找一个新的 AI 编程入口 > 已经有 ChatGPT 付费会员 那 Codex 确实值得你试一下。 它不是那种“装一堆东西还不一定能跑”的路线， 只要你把环境、登录方式、配置逻辑捋顺，整体上手并不难。 这篇你完全可以按下面顺序来操作： > 先确认自己有没有 ChatGPT 付费资格 > 安装 Node.js > 安装 Codex CLI > 优先试直接登录 > 如果有需要，再折腾 CC Switch 或配置文件 > 最后在终端 / 插件里做一次最小测试 这样成功率最高，也不容易把自己绕晕。 ## 相关链接 - [@XChatScout](https://x.com/XChatScout) - [4.8K](https://x.com/XChatScout/status/2049704985961869657/analytics) - [https://nodejs.org/zh-cn/download](https://nodejs.org/zh-cn/download) - [https://www.nodejs.com.cn/download.htm](https://www.nodejs.com.cn/download.htm) - [http://registry.npm.taobao.org](http://registry.npm.taobao.org/) - [https://registry.npmmirror.com](https://registry.npmmirror.com/) - [@openai/codex](https://x.com/@openai/codex) - [https://openai.com/zh-Hans-CN/codex](https://openai.com/zh-Hans-CN/codex) - [https://unity2.ai/register?ref=CdWzuhIw](https://unity2.ai/register?ref=CdWzuhIw) - [unity2.ai](https://unity2.ai/) - [providers.unity2.ai](https://providers.unity2.ai/) - [unity2.ai](https://unity2.ai/) - [https://unity2.ai/v1](https://unity2.ai/v1) - [providers.unity2.ai](https://providers.unity2.ai/) - [$env](https://x.com/search?q=%24env&src=cashtag_click) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [12:18 PM · Apr 30, 2026](https://x.com/XChatScout/status/2049704985961869657) - [4,875 Views](https://x.com/XChatScout/status/2049704985961869657/analytics) - [View quotes](https://x.com/XChatScout/status/2049704985961869657/quotes) --- *导出时间: 2026/4/30 16:57:44*
如 如何玩转现在爆火的 Codex ？保姆级教程系列长文来了，人人都能成为 Codex 大神。 本文是 Codex 使用教程系列的开篇，介绍了 Codex 的核心功能，包括自然语言写代码、自动补全、修复 Bug 等，并将其定位为能真正干活的 AI 同事。文章详细讲解了在 Windows 和 macOS 系统上下载、安装及登录 Codex 桌面端的步骤，以及订阅 Plus 会员的方法和注意事项，旨在帮助用户从入门到精通。 技术 › Codex ✍ 聪哥.sats🕐 2026-05-30 Codex教程安装OpenAIAI编程ChatGPTPlus订阅效率工具
开 开源月入10w+的Codex使用方法（超详细教学） 本文详细介绍了OpenAI推出的AI编程Agent Codex的使用方法，包括其与ChatGPT的区别、注册订阅流程、Web/桌面/CLI/IDE四种安装方式，以及桌面App的页面功能全解，帮助非程序员利用AI提升效率。 技术 › Codex ✍ 产品经理老王霸🕐 2026-07-23 AI编程OpenAICodex教程效率工具Agent
C CODEX 高效工作指南：给小白用户的实用入门课 这是一份面向小用户的 Codex（OpenAI coding agent）入门指南。文章指出 Codex 不是单纯的聊天机器人，而是能读写文件、运行命令的“工作搭档”。作者通过对比 ChatGPT，明确了 Codex 的适用场景，并介绍了 App、CLI、IDE 插件等多种入口。核心内容包含四段式提示词模板、常用工作流（解释项目、修 Bug、加功能、审代码）、配置文件 AGENTS.md 的编写方法，以及 MCP、Skills 和 Automations 的区别与用法。最后强调了安全使用原则及新手从只读理解到自动化的进阶路线。 技术 › Codex ✍ Mr Panda🕐 2026-06-12 AI编程CodexOpenAIAgent教程工作流自动化最佳实践提示词AGENTS.md
C Codex 国内使用保姆级教程：三种接入方案详解 本文详细介绍了 Codex 在国内网络环境下的三种接入方案。作者对比了手动配置 config.toml、使用 Codex++ 图形化管理工具、以及部署 CCX + CC Switch 网关三种方法的优缺点，并提供了具体的配置步骤、环境变量设置及常见排错技巧，旨在帮助用户解决无法充值 Plus 或登录官方账号的痛点，实现 Codex 的流畅使用。 技术 › Codex ✍ 苍何🕐 2026-05-30 Codex教程API代理配置CCXCodex++OpenAI模型中转技术实战
C Claude Code / Codex 新手 50 问 这是一份面向新手的 Claude Code 与 Codex 使用路线图，涵盖了从概念辨析、环境搭建到工作流优化的核心问题。文章重点讲解了 Claude Code 的安装配置、斜杠命令（如 /init、/memory、/permissions）的使用方法，以及 CLAUDE.md 的编写技巧，旨在帮助用户建立稳定的编码代理工作流。 技术 › Claude Code ✍ 老爸的AI联萌🕐 2026-05-14 Claude CodeCodex教程工作流DevOps配置命令行AI编程
C Codex CLI /goal 模式详解：OpenAI 官方 Ralph Loop 的自主迭代引擎 文章详细介绍了 OpenAI 在 Codex CLI v0.128.0 中引入的实验性功能 /goal。该功能基于 Ralph Loop 理念，使 Codex 能从单次对话转变为自主规划、持续迭代、自我修正的代理，直至完成高层次目标。文章对比了 /goal 模式与正常模式的区别，列举了适用场景如长周期重构和无人值守开发，并指出该模式能显著提升任务完成度和工程质量，但需注意 Token 消耗。 技术 › Codex ✍ 雪踏乌云🕐 2026-05-03 OpenAICodexAgent开发工具自动化Ralph LoopCLIAI编程迭代DevOps
可 可能是全网最全的 Claudian 配置教程: Claude Code + Codex 双模型实战 这是一份详尽的 Claudian 插件配置教程，旨在帮助用户在 Obsidian 中同时接入 Claude Code 和 Codex 两个模型。文章内容涵盖从 Node.js 环境准备、Obsidian 插件安装、BRAT 工具使用，到具体的 API Key 配置与模型切换的全过程。此外，作者还特别提供了一个“白嫖”番外篇，指导如何利用 OpenRouter 的免费模型 Ling 跑通 Claude Code，无需订阅即可体验 AI 辅助编程功能。 技术 › Claude ✍ 阿蔺A-Lin🕐 2026-04-28 ClaudeClaude CodeClaudianCodexObsidian教程配置AI编程OpenRouterLLM
T The Codex Masterclass：Riley Brown 的 AI 代理工作流指南 本文详细介绍了 Riley Brown 关于 OpenAI Codex 的使用教程。文章指出 Codex 整合了编程与业务工作流，确立了新的界面标准（左侧聊天、中间代理、右侧成果）。内容包括如何利用 Skills 压缩重复工作流、设置多任务并行、连接 Notion 权限管理，以及四个上手实战项目。Riley 强调 GPT 5.5 时代浏览器代理的潜力，并鼓励用户通过探索和试错来掌握 AI 工具。 技术 › OpenAI ✍ The Startup Ideas Podcast (SIP)🕐 2026-04-28 OpenAICodexAgent工作流教程自动化Riley BrownChatGPT生产力工具
别 别再说 Codex 不如 Claude 了！你只是没用对这个神器：oh-my-codex 本文介绍了 OpenAI Codex CLI 的增强工具 oh-my-codex (OMX)。OMX 是一个智能工作流增强层，通过需求澄清、规划审批、持久完成循环和多智能体协调等工程化功能，解决了传统 Codex 缺乏工作流管理的痛点。文章详细讲解了 OMX 的核心功能、安装步骤、四大工作流模式（$deep-interview, $ralplan, $ralph, $team）以及实战案例。 技术 › Codex ✍ Vincent｜只上干货🕐 2026-04-06 AI编程oh-my-codexCodexOpenAI工作流多智能体开发效率DevOpsCLI工程化
开 开源月入10w+的Codex使用方法 文章介绍了 OpenAI 推出的 AI 编程 Agent——Codex。作者指出 Codex 不同于普通对话，它能直接操作文件、运行命令，帮助非程序员实现从 0 到 1 的跨越。文章详细讲解了账号订阅、四种使用方式（Web、桌面、CLI、IDE）、安装步骤以及桌面 App 的核心功能，是一份超详细的实操教程。 技术 › Codex ✍ 产品经理老王霸🕐 2026-07-13 AI编程Agent教程OpenAI效率工具自动化非程序员实战
C Codex 史诗级更新的最全面解析 文章详细解析了 OpenAI Codex 的史诗级更新，重点介绍了新增的“Work”区域与 Codex 的区别，以及 sites、Template Creator 等新插件的实测效果。此外，还涵盖了内置浏览器功能升级、前端设计能力的提升、支持多 Agent 并行执行的 Ultra 模式，以及如何将 GPT 网页端聊天接入 Codex 进行头脑风暴的实用技巧。 技术 › Codex ✍ Sac🕐 2026-07-11 CodexOpenAI更新解析Work模式插件前端设计多Agent教程
别 别再乱装 Codex Skills 了，真正值得先装的是这几类 文章指出，使用 Codex Skills 不应像逛插件商店一样盲目安装，而应围绕核心工作流进行选择。作者推荐了三个安装阶段：第一阶段优先安装前端设计类（如 frontend-design）和浏览器验收类 Skill，以实现从“写页面”到“审页面”的闭环；第二阶段安装研究类（如 last30days）和内容类 Skill，用于产出高质量长文；第三阶段按需补全 Figma 和销售类 Skill。此外，作者建议通过自定义 AGENTS.md 来固化工作流程，提升 Agent 的执行稳定性。 技术 › Codex ✍ MuscleMan🕐 2026-07-06 CodexClaude CodeAgent前端开发工作流AI编程Agent-BrowserResearchContent-Strategy教程