Claude 与 Codex 安装教程

Claude 与 Codex 安装教程

AI 编程助手已经成为开发者日常工具链中不可或缺的一环。本文详细介绍如何安装和配置目前最主流的两款 AI 编程工具：Anthropic 的 Claude（Claude Desktop + Claude Code CLI）和 OpenAI 的 Codex（Codex CLI / Codex 桌面应用）。

无论你用的是 macOS、Windows 还是 Linux，跟着走一遍就能跑起来。

准备工作

在开始之前，请确认你具备以下条件：

  • 一台 macOS、Windows 或 Linux 电脑
  • 稳定的网络环境（部分服务需要代理）
  • Python 3.8+（Codex CLI 依赖）
  • Node.js 18+（Claude Code 依赖）
  • 对应平台的 API Key 或订阅账号

如果你的网络无法直连 OpenAI / Anthropic 服务，请提前准备好代理工具，并确保终端环境变量中正确设置了 HTTP_PROXY 和 HTTPS_PROXY。

第一部分：安装 Claude

Claude 目前提供两种使用方式：桌面应用（Claude Desktop）和命令行工具（Claude Code CLI）。桌面应用适合日常对话，Claude Code 则面向编程场景，可以直接在终端里读写文件、执行命令。

1.1 安装 Claude Desktop

macOS

  1. 打开浏览器，访问 Claude 官网：https://claude.ai
  2. 点击右上角 “Download” 或直接访问 https://claude.ai/download
  3. 下载 .dmg 文件，双击挂载
  4. 将 Claude 拖入 Applications 文件夹
  5. 打开 Claude，使用 Anthropic 账号登录（可用 Google / Apple 账号快捷登录）

Windows

  1. 访问 https://claude.ai/download
  2. 下载 Windows 版安装包（.exe）
  3. 双击运行安装程序，按提示完成安装
  4. 打开 Claude，登录你的 Anthropic 账号

Claude Desktop 支持 Mac（Apple Silicon + Intel）和 Windows 10/11。Linux 暂无官方桌面客户端，建议使用网页版 https://claude.ai 或 Claude Code CLI。

1.2 安装 Claude Code CLI

Claude Code 是 Anthropic 官方推出的终端编程工具，可以在你的项目目录中直接与 Claude 交互，支持文件读写、命令执行、Git 操作等。

前置要求

  • Node.js 18 或更高版本
  • npm 或其他包管理器

检查 Node.js 是否安装：

1
2
node -v
npm -v

如果未安装 Node.js，前往 https://nodejs.org 下载 LTS 版本安装。

全局安装

1
npm install -g @anthropic-ai/claude-code

安装完成后验证：

1
claude --version

首次配置

在终端运行：

1
claude

首次启动会引导你完成认证流程，浏览器会自动打开授权页面，登录你的 Anthropic 账号并授权即可。

如果你使用 API Key 方式认证，可以设置环境变量：

1
2
3
4
5
# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

建议将环境变量写入 ~/.zshrc（macOS）或 ~/.bashrc（Linux）以持久化。

基本使用

进入你的项目目录，启动 Claude Code：

1
2
cd ~/my-project
claude

进入交互界面后，你可以直接用自然语言描述需求，例如：

  • 帮我看看这个项目的结构
  • 给 utils.js 里的 parseDate 函数加上单元测试
  • 把 README 翻译成英文

Claude Code 会自动读取相关文件、执行操作，并在每一步征求你的确认。

第二部分：安装 Codex

OpenAI Codex 是 OpenAI 推出的 AI 编程代理，支持终端 CLI 和桌面应用两种形态。它基于 GPT 系列模型，擅长代码生成、调试、重构和自动化任务。

2.1 安装 Codex CLI

前置要求

  • Node.js 18+ 或 Python 3.8+
  • OpenAI API Key 或 ChatGPT Plus / Pro / Team / Enterprise 订阅

通过 npm 安装（推荐）

1
npm install -g @openai/codex

验证安装：

1
codex --version

通过 Homebrew 安装（macOS）

如果你使用 macOS 且安装了 Homebrew：

1
brew install codex

首次配置

Codex 支持两种认证方式：

方式一：使用 ChatGPT 订阅（推荐）

如果你有 ChatGPT Plus / Pro / Team / Enterprise 订阅，可以直接用账号登录，无需单独购买 API：

1
codex

首次运行会引导你在浏览器中完成 ChatGPT 账号授权。

方式二：使用 OpenAI API Key

前往 https://platform.openai.com/api-keys 创建 API Key，然后设置环境变量：

1
2
3
4
5
# macOS / Linux
export OPENAI_API_KEY="sk-xxxxxxxxxxxxx"

