Claude Code 安装与配置

本教程介绍 Windows、macOS、Linux 上的 Claude Code 安装方法，以及通过 RootFlowAI 配置 CLI、CC Switch 和 VS Code 扩展的步骤。Claude Code 使用 Anthropic Messages 协议，RootFlowAI 的接入地址填写 https://api.rootflowai.com。

安装与配置说明核对于 2026-09-19。客户端会持续更新，操作系统要求和安装方式以文末官方资料为准；模型与价格以模型价格页为准。

开始前准备

1. 在账户中心创建独立 API Key，详细步骤见获取 API Key。
2. 在模型价格页核对要用的 Claude 模型与分组。模型可见不代表所有工具、上下文长度和客户端功能都受支持。
3. 选择一种安装方式即可。原生安装无需先安装 Node.js；选择 npm 时，当前官方要求 Node.js 22 或更高版本。

安装 Claude Code

Windows

打开 PowerShell，执行官方安装命令：

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

安装后重新打开终端，执行 claude --version 检查版本。

当前原生 Windows 安装不要求管理员权限。Git for Windows用于提供 Git Bash，当前版本也可在未安装 Git Bash 时使用 PowerShell 工具。若旧版客户端提示必须安装 Git Bash，先核对版本和官方 Windows 说明。

项目位于 WSL 时，请在 WSL 终端中按 Linux 步骤安装、配置和运行，不要混用 Windows 与 WSL 的配置目录。

macOS

执行官方原生安装命令：

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

已有 Homebrew 时，也可以选择：

brew install --cask claude-code
claude --version

Linux

在项目所在的 Linux 环境执行：

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

安装命令需要 bash 和 curl。Alpine 等精简发行版还有额外依赖，请按官方安装说明核对。远程开发时，客户端装在哪里，接入配置就需要写到那个环境。

npm 安装（可选）

仅在选择 npm 方式时检查 Node.js；当前官方 npm 包从 v2.1.198 起要求 Node.js 22+。

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

遇到全局目录权限问题时，使用原生安装或按官方权限排查处理。不要用 sudo npm install -g 作为通用修复方式。

配置 RootFlowAI

Claude Code 的 Base URL 不加 /v1，客户端会请求 /v1/messages。Codex 和 OpenAI SDK 的地址规则不同，见API 接口参考。

Windows PowerShell

先在当前终端配置，替换示例中的占位密钥：

$env:ANTHROPIC_BASE_URL = "https://api.rootflowai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的RootFlowAI令牌"

macOS / Linux 终端

export ANTHROPIC_BASE_URL="https://api.rootflowai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的RootFlowAI令牌"

这些变量只作用于当前终端及其启动的程序。不要在截图或排查日志中输出密钥；需要长期保存时，使用下面的用户设置文件。

免费检查地址与模型列表

以下命令只查询模型列表，不发起模型推理。它读取的是当前终端变量，不会自动读取 Claude 的 JSON 设置文件。

macOS / Linux：

curl --fail-with-body --silent --show-error \
  "$ANTHROPIC_BASE_URL/v1/models" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"

Windows PowerShell：

Invoke-RestMethod -Method Get -Uri "$env:ANTHROPIC_BASE_URL/v1/models" `
  -Headers @{ Authorization = "Bearer $env:ANTHROPIC_AUTH_TOKEN" }

收到 JSON 列表后，核对模型 ID、令牌权限及分组。这个检查能帮助定位地址、认证和模型可见性问题，不能证明实际模型调用或工具调用一定成功。

启动并确认配置

从同一终端启动。下面模型名仅作示例，使用前请核对价格页和令牌权限：

claude --model claude-sonnet-4-6

运行 /status，检查 Anthropic base URL 是否为 RootFlowAI 地址，以及凭据来源是否为 ANTHROPIC_AUTH_TOKEN。确认后再发送一个小型任务；发送任务会产生模型调用费用。

使用价格页列出的完整模型 ID。sonnet、opus 等客户端别名可能随版本变化，不应假设网关一定支持其当前指向的模型，也不要依赖“未知模型自动转到其他模型”的行为。

保存到用户设置

CLI 配置验证后，可将变量合并进用户级文件：

• macOS / Linux：~/.claude/settings.json
• Windows：%USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.rootflowai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的RootFlowAI令牌"
  }
}

已有文件时只合并对应字段，保留原来的权限、插件和其他设置。不要把真实密钥写入项目中受 Git 跟踪的 .claude/settings.json。设置文件与终端变量重复配置时，检查实际生效的设置，并用 /status 核对。

CC Switch 配置

在 CC Switch 的 Claude Code 区域添加 Provider：

启用 Provider 后重新打开 Claude Code，并用 /status 检查。使用 CC Switch 管理配置时，先检查当前启用的 Provider，避免在多个地方保留不同地址或旧密钥。更多说明见CC Switch 接入教程。

VS Code / Cursor 扩展

从Claude Code 官方 VS Code 文档进入扩展安装说明；Cursor 中使用对应扩展时也应核对当前兼容要求。

打开编辑器的用户设置 JSON，合并以下配置。官方文档建议扩展在这里读取网关凭据，而不是只依赖从终端继承环境变量：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.rootflowai.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的RootFlowAI令牌" }
  ]
}

保存后重新打开扩展会话。使用 Remote SSH 或 WSL 时，确认扩展运行在哪个环境，并在相应环境配置。真实密钥不要放入受 Git 跟踪的工作区 .vscode/settings.json。

这里介绍的是 CLI 和编辑器扩展。Claude 桌面 App 有独立的第三方推理配置方式，不能直接套用这份扩展设置。

常见问题

密钥被撤销、泄露或主动轮换时，需要更新配置。普通充值与密钥轮换是不同操作，不要把“充值后换 Key”当作必要接入步骤。排查时先备份并定位冲突，无需一开始就清空聊天记录或 MCP 配置。

更多错误处理见Claude Code 常见问题排查，费用阅读见计费说明。

官方资料

• 安装与更新
• 连接 LLM 网关：认证变量、用户设置与扩展
• 模型选择与完整模型 ID