Claude Code 安装与配置完整教程

Claude Code 安装与配置完整教程

Claude Code 是 Anthropic 官方推出的 CLI 编程助手，可在终端中直接与 Claude 对话，辅助编写代码、调试问题、管理项目。通过 RootFlow AI 中转服务，你可以更便捷地使用 Claude Code。

本教程覆盖 Windows、macOS、Linux 三大平台的完整安装配置流程，以及 CC Switch、VSCode/Cursor 插件的接入方式。

前提条件

• 已注册 RootFlow AI 并获取 API Key（获取方式）
• 确保网络环境正常
• Node.js 版本 ≥ 18.0（部分安装方式不需要 Node.js）

Windows

1. 安装 Node.js

Claude Code 依赖 Node.js 运行环境。先检查是否已安装：

node -v
npm -v

如果能正常输出版本号，说明已安装，可跳到下一步。

方法一：官网下载（推荐）

1. 访问 https://nodejs.org/ 2. 下载 LTS 版本（长期支持版） 3. 双击 .msi 文件，按安装向导完成安装，保持默认设置即可

方法二：使用包管理器

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

安装完成后，重新打开 PowerShell 验证：

node --version
npm --version

如果 npm -v 报错提示"禁止运行脚本"，执行以下命令解决：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

选择 Y 确认，然后重试。

2. 安装 Claude Code

方法一：PowerShell 官方脚本

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

方法二：npm 全局安装

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

如果下载速度较慢，可以切换为淘宝镜像源（详见 NPM 中国加速配置）：

npm config set registry https://registry.npmmirror.com

验证安装：

claude --version

显示版本号即安装成功。

3. 安装 Git 环境

Claude Code 在 Windows 上需要 Git Bash 环境。如果启动时提示：

Claude Code on Windows requires git-bash

请下载安装 Git for Windows，安装时保持默认选项即可。安装完成后重新打开 PowerShell。

4. 配置环境变量 {#windows-env}

为了让 Claude Code 连接到 RootFlow AI 中转服务，需要设置两个环境变量。

方法一：PowerShell 永久设置（推荐）

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.rootflowai.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

方法二：系统环境变量界面

1. 打开"系统属性" → "环境变量" 2. 在"用户变量"中新建两个变量：

| 变量名 | 变量值 | |--------|--------| | ANTHROPIC_BASE_URL | https://api.rootflowai.com | | ANTHROPIC_AUTH_TOKEN | 你的 API 密钥 |

3. 点击"确定"保存

变量名和变量值中不要包含多余的空格。

5. 更换密钥

续费或更换套餐后，需要更新密钥：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "新的API密钥", [System.EnvironmentVariableTarget]::User)

更换后需要重新打开终端或 IDE 才能生效。

6. 启动使用

claude

首次启动会有几个确认提示，一路回车即可。出现对话界面后，试着提问验证是否正常工作。

macOS

1. 安装 Node.js

方法一：使用 Homebrew（推荐）

brew update
brew install node

方法二：官网下载

访问 https://nodejs.org/，下载 macOS LTS 版本，打开 .pkg 文件按指引安装。

• 如果遇到权限问题，可能需要使用 sudo
• 首次运行可能需要在"系统设置"中允许

验证安装：

node --version
npm --version

2. 安装 Claude Code

方法一：Homebrew 安装（推荐）

brew install --cask claude-code

方法二：官方脚本安装

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

方法三：npm 全局安装

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

如果遇到权限问题：

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

npm config set registry https://registry.npmmirror.com

详见 NPM 中国加速配置。

验证：

claude --version

3. 配置环境变量

对于 zsh（macOS 默认）

echo 'export ANTHROPIC_BASE_URL="https://api.rootflowai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

在终端中输入 echo $SHELL，如果返回 /bin/zsh 就是 zsh 环境。

对于 bash

echo 'export ANTHROPIC_BASE_URL="https://api.rootflowai.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

4. 更换密钥

编辑 shell 配置文件，修改 ANTHROPIC_AUTH_TOKEN 的值：

vim ~/.zshrc

修改后保存，然后执行：

source ~/.zshrc

或者直接追加新值（后面的配置会覆盖前面的）：

echo 'export ANTHROPIC_AUTH_TOKEN="新的API密钥"' >> ~/.zshrc
source ~/.zshrc

更换后需要重新打开终端或 IDE 才能生效。

Linux

1. 安装 Node.js

方法一：NodeSource 仓库（推荐）

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

