Win10 安装 Claude Code 全指南：从零到跑起来，一篇搞定

用硅基流动 SiliconFlow 接入国产大模型，CC Switch 一键切换，无需翻墙，零基础可上手

---

在这个 AI 编程工具百花齐放的时代，Claude Code 作为 Anthropic 官方推出的终端 AI 编程助手，凭借极强的代码理解和项目重构能力，正在成为开发者手中的效率利器。

但对国内开发者来说，“网络不通”“账号难搞”“价格太贵” 三座大山挡在面前。

今天这篇文章，手把手带你用 硅基流动（SiliconFlow）+ CC Switch 的方案，在 Windows 10 上从零搭建 Claude Code 开发环境。

全程无需翻墙，无需国外账号，新用户还能白嫖 16元 认证奖励，可兑换百万token。

---

一、整体流程：5步走完

先看全貌，心里有数：

注册 SiliconFlow 拿 Key → 装 Node.js 和 Git → 装 Claude Code → 装 CC Switch → 配置接入 → 开用

下面逐步展开。

---

二、前置准备：装好两个基础软件

在安装 Claude Code 之前，需要先确保系统上有 Node.js 和 Git。

1. Node.js（必须安装）

Claude Code 通过 npm 安装，Node.js 是前置依赖。

安装方法：

1. 访问 https://nodejs.org ，下载 LTS 版本（推荐 v20.x 或 v22.x）
2. 双击 .msi 安装包，按向导完成安装
3. 打开 PowerShell 验证：

node --version
npm --version

分别输出版本号即安装成功。

常见问题： 如果命令无法识别，关闭终端重新打开，或手动将 C:\Program Files\nodejs 添加到系统 PATH 环境变量。

2. Git for Windows（推荐安装）

Claude Code 和 CC Switch 的部分功能依赖 Git。

安装方法：

1. 访问 https://git-scm.com/download/win ，下载安装
2. 默认选项一路 Next 即可
3. 验证：git --version

---

三、第一步：注册硅基流动，获取 API Key

硅基流动（SiliconFlow） 是国内领先的大模型服务平台，提供百余种开源模型 API，按量付费、开箱即用。

最关键的是：不需要翻墙，新用户注册即送 50 万 token 免费额度。

3.1 注册账号

1. 打开 https://cloud.siliconflow.cn/i/tZzHiRPs
2. 点击右上角「注册」
3. 手机号注册最快, 注册后需要实名认证

3.2 创建 API Key

1. 实名认证后进入「控制台」（Dashboard）
2. 左侧菜单选择「API Keys」
3. 点击「创建新密钥」
4. 复制并保存你的 API Key

API Key 格式为：sf-xxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 重要提醒： API Key 一旦创建请立即保存，关闭弹窗后无法再次查看完整 Key。务必妥善保管，不要泄露或上传到公开仓库。

3.3 关于额度与计费

项目	说明
免费额度	新用户赠送 50 万 token
额度重置	每月 1 日重置免费额度
实名认证	完成后可提升免费额度上限
充值方式	登录官网 → 个人中心 → 充值（按量付费，价格极低）
参考价格	DeepSeek-V3 约 ¥1/百万 token

3.4 选择模型

访问硅基流动模型广场 https://siliconflow.cn/models ，浏览可用模型。

Claude Code 常用推荐模型如下：

模型名称	特点	适合场景
moonshotai/Kimi-K2-Instruct-0905	默认推荐模型，综合能力强	通用编程
deepseek-ai/DeepSeek-V3	性价比极高	预算有限场景
Qwen/Qwen3-235B-A22B	中文能力突出	中文编程
THUDM/GLM-4-32B-0414	代码生成优秀	代码补全与生成

后面在 CC Switch 中配置时会用到模型名称，可先从模型广场复制备用。

---

四、第二步：安装 Claude Code

提供两种安装方式，任选其一。

方式 A：原生安装器（推荐）

这是最简单的方式，一行命令搞定。

以 管理员身份 打开 PowerShell，执行：

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

安装完成后，关闭当前终端，重新打开一个新终端，输入：

claude --version

输出版本号，即安装成功。

方式 B：npm 全局安装

打开 PowerShell 或 CMD，执行：

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

如果下载速度慢（国内网络常见问题），先切换镜像源：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

同样用 claude --version 验证安装。

安装后常见问题

问题 1：claude 命令无法识别

这是 PATH 未生效导致的。运行以下命令查看 npm 全局安装路径：

npm config get prefix

将输出的路径（如 C:\Users\你的用户名\AppData\Roaming\npm）添加到系统 PATH 环境变量，然后重启终端。

问题 2：权限不足（EACCES）

切勿使用管理员权限或 sudo 安装 npm 包。正确做法是修改 npm 全局目录：

npm config set prefix "$env:APPDATA\npm"

然后将 %APPDATA%\npm 添加到系统 PATH。

---

五、第三步：安装 CC Switch

CC Switch 是专为 Claude Code 打造的供应商/模型一键切换工具，内置 50+ 供应商预设，图形界面操作，无需手动编辑环境变量。

简单说，它帮你把手动改配置这件事，变成了点一下按钮。

5.1 下载安装

方式一：Winget 安装（推荐）

winget install --id=farion1231.CC-Switch -e

方式二：手动下载