# Windows PowerShell
$env:OPENAI_API_KEY="sk-xxxxxxxxxxxxx"

同样建议写入 shell 配置文件以持久化。

基本使用

进入项目目录，启动 Codex：

1
2
cd ~/my-project
codex

在交互界面中，你可以输入自然语言指令：

  • 重构 auth 模块，把回调函数改成 async/await
  • 运行测试并修复失败的用例
  • 生成一个 Dockerfile

Codex 会自主读取代码、规划步骤、执行命令，并在关键操作前请求你的确认。

常用命令

1
2
3
4
5
codex                    # 启动交互式会话
codex "修复 bug"          # 直接执行一次性指令
codex --model gpt-5      # 指定模型
codex --auto             # 自动模式（减少确认次数，谨慎使用）
codex --help             # 查看完整帮助

2.2 安装 Codex 桌面应用

OpenAI 也提供了 Codex 的桌面应用，适合不喜欢终端操作的用户。

macOS

  1. 访问 https://openai.com/codex 下载页面
  2. 下载 .dmg 文件
  3. 双击挂载，拖入 Applications
  4. 打开应用，登录 ChatGPT 账号或配置 API Key

Windows

  1. 在下载页面选择 Windows 版安装包
  2. 运行 .exe 安装程序
  3. 打开应用，完成登录

Codex 桌面应用的界面更直观，适合做代码审查和项目管理，但功能上 CLI 版本更灵活、更适合深度编程。

第三部分：配置优化

3.1 代理配置

如果你在国内网络环境下使用，需要配置代理。在终端中设置：

1
2
3
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5://127.0.0.1:7890"

将 7890 替换为你实际的代理端口。建议写入 ~/.zshrc 或 ~/.bashrc。

3.2 模型选择

两款工具都支持指定不同的模型：

1
2
3
4
5
6
7
# Claude Code
claude --model claude-sonnet-4-5
claude --model claude-opus-4-1

# Codex
codex --model gpt-5
codex --model gpt-5-codex

日常编程推荐使用 Sonnet / GPT-5 等速度快的模型，复杂推理任务可以切换到 Opus / 更高推理等级。

3.3 自定义指令

两款工具都支持项目级别的配置文件，用于设定自定义行为：

Claude Code：在项目根目录创建 CLAUDE.md

1
2
3
4
5
# 项目规范

- 使用 TypeScript
- 代码风格遵循 ESLint 配置
- 提交信息使用 Conventional Commits 格式

Codex：在项目根目录创建 AGENTS.md

1
2
3
4
5
# 项目规范

- 测试使用 pytest
- Python 版本 3.11
- 文档使用中文

这些文件会让 AI 在每次会话启动时自动读取，省去重复说明的麻烦。

第四部分：常见问题

Q1 安装时报权限错误？

npm install -g 在 macOS 上可能遇到 EACCES 权限错误。解决方案：

1
2
3
4
5
6
7
# 方案一：使用 sudo（不推荐，可能引发后续问题）
sudo npm install -g @anthropic-ai/claude-code

# 方案二：修改 npm 全局目录（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 然后将 ~/.npm-global/bin 加入 PATH

Q2 登录时浏览器没反应？

确保终端能正常打开浏览器。在无图形界面的服务器上，可以手动复制终端中显示的授权 URL 到本地浏览器。

Q3 Claude Code 和 Codex 能同时用吗？

可以。两者完全独立，互不干扰。很多人会根据任务特点交替使用：Claude Code 做前端和 TypeScript，Codex 做后端和 Python。

Q4 每月费用多少？

  • Claude：免费版有限额，Pro 订阅 20 美元/月，包含 Claude Code 使用额度
  • Codex：ChatGPT Plus 20 美元/月，Pro 200 美元/月，API 则按 token 计费

Q5 终端报 Node 版本过低？

升级 Node.js 到 18 以上。推荐使用 nvm 管理多版本：

1
2
3
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 22
nvm use 22

总结

特性 Claude (Claude Code) Codex (Codex CLI)
开发商 Anthropic OpenAI
底层模型 Claude Sonnet / Opus GPT-5 / GPT-5-Codex
桌面应用 Claude Desktop Codex 桌面应用
CLI 工具 Claude Code Codex CLI
认证方式 Anthropic 账号 / API Key ChatGPT 订阅 / API Key
配置文件 CLAUDE.md AGENTS.md
适合场景 前端 / TypeScript / 长上下文 后端 / Python / 自动化

两款工具各有侧重，选择哪一款取决于你的技术栈和使用习惯。如果条件允许，建议都装上，在实际项目中对比体验，找到最顺手的那一个。

AI 编程助手不是替代你写代码，而是帮你把重复劳动交给机器，把思考留给真正有价值的问题。装好工具，开始干活吧。