Codex零基础入门：安装到高效使用

Codex是什么？

Codex是OpenAI推出的AI编码代理（agent），能理解你的项目结构，根据自然语言指令读取、编辑、运行代码和命令。它不是一个简单的代码补全工具，而是一个能独立完成任务的“AI队友”。

四种使用方式，该选哪个？

Codex有四种使用方式：桌面应用、VS Code扩展、CLI（命令行）和云模式（Cloud）。

桌面应用：功能最完整，可视化界面支持富文本渲染、图片预览、差异对比等。适合想直观操作、喜欢IDE式体验的用户。新手建议从这里开始。

VS Code扩展：在编辑器内直接使用，与现有工作流结合紧密，适合习惯VS Code的开发者。

CLI（命令行）：轻量、可脚本化，适合终端控和CI/CD场景。安装后只需在项目目录运行codex即可开始。

云模式：任务在OpenAI服务器上执行，你可以关掉电脑，之后回来接着干。需要关联GitHub，适合跑长任务或不占本地资源。

如果你刚开始，优先尝试桌面应用或VS Code扩展——它们给你更好的交互体验，方便理解Codex的能力。

安装与设置（截至2026年7月）

桌面应用

从OpenAI官网下载安装包（macOS原生支持；Windows和Linux用户需查看官方文档确认兼容性）。安装后打开应用，用ChatGPT账户登录即可。

CLI安装

Codex CLI需要Node.js 18+或Homebrew。Windows建议使用WSL（原生支持尚在实验阶段）。

`bash
# 使用npm全局安装
npm install -g @openai/codex

# 或者在macOS上通过Homebrew安装
brew install codex

# 验证安装
codex --version
`

首次运行codex，选择“Sign in with ChatGPT”用你的ChatGPT账号认证。也可以设置OPENAI_API_KEY环境变量用于自动化。

核心概念：线程与工作树

线程（Thread）：每次对话是一个线程，相当于一个agent实例。Codex桌面应用会持久化保存线程——即使关闭应用再打开，所有对话历史都在。你可以随时回到之前的线程继续工作。

工作树（Worktree）：这是Codex的高效并行技巧。它基于Git worktree技术，将当前分支克隆到一个独立的本地目录。这样你可以在同一个项目上同时运行两个agent，各自修改不同文件而互不干扰。在桌面应用侧边栏，你可以创建和管理多个工作树，每个工作树内又可以创建多个线程。

价格与限制

截至2026年7月，Codex包含在ChatGPT的免费、Plus、Pro、Business、Enterprise等所有计划中。免费用户可正常使用，但有使用额度（具体限额请参考OpenAI官网）。付费计划提供更高的使用额度：Pro计划从$100/月起，包含本地消息和云任务共享的时间窗口。平均每个开发者每月花费约$100–$200（根据官方价目表估算）。

高效使用技巧

善用工作树：比如同时开发两个feature，分别在不同工作树中开线程，互不影响。

利用云模式：把耗时任务（如大型重构、批处理）交给云模式，关掉电脑也不中断。

掌握权限模式：CLI中有三种权限：Auto（默认，读写项目目录但访问外部需确认）、Read-only（只读模式）、Full Access（完全权限）。在对话中用/permissions命令切换。

保持线程整洁：一个线程专注一个任务，完成后再开新线程。线程的持久化让你随时可以复盘。

常见误区

Codex（2025年发布的AI agent）与2023年已停用的旧版Codex API模型不是同一个产品。你现在使用的是新一代的编码代理，能力更强，集成更深入。

下一步

找个你现有的小项目（或新建一个），打开Codex桌面应用，试着说“给我添加一个README文件”或“修复这个函数里的bug”。感受一下agent的工作方式，然后逐步尝试更复杂的任务。