1. 访问 https://github.com/farion1231/cc-switch/releases
2. 找到最新版本（当前 v3.14.1）
3. 下载 CC-Switch-v3.x.x-Windows.msi
4. 双击 .msi 文件，按向导完成安装

5.2 首次启动

安装完成后，从开始菜单或桌面快捷方式启动 CC Switch。启动后会常驻在系统托盘（右下角任务栏），点击托盘图标即可打开主界面。

5.3 核心功能一览

功能	说明
供应商切换	一键切换 AI 服务商，无需手动改环境变量
多供应商管理	支持添加多个供应商配置，拖拽排序
热切换	切换后无需重启 Claude Code，新对话立即生效
多工具支持	同时管理 Claude Code / Codex / Gemini CLI
云同步	可选 Dropbox / OneDrive / WebDAV 同步配置

---

六、第四步：CC Switch 配置 SiliconFlow 接入

这一步是整个流程的关键，但操作很简单。

6.1 打开配置界面

1. 右键点击系统托盘中的 CC Switch 图标
2. 选择「Open」打开主界面
3. 在左侧选择「Claude Code」

6.2 添加 SiliconFlow 供应商

1. 点击右上角「+ 添加 Provider」
2. 填写以下配置：

字段	填写内容
名称	SiliconFlow（自定义即可）
API Base URL	https://api.siliconflow.cn/
API Key	粘贴你的 SiliconFlow API Key（sf-xxx...）
模型	输入模型名称，如 moonshotai/Kimi-K2-Instruct-0905

3. 点击「Save」保存

6.3 激活供应商

1. 在 Provider 列表中找到刚添加的 SiliconFlow
2. 点击「Switch」激活

CC Switch 会自动将 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_MODEL 等环境变量写入系统，你不需要手动操作任何配置文件。

---

七、第五步：验证连接，开始使用

7.1 启动 Claude Code

1. 打开一个新的终端窗口（这一步很重要，新终端才能读取到 CC Switch 设置的环境变量）
2. 进入你的项目目录：

cd C:\Users\你的用户名\projects\my-project

3. 启动 Claude Code：

claude

7.2 验证是否接入成功

在 Claude Code 交互界面中，输入一个简单问题：

> 你好，请介绍一下你自己

如果收到正常的 AI 回复，恭喜你——SiliconFlow 接入成功！

7.3 日常使用命令

命令	用途
claude	启动交互式对话
claude "你的问题"	单次提问模式
claude --version	查看版本号
/help	交互模式中查看帮助
/model	查看当前使用的模型
/clear	清除对话历史
Ctrl+C	退出 Claude Code

7.4 切换模型

想换模型？打开 CC Switch，修改 Provider 的模型名称或切换到另一个 Provider，回到 Claude Code 新开对话即可。

---

八、常见问题排查

汇总了大家最容易遇到的 7 个问题，按需查阅：

Q1：Claude Code 报错 “API Key is invalid”

• 确认 Key 以 sf- 开头，且复制完整
• 登录 SiliconFlow 控制台确认 Key 状态为启用
• 确认免费额度未用完
• 在 CC Switch 中重新粘贴 Key 并保存

Q2：报错 “Connection refused” 或 “Network error”

• 确认网络可正常访问 https://api.siliconflow.cn/
• 检查是否有代理或 VPN 干扰国内网络请求
• 终端中执行 ping api.siliconflow.cn 测试连通性

Q3：CC Switch 切换后 Claude Code 仍用旧配置

• 完全关闭 Claude Code 终端
• 重新打开新终端窗口
• 再次启动 claude

Q4：npm 安装下载极慢

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

Q5：claude 命令提示"不是内部或外部命令"

• 确认 Node.js 和 npm 已正确安装
• 运行 npm config get prefix 查看全局路径
• 将输出路径添加到系统 PATH，重启终端

Q6：免费额度用完了怎么办

• 登录 SiliconFlow 官网 → 个人中心 → 充值
• 按量付费，价格极低

Q7：想同时用多个模型怎么办

• Claude Code 本身不支持同时配置多个自定义模型
• 但可通过 CC Switch 一键切换不同供应商/模型
• 切换后重启 Claude Code 即生效

---

九、附录：手动配置环境变量

如果你不想使用 CC Switch，也可以手动设置环境变量。

临时生效（关闭终端后失效）：

$env:ANTHROPIC_BASE_URL = "https://api.siliconflow.cn/"
$env:ANTHROPIC_API_KEY = "sf-你的APIKey"
$env:ANTHROPIC_MODEL = "moonshotai/Kimi-K2-Instruct-0905"
claude

永久生效（写入用户级环境变量）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.siliconflow.cn/", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sf-你的APIKey", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "moonshotai/Kimi-K2-Instruct-0905", "User")

设置永久环境变量后，需重新打开终端才能生效。

---

参考链接

资源	地址
硅基流动官网	https://siliconflow.cn
硅基流动模型广场	https://siliconflow.cn/models
硅基流动 Claude Code 文档	https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-ClaudeCode
CC Switch GitHub	https://github.com/farion1231/cc-switch
CC Switch 下载页	https://github.com/farion1231/cc-switch/releases
Claude Code 官方文档	https://docs.anthropic.com/en/docs/claude-code
Node.js 下载	https://nodejs.org
Git for Windows	https://git-scm.com/download/win

---