2026年如何安装Claude代码CLI：完整设置指南

AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠，帮助初创企业和开发者节省开支。

查看所有 AI Perks

2026 年如何安装 Claude Code CLI

要在终端中安装 Claude Code，请运行 npm install -g @anthropic-ai/claude-code@latest。安装大约需要 30 秒。使用 claude --version 进行验证，然后使用 claude auth login 进行身份验证即可开始使用。

Claude Code 需要 Node.js 18 或更高版本。安装完成后，它可以在 macOS、Linux 和 Windows 上使用相同的命令运行。在设置过程中，AI Perks 可以为您提供价值 $1,000-$25,000+ 的免费 Anthropic 积分，以零成本驱动 Claude Code。

在AI积分上节省您的预算

搜索优惠

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

全部免费合作关系

搜索优惠

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

全部免费合作关系

Software	预估积分	条件	审批指数	操作

推广您的 SaaS

覆盖全球 90,000+ 寻找类似您工具的创始人

立即申请

系统要求

检查您的 Node.js 版本：

node --version

如果低于 18，请从 nodejs.org 安装最新 LTS 版本或使用 nvm。

AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠，帮助初创企业和开发者节省开支。

查看所有 AI Perks

在 macOS 上安装 Claude Code

步骤 1：安装 Node.js（如果尚未安装）

使用 Homebrew：

brew install node

或从 nodejs.org 下载。

步骤 2：安装 Claude Code

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

步骤 3：验证安装

claude --version

您应该会看到打印出的版本号（例如 1.x.x）。

步骤 4：身份验证

claude auth login

这将打开一个浏览器，通过您的 Anthropic 帐户进行登录。

在 Linux 上安装 Claude Code

步骤 1：安装 Node.js（Ubuntu/Debian）

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

对于其他发行版（Fedora、Arch 等），请使用您的包管理器。

步骤 2：安装 Claude Code

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

如果您遇到权限错误，请不要使用 sudo 与 npm 一起使用。而是修复 npm 的前缀：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

然后重新安装。

步骤 3：验证和身份验证

claude --version
claude auth login

在 Windows 上安装 Claude Code

步骤 1：安装 Node.js

从 nodejs.org 下载 Windows 安装程序并运行它。确保在安装过程中勾选“Add to PATH”。

步骤 2：打开 PowerShell 或终端

以管理员身份打开 PowerShell（或 Windows Terminal）。

步骤 3：安装 Claude Code

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

步骤 4：验证安装

claude --version

如果 claude 未被识别，请重新启动终端或检查 npm 的全局 bin 文件夹是否在您的 PATH 中：

npm config get prefix

将生成的路径（末尾附加 \）添加到您的系统 PATH 变量中。

步骤 5：身份验证

claude auth login

身份验证方法

Claude Code 支持三种身份验证方法：

方法 1：OAuth 登录（最简单）

claude auth login

这将打开一个浏览器，通过您的 Anthropic 帐户进行登录。最适合与 Pro/Max 订阅个人使用。

方法 2：API 密钥（推荐用于免费积分）

将您的 Anthropic API 密钥设置为环境变量：

macOS/Linux：

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc  # 或 ~/.bashrc

Windows (PowerShell)：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-...', 'User')

这是使用免费 Anthropic 积分（来自 AI Perks）而不是付费订阅的最佳选择。

方法 3：配置文件

编辑 ~/.claude/auth/credentials.json：

{
  "api_key": "sk-ant-...",
  "auth_type": "api_key"
}

首次设置：验证一切是否正常工作

安装和身份验证后：

测试基本功能

claude

您应该会看到 Claude Code REPL。尝试一个提示：

Hello! What model are you running?

Claude 应该会回复一个问候语并指示正在使用的模型。

测试文件操作

导航到一个项目文件夹：

cd ~/projects/my-app
claude

让 Claude 读取您的 README：

Can you read the README.md and summarize this project?

如果 Claude 读取并响应，则表示您的设置正常。

常见的安装错误及修复方法

错误：npm ERR! EACCES permission denied

您没有权限写入 npm 的全局文件夹。修复方法：

# 不要使用 sudo。而是更改 npm 的前缀：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

将 export 添加到您的 ~/.zshrc 或 ~/.bashrc 以使其永久生效。

错误：command not found: claude

安装后找不到 claude 命令。原因：

