Claude Code系列教程5：如何安装Claude Code？

如何安装 Claude Code

Claude Code 的安装没有图形界面里的“下一步”，全程都在命令行里完成。如果你平时用 npm，整个过程不会超过两分钟。

前提条件

开始之前，确保手边有以下东西：

• Node.js 18 或更高版本
  检查方式：在终端执行 node -v。如果版本低于 18，用 nvm、fnm 或直接去 nodejs.org 升级一下。
• 一个 Anthropic 账号
  注册地址是 https://console.anthropic.com。账号会提供 API Key，安装后需要用到。注册本身免费，实际花费按使用量计算。
• 网络可以访问 Anthropic 的 API 端点
  默认域名是 api.anthropic.com。如果环境需要配置代理，记得在终端里设置 HTTP_PROXY 或 HTTPS_PROXY。

安装方式一：npm 全局安装

这是最常用的方式，装一次之后到处能用。

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

完成后，执行 claude --version，如果输出了一个版本号，说明安装成功。全局安装后，claude 这个命令在任何目录下都可以直接调用。

如果遇到权限错误（常见于 macOS 的 /usr/local/lib 目录），两种处理方式：

1. 使用 sudo 安装（省事但有安全争议）。
2. 配置 npm 使用用户目录，避免 sudo：
   bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
   然后把 ~/.npm-global/bin 加到 PATH 里，重开终端即可。

安装方式二：npx 即用即走

如果你不想全局装任何东西，或者只是想临时试用一下，用 npx 更直接。

npx @anthropic-ai/claude-code

npx 会临时下载最新的包，运行完之后不留下全局命令。每次使用都会检查更新，所以天然保持在最新版。缺点是稍微慢一点（每次都要下载），而且不适合写进自动脚本里频繁调用。

适合场景：第一次上手体验、临时在别人机器上用、或者偶尔用一次。

验证是否可以正常启动

安装后先别急着认证。运行一句简单的话，看看工具能不能启动：

claude --help

如果输出了帮助信息，说明二进制文件没问题。下一步是连接你的账号，这个放到后面会讲

两种方式装完之后的本体是同一个，后续认证、使用方式完全一致。选你觉得顺手的一种就行。

常见问题

• Node 版本太低
  低于 18 会直接报错，不是警告。升级 Node 是最直接的解法。
• 网络超时
  无论是 npm 拉包还是后续连接 API，都可能因为代理或防火墙卡住。先确认 curl https://api.anthropic.com 能通，再做后面的操作。
• Windows 下直接使用原生 cmd
  虽然理论上可以，但建议用 Git Bash、WSL2 或 Windows Terminal，避开稀奇古怪的路径转义问题。