安装 Codex 与 Claude Code

本页用于快速准备两个常用终端 Agent。更完整的产品说明见 Codex CLI 和 Claude Code。

环境要求

• 已按版本选择说明安装 Node.js 24 LTS,或使用项目明确要求的 Node.js 22 LTS
• 如果选择通过 npm 安装 Codex,终端需可访问 npm registry；Claude Code 原生安装不依赖 npm
• 已准备 ChatGPT / OpenAI 账号或 Claude / Anthropic 账号

安装 Codex

Codex 可以使用 npm 全局安装:

npm install -g @openai/codex
codex --version

也可以按官方 README 使用安装脚本或 GitHub Release。不同安装方式不要混用,否则升级和 PATH 排查会更麻烦。

安装 Claude Code

Windows PowerShell

irm https://claude.ai/install.ps1 | iex
claude --version

Windows WinGet

winget install Anthropic.ClaudeCode
claude --version

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash
claude --version

Claude Code 官方当前不建议把 npm 作为默认安装方式。需要 npm 安装时,先查看官方 setup 文档确认当前兼容性。

首次登录

进入任意项目目录后启动:

cd your-project
codex

cd your-project
claude

按提示登录账号或配置 API Key。Codex 如果使用 API Key,设置变量后还需要运行 codex login --with-api-key,详见Codex 认证步骤。建议先在一个小项目里试运行,确认能读取文件、生成计划并执行简单命令。

PowerShell 使用 API Key 时,当前窗口直接生效的写法是:

$env:OPENAI_API_KEY = "sk-xxxx"
$env:ANTHROPIC_API_KEY = "sk-ant-xxxx"

这里只是展示语法；你只需为实际使用的产品设置对应变量。不要把真实密钥写入项目文件或提交到 Git。如果使用 setx,必须重新打开终端后再启动 CLI。

建议验证

node -v
npm -v
codex --version
claude --version

在项目目录中验证:

codex "阅读项目结构并总结构建命令"
claude "阅读项目结构并总结构建命令"

如果命令行工具需要访问外部文档、浏览器或 IDE,再继续配置 IDEA MCP 或 MCP 全流程选择指南。

升级

Codex 通过 npm 安装时:

npm update -g @openai/codex

Claude Code 应按安装渠道升级:

winget upgrade Anthropic.ClaudeCode

macOS / Linux 原生安装器通常会自动更新；需要手动更新时运行 claude update。其他渠道请按对应安装说明升级,不要混用安装方式。

升级后重新打开终端并再次运行 --version。如果使用安装脚本或 Release 安装,按对应项目的最新 README 重新安装。

常见问题

command not found

检查 npm 全局 bin 目录是否在 PATH 中:

npm config get prefix

Windows 建议重新打开 PowerShell;macOS / Linux 检查 ~/.zshrc 或 ~/.bashrc。

npm 全局安装权限错误

优先使用 nvm / nvm-windows 管理 Node.js,避免直接用管理员权限污染系统 Node。已经出现权限问题时,先确认 npm config get prefix 指向当前用户目录。

两个 CLI 是否必须都安装

不是。只使用 OpenAI 生态时可先装 Codex;主要使用 Claude 时可先装 Claude Code。两者都安装的价值在于复杂任务可以交叉验证。

相关文档

• Codex CLI
• Claude Code
• AI 客户端选择指南

下一步

继续安装 CC Switch。