1. 未重新启动终端 - 关闭并重新打开您的终端
2. PATH 中缺少 npm bin - 运行 echo $(npm config get prefix)/bin 并添加到 PATH
3. 错误的 shell 配置 - 对于 zsh，编辑 ~/.zshrc；对于 bash，编辑 ~/.bashrc

错误：Node.js version too old

Claude Code 需要 Node.js 18+。升级：

# macOS (Homebrew)
brew upgrade node

# Linux (nvm)
nvm install 20
nvm use 20

# Windows
# 从 nodejs.org 下载最新的 LTS 版本

错误：Authentication failed

• 验证您的 API 密钥是否以 sk-ant- 开头
• 检查它是否未在 console.anthropic.com 上被撤销
• 确保您的 ANTHROPIC_API_KEY 环境变量中没有多余的空格
• 尝试重新生成密钥

错误：Cannot find module '@anthropic-ai/claude-code'

安装未完成。尝试：

npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest --force

使用免费 Anthropic 积分驱动 Claude Code

Claude Code 需要付费订阅（每月 $20-$200）或 API 积分才能实际运行。通过 AI Perks 提供的免费 Anthropic 积分将完全覆盖 API 成本。

总计潜在：$4,500 - $156,000+ 的免费 Claude 积分

安装 Claude Code 后，使用由免费积分驱动的 API 密钥进行配置，完全跳过订阅计费。

分步：免费安装 + 运行 Claude Code

步骤 1：安装 Claude Code

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

步骤 2：获取免费 Anthropic 积分

订阅 AI Perks 并申请积分计划。大多数决策将在一周内做出。

步骤 3：生成 API 密钥

登录 console.anthropic.com 并在设置 > API 密钥中创建 API 密钥。

步骤 4：配置 Claude Code

export ANTHROPIC_API_KEY="sk-ant-..."

将其添加到您的 shell 配置中以使其永久生效。

步骤 5：开始编码

claude

现在，每个提示都将从您的免费积分余额中扣除。无需订阅。

常见问题解答

Claude Code 安装需要多长时间？

安装通过 npm 需要 30-60 秒，前提是 Node.js 18+ 已安装。如果需要先安装 Node.js，则需要额外 5-10 分钟。使用 claude --version 验证安装是否成功。

安装 Claude Code 需要付费订阅吗？

不需要，安装是免费的。 您只需要付费的 Anthropic 订阅或 API 积分才能实际使用 Claude Code。通过 AI Perks 提供的价值 $1,000-$25,000+ 的免费积分可以完全消除成本。

我可以在多台机器上安装 Claude Code 吗？

是的，您可以随意在任意多台机器上安装。 安装本身是免费的。您的 Anthropic 帐户、API 密钥和积分会在多台机器上共享——从任何机器上的使用都计入同一个余额。

如何在服务器（CI/CD）上安装 Claude Code？

使用相同的 npm install 命令，然后通过环境变量（ANTHROPIC_API_KEY）进行配置。对于 CI/CD，将 API 密钥存储为秘密，并在管道执行期间注入。通过 AI Perks 提供的免费积分可以以 $0 的成本支持 CI/CD 的使用。

我可以在没有 Node.js 的情况下安装 Claude Code 吗？

不能，Claude Code 需要 Node.js 18+ 才能运行。Anthropic 官方不分发独立的二进制文件。如果需要，请使用 nvm 或您的操作系统包管理器安装 Node.js。

如何安装特定版本的 Claude Code？

使用版本标志进行安装：npm install -g @anthropic-ai/claude-code@1.2.0（替换为您想要的版本）。在 GitHub changelog 中查看可用版本。

安装 Claude Code 后会发生什么？

运行 claude --version 进行验证，然后运行 claude auth login（或设置 ANTHROPIC_API_KEY）。 从任何项目文件夹中运行 claude 即可启动。Claude 可以读取您的代码，建议更改并执行任务。通过 AI Perks 提供的免费积分，无限使用费用为 $0。

安装 Claude Code + 获取免费 Anthropic 积分

安装 Claude Code 需要 30 秒。免费驱动它需要订阅 AI Perks：

• $1,000-$25,000+ 的免费 Anthropic 积分
• 堆叠策略可实现超过 $50,000 的运行资金
• 除了 AI 积分外，还有 200+ 项额外的创业公司福利
• 为每个 Claude Code 版本更新的指南

在 getaiperks.com 订阅 →

在 30 秒内安装 Claude Code。在 getaiperks.com 免费驱动它。