Codex 安装与使用教程：新手也能快速上手 🤖 如果你第一次接触 Codex，这篇文章就够用了。 重点讲 4 件事：
Codex 是什么怎么安装怎么开始用使用时要注意什么👀适合谁看第一次接触 Codex 的开发者想先搞懂是什么、怎么装、怎么开始用。🚀推荐入口CLI 或 IDE 插件本地协作更直接，真正写代码时更顺手。📌内容基准基于 2026-03-26 官方资料计划和下载地址以后可能会变，请以官方页面为准。1. Codex 是什么？ 一句话理解：
Codex 是一个面向开发场景的 AI 编程助手。
它不只是回答问题，还能继续往下做：
看项目结构找代码入口修改文件执行命令分析报错做代码 review简单说，它更像一个会干活的 AI 搭子。
TIP
把它理解成“能参与执行的协作助手”，最容易上手。
2. 常见入口 按照 OpenAI 当前官方资料，Codex 常见有 4 个入口：
Codex WebCodex CLICodex IDE extensionCodex appWeb🌐先看效果最快适合把明确任务交给它后台执行。关键词：GitHub、云端执行、先试效果CLI⌨️本地协作最高频适合在项目目录里边问边改边验证。关键词：终端、本地项目、改完就验IDE 插件🧩编辑器党首选适合 VS Code、Cursor、JetBrains 用户。关键词：边写边改、上下文强、切换更少App🖥️复杂任务更舒服适合多线程、Diff、Git、跨项目协作。关键词：线程、Diff、Worktree、Automation如果你是第一次接触，我建议这样选：
想先感受效果，不想先折腾安装：从 Web 开始想在本地项目里直接协作改代码：从 CLI 开始想在编辑器里边写边改：用 IDE extension想多线程处理任务、跨项目切换：试试 App3. 使用前需要准备什么？ 开始之前，先确认：
你有一个可用的 ChatGPT 账号你的账号计划支持 Codex如果你打算用 Codex Web 连 GitHub 仓库，需要先完成 GitHub 连接快速判断
如果你只是先体验效果，优先走 Web 或 CLI + ChatGPT 登录 就够了。 如果你已经长期在某个编辑器里工作，那直接装 IDE 插件 往往更顺手。
4. 最容易入门的方式：Codex Web 如果你不想先装环境，最容易上手的是 Codex Web 🌐
基本流程很简单：
登录 ChatGPT打开 Codex 入口连接 GitHub选择仓库输入任务，让它开始执行Web 端尤其适合这些任务想后台执行的明确任务和 GitHub 仓库强相关的问题不想先配置本地环境的场景先试用、先感受再决定是否深度使用5. Codex CLI 教程 5.1 基本介绍 如果你平时主要在本地项目里开发，Codex CLI 会更实用。
它适合这种场景：
在终端里直接和 AI 协作让它在当前项目目录里分析和修改改完后马上检查结果官方地址： Codex CLI
5.2 setup Install 先确认电脑里已经有：
Node.jsnpmbashnode -v
npm -vOpenAI 官方文档当前给出了两种常见安装方式：
npmHomebrewbashnpm install -g @openai/codexbashbrew install codexNnpm 安装更通用适合已经有 Node.js / npm 环境的人。BHomebrew 安装macOS 更顺手如果你习惯用 brew 管理工具，这个方式更自然。Run 进入你的项目目录：
bashcd your-project然后运行：
bashcodex第一次运行时，会提示你登录。 对大多数新手来说，直接用 ChatGPT account 登录最省事。
登录方式说明
如果你只是想快速体验，优先选择 ChatGPT account。API key 更适合已经有 API 工作流、或者需要额外计费控制的人。
新手第一次上手，建议先做这些小任务：
解释项目结构找入口文件修一个小 bug补一个简单测试Step 1进入项目目录cd your-projectStep 2启动 CodexcodexStep 3先给小任务先从目录分析、入口定位、修一个小 bug 开始。Step 4检查改动结果看它改了哪些文件、结果是否符合预期。适合新手的第一次提问 项目结构修复 bug补测试text帮我分析这个项目的目录结构，告诉我首页入口文件在哪里text帮我找出登录按钮点击没反应的原因，并修复它，最后告诉我改了什么text帮我为这个接口补一个最基础的测试，不要改业务逻辑Upgrade 如果你想升级到最新版本，可以按安装方式选择：
npmHomebrewbashnpm i -g @openai/codex@latestbashbrew upgrade codex6. IDE 插件怎么上手？ 6.1 基本介绍 如果你平时大部分时间都在编辑器里，那 IDE extension 会非常顺手 🧩
支持重点包括：
Visual Studio CodeCursorWindsurfJetBrains IDEs6.2 下载地址 VS Code / VS Code Insiders： Visual Studio Marketplace - OpenAI ChatGPT / Codex ExtensionCursor： Codex IDE 官方安装说明Windsurf： Codex IDE 官方安装说明JetBrains IDEs： JetBrains 集成说明🔗下载安装地址汇总VS Code Marketplace：https://marketplace.visualstudio.com/items?itemName=openai.chatgptCodex IDE 官方安装页：https://developers.openai.com/codex/ideJetBrains 集成说明：https://blog.jetbrains.com/ai/2026/01/codex-in-jetbrains-ides/6.3 安装步骤 侧边栏打开 Codex 面板后，可以直接结合当前项目上下文协作。安装插件、登录、打开项目、开始提问，基本就能跑起来。在对应编辑器里安装 Codex 扩展打开侧边栏里的 Codex 面板用 ChatGPT 账号或 API key 登录在当前项目里直接开始提问或下达任务默认会以 Agent mode 工作，也就是可以读文件、跑命令、改代码。
6.4 使用说明 比较适合这类场景：
你正在编辑代码，不想来回切终端你想让 AI 直接结合当前文件上下文工作你已经习惯 VS Code、Cursor、JetBrains 这类编辑器工作流NOTE
如果你长期在编辑器里工作，这个入口通常比单独切 CLI 更顺。
7. App 端怎么用？ 如果你更喜欢独立桌面应用，可以试试 Codex app 🖥️
目前官方重点支持 macOS (Apple Silicon)。
它更适合：
并行处理多个线程内置 Git 功能worktree 支持automations跨项目切换下载与安装 官方页面： Codex AppmacOS 下载地址： Codex.dmgLinux 通知入口： Codex App Linux waitlist安装步骤 打开官方 Codex App 页面下载 Codex.dmg安装完成后打开 App用 ChatGPT 账号或 API key 登录开始使用 选择一个项目目录确认使用 Local发送第一条消息结合线程、Diff、Git 继续推进任务小提示
如果你是第一次用 App，建议先选一个熟悉的小项目，先体验对话、查看改动、检查结果这套流程。
App 更像一个集中处理线程、Diff、Git 和自动化任务的工作台。8. 怎么提问更容易成功？ 别太模糊。
一个非常实用的公式是：
目标 + 范围 + 限制 + 预期结果
💬推荐提问模版 帮我 + 目标 + 范围 + 限制条件 + 预期结果 例如：帮我修复登录按钮点击无效的问题，只改登录页，不要动接口协议，修完后告诉我改了哪些文件。 你说得越清楚，Codex 通常做得越稳。
TIP
新手最容易出问题的地方，不是不会提需求，而是把范围说得太大、限制条件说得太少。
9. Codex 最适合做哪些事？ 看懂项目结构快速找代码入口修一个明确 bug补测试做重复性重构工作帮你起草文档做代码 review更适合交给 Codex明确 bug、入口定位、补测试、局部重构、文档起草、代码审查。第一次不建议直接做整站大改、核心链路重写、多个模块一起迁移、无法快速验证结果的复杂任务。10. 使用 Codex 时要注意什么？ 它很强，但不代表永远对。
尤其这些场景，一定不要完全放手：
支付权限删除数据安全相关改动生产环境紧急修复让 Codex 提速，但由你来做最终判断。
CAUTION
涉及支付、权限、安全、生产紧急修复时，不建议直接接受修改结果而不复核。
第一次别上来就做超大任务，先从小问题开始会更稳。
11. 最后总结 如果要用一句话概括：
Codex 不是只会回答问题的 AI，而是一个能真正进入开发流程、帮助你推进任务的 AI 编程助手。
Quick Recap第一次接触 Codex，建议这样开始先确认账号和计划可用。想省事先试 Web，想本地协作用 CLI。编辑器用户直接装 IDE 插件，复杂任务再试 App。从小任务开始，关键代码自己复核。12. 官方地址 Codex 总览Codex CLICodex IDECodex App