Codex 简介与安装
什么是 Codex？
Codex 是 Anthropic 推出的一款基于 Claude 模型的 AI 编程代理工具。与传统的代码补全工具不同，Codex 能够直接在终端环境中理解项目上下文、执行命令、编辑文件，并完成复杂的编程任务。它不仅仅是一个聊天机器人，而是一个真正的编程代理（Coding Agent），能够自主地探索代码库、诊断问题、实施修改并验证结果。
Codex vs Copilot vs Cursor
| 特性 | Codex | GitHub Copilot | Cursor |
|---|---|---|---|
| 工作方式 | 终端代理 + 文件编辑 | IDE 内联补全 | AI 优先编辑器 |
| 项目级操作 | 完全支持（可自主探索） | 有限 | 支持 |
| 命令执行 | 支持（直接在终端运行） | 不支持 | 内置终端 |
| 多文件编辑 | 支持（批量操作） | 逐行补全 | 支持 |
| 对话模式 | 完整对话历史管理 | 侧边栏对话 | 内嵌对话 |
| 离线使用 | 需要网络 | 需要网络 | 需要网络 |
系统要求
Codex 支持以下操作系统：
- macOS 10.15（Catalina）及以上
- Windows 10 及以上（通过 WSL2）
- Linux（主流发行版，如 Ubuntu 20.04+、Debian 11+、Fedora 38+）
硬件要求
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| 内存 | 4 GB | 8 GB 以上 |
| 存储 | 1 GB 可用空间 | SSD 5 GB 以上 |
| 网络 | 宽带连接 | 低延迟连接 |
软件依赖
- Node.js 18.0.0 或更高版本
- Git 2.23 或更高版本
- npm 或 yarn 包管理器
- 终端模拟器（如 iTerm2、Windows Terminal、Konsole）
安装方式
方式一：npm 安装（推荐）
全局安装 Codex：
npm install -g @anthropic-ai/claude-code
安装完成后，可以通过以下命令启动：
claude
方式二：npx 运行（无需安装）
如果不想全局安装，可以直接使用 npx：
npx @anthropic-ai/claude-code
方式三：pip 安装
Python 用户也可以通过 pip 安装：
pip install claude-code
方式四：Homebrew 安装（macOS）
brew install claude-code
首次启动
安装完成后，在终端中输入 claude 即可启动：
claude
首次启动时，系统会引导您完成以下步骤：
- 登录验证 — 使用 Anthropic 账号登录
- API Key 配置 — 输入您的 API Key 或选择自动配置
- 工作目录确认 — 确认需要 Codex 工作的项目目录
- 初始扫描 — Codex 会自动扫描项目结构，创建索引
启动成功后，您将看到 Codex 的命令提示符 ▸，表示已准备好接受指令。
验证安装
运行以下命令验证安装是否成功：
claude --version
如果显示版本号（如 0.1.0），说明安装成功。
环境变量配置
Codex 支持通过环境变量进行配置，常用的环境变量包括：
# API 密钥
export ANTHROPIC_API_KEY=your_api_key_here
# 设置代理（如需）
export HTTPS_PROXY=http://proxy.example.com:8080
# 自定义配置目录
export CLAUDE_CONFIG_DIR=/path/to/config
# 设置语言
export LANG=zh_CN.UTF-8
建议将这些配置写入您的 shell 配置文件（如 ~/.zshrc 或 ~/.bashrc），以便永久生效。