Claude Code 安装与配置完整指南

一、安装 Claude Code

Claude Code 提供两种安装方式：官方一键安装 和 npm 手动安装。国内用户由于网络原因和官方封禁，推荐手动安装。

方式一：手动安装（国内推荐）

打开终端，根据平台输入安装命令。

macOS

安装 Claude Code

macOS 可通过 Homebrew 直接安装，无需手动安装 Node.js 环境：

1
brew install --cask claude-code

没有 Homebrew？先执行：

国内镜像安装（推荐）

1
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

官方安装脚本：

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证安装
1
claude --version

Windows

方式一：通过 winget 安装（推荐）

Windows 用户可以通过 winget 直接安装 Claude Code，无需手动安装 Node.js 环境：

1
winget install Anthropic.ClaudeCode

验证安装：

1
claude --version

方式二：通过 npm 安装

安装 Node.js
使用 winget（推荐）：
1
winget install OpenJS.NodeJS.LTS
或从 Node.js 官网下载 LTS 安装包手动安装。

安装 Claude Code

打开 PowerShell 或 CMD，执行：

1
2
3
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
npm config set registry https://registry.npmjs.org

验证安装
1
claude --version

提示： 推荐安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows，Claude Code 将使用 PowerShell 作为 Shell 工具。

Linux / WSL

安装 Node.js

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

安装 Claude Code

1
2
3
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code
npm config set registry https://registry.npmjs.org

验证安装
1
claude --version

要求： Node.js 版本需为 v18.x 或更高。可通过 node --version 和 npm --version 查看版本号。

方式二：官方一键安装

Anthropic 官方提供了一键安装脚本，无需手动安装 Node.js 环境，脚本会自动处理所有依赖。

注意： 此方式需要能直接访问 claude.ai，国内网络可能无法正常使用。

macOS / Linux / WSL

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

Windows (PowerShell)

1
irm https://claude.ai/install.ps1 | iex

Windows (CMD)

1
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

常见问题

看到 The token '&&' is not a valid statement separator 报错？ 说明你当前在 PowerShell 环境中，而不是 CMD。请使用上面的 PowerShell 命令。
看到 'irm' is not recognized as an internal or external command 报错？ 说明你当前在 CMD 环境中，而不是 PowerShell。请使用上面的 CMD 命令。
如何区分 PowerShell 和 CMD？ 观察命令提示符：PowerShell 显示 PS C:\，CMD 显示 C:\（没有 PS 前缀）。
如果 PowerShell 提示脚本执行被禁止，运行以下命令修改执行策略：

1
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

提示： 在 Windows 上推荐安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具。如果未安装 Git for Windows，Claude Code 将使用 PowerShell 作为 Shell 工具。WSL 环境无需安装 Git for Windows。

二、配置 Claude Code

国内用户无法直接访问 Anthropic 官方 API，需要通过 API 中转站使用。

以下以 suirenai.com API 中转站为例（使用我的链接注册可享福利额度 https://suirenai.com/register?aff=S6SYX97JQ399），配置前请先前往该站注册账号并获取 API Key（格式为 sk-xxx）。

方式一：使用 cc-switch 配置（推荐）

如果您使用 cc-switch 工具，可以快速切换不同的 API 配置。

打开 cc-switch，选择「添加新供应商」
填入供应商名称（如 suirenai）
填入请求地址：https://api.suirenai.com
填入 API Key：sk-xxx（替换为你的实际密钥）
保存后选择该供应商即可切换生效

详细使用方法请参考 cc-switch 文档。

方式二：通过 settings.json 配置

打开配置目录

Windows：

按下 Win + R 键
输入以下内容后回车：

1
%userprofile%\.claude

macOS/Linux：

1
cd ~/.claude

编辑 settings.json

创建或编辑 ~/.claude/settings.json 文件：

1
2
3
4
5
6
7
8
{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.suirenai.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

将 sk-your-api-key 替换为你创建的密钥。

配置说明：

hasCompletedOnboarding: 跳过首次启动引导
ANTHROPIC_AUTH_TOKEN: API 密钥，替换为你在中转站获取的 Key
ANTHROPIC_BASE_URL: API 端点地址，指向中转站的 API 地址
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 禁用非必要网络请求（避免 Claude Code 尝试连接官方服务器导致报错或卡顿）

方式三：通过系统环境变量配置

将 sk-your-api-key 替换为你创建的密钥。

macOS：

1
2
3
echo 'export ANTHROPIC_BASE_URL="https://api.suirenai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"' >> ~/.zshrc
source ~/.zshrc

Windows：

1
2
setx ANTHROPIC_BASE_URL "https://api.suirenai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-your-api-key"

Linux/WSL：

1
2
3
echo 'export ANTHROPIC_BASE_URL="https://api.suirenai.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"' >> ~/.bashrc
source ~/.bashrc

启动 Claude Code

1
claude

三、总结

本文介绍了 Claude Code 在 macOS、Windows、Linux/WSL 三大平台上的安装方法，以及国内用户通过 API 中转站使用 Claude Code 的配置方案。

安装完成后，你可以在终端中直接使用 claude 命令启动，享受 AI 辅助编程带来的效率提升。