方法二：系统包管理器

Ubuntu / Debian：

sudo apt update
sudo apt install nodejs npm

CentOS / RHEL / Fedora：

sudo dnf install nodejs npm

• 某些发行版可能需要安装额外依赖
• 确保用户对 npm 全局目录有写权限

验证：

node --version
npm --version

2. 安装 Claude Code

方法一：官方脚本安装（推荐）

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

方法二：Homebrew 安装

brew install --cask claude-code

方法三：npm 全局安装

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

如果遇到权限问题：

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

验证：

claude --version

3. 配置环境变量

Bash 用户

echo 'export ANTHROPIC_BASE_URL="https://api.rootflowai.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

Zsh 用户

echo 'export ANTHROPIC_BASE_URL="https://api.rootflowai.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

4. 验证

claude

Claude Code 成功启动并能正常对话，说明配置完成。

CC Switch 配置

如果你使用 CC Switch 工具，按以下参数配置：

| 配置项 | 值 | |--------|-----| | 请求地址 | https://api.rootflowai.com | | API Key | 你的 RootFlow AI 令牌（sk- 开头） |

支持的模型：

• claude-sonnet-4-6
• claude-haiku-4-5-20251001
• claude-opus-4-6

不要手动定义其他模型名称，未列出的模型会默认路由到 claude-opus-4-6。

卸载旧版 CLI（可选）

如果你之前安装过其他中转站的 Claude Code CLI，建议先卸载再重新安装，避免配置冲突。

检查安装位置

# 检查本地项目中是否安装
npm ls @anthropic-ai/claude-code

# 检查全局安装
npm ls -g @anthropic-ai/claude-code

执行卸载

# 卸载本地安装
npm uninstall @anthropic-ai/claude-code

# 卸载全局安装
npm uninstall -g @anthropic-ai/claude-code

卸载完成后，按上方教程重新安装即可。

清理缓存和配置

Claude Code 在使用过程中会在本地生成缓存、日志和临时文件。如果遇到异常问题，或切换中转站后配置不生效，可以尝试清理。

Windows

在 C:\Users\你的用户名\ 目录下找到 .claude 目录和 .claude.json 文件，将它们重命名备份：

.claude       → .claude-backup
.claude.json  → .claude.json-backup

macOS / Linux

清理会话记录（保留核心配置）：

mv ~/.claude/projects ~/.claude/projects-$(date +%Y%m%d%H%M%S)
mv ~/.claude/shell-snapshots ~/.claude/shell-snapshots-$(date +%Y%m%d%H%M%S)
mv ~/.claude/statsig ~/.claude/statsig-$(date +%Y%m%d%H%M%S)
mv ~/.claude/todos ~/.claude/todos-$(date +%Y%m%d%H%M%S)

彻底清理（移除所有配置和记录）：

mv ~/.claude ~/.claude-$(date +%Y%m%d%H%M%S)
mv ~/.claude.json ~/.claude.json-$(date +%Y%m%d%H%M%S)

彻底清理会移除所有聊天记录和 MCP 配置。清理前请确保 Claude Code 已完全退出。

VSCode / Cursor 插件使用

前提条件

使用 VSCode 插件前，必须先完成上述环境变量配置（根据你的操作系统选择对应方案）。配置完成后务必重启 VSCode/Cursor。

安装步骤

1. 在 VSCode 扩展商店搜索 Claude Code for VSCode 2. 安装插件 3. 重启 VSCode 4. 点击右上角的 Claude Code 图标即可使用

SSH 远程开发配置

如果你通过 VSCode Remote SSH 连接远程服务器，插件可能无法自动读取本地环境变量。需要手动配置：

1. 打开 VSCode 设置（Ctrl + , 或 Cmd + ,） 2. 搜索 Claude Code，找到扩展设置 3. 点击"在 settings.json 中编辑" 4. 添加以下配置：

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://api.rootflowai.com"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "你的API密钥"
    }
  ]
}

保存后重新打开 Claude Code 面板即可。

第三方连接点无法登录的解决方案

如果在 VSCode 或 Cursor 中使用第三方连接点时遇到登录问题，可以通过创建 Claude 配置文件解决：

创建或编辑 ~/.claude/config.json：

{
  "primaryApiKey": "你的API密钥"
}

保存后重启 VSCode / Cursor 即可。这种方式会跳过 OAuth 登录流程，直接使用你的 API Key 进行认证。

遇到问题？查看 常见问题排查 或加入用户群获取帮助。