零成本用上ClaudeCode-硅基流动接入保姆级教程

m0_73827294

1374人浏览 · 2026-06-07 15:03:00

m0_73827294 · 2026-06-07 15:03:00 发布

# 零成本用上 Claude Code！硅基流动接入保姆级教程

适用环境： Windows 11 / CC-Switch v3.15.0+ / Claude Code v2.1.x
难度： ⭐⭐ (入门级)

📋 3 分钟快速上手

1️⃣ 注册硅基流动（30秒） → 2️⃣ 领取 API Key（1分钟） → 3️⃣ 配置 CC-Switch（2分钟） → 🎉 开始使用！

1. 架构概览

1.1 三者关系

┌──────────────┐      ┌─────────────────┐      ┌──────────────────┐
│  Claude Code  │─────▶│   CC-Switch     │─────▶│  硅基流动 API     │
│  (AI 编码助手) │      │  (本地代理网关)    │      │  (大模型服务平台)   │
└──────────────┘      └─────────────────┘      └──────────────────┘
                              │
                       127.0.0.1:15721
                       (本地 HTTP 代理)

组件	角色
Claude Code	Anthropic 官方 AI 编程 CLI 工具，通过环境变量读取 API 配置
CC-Switch	第三方多 Provider 管理工具，启动本地代理 (`127.0.0.1:15721`)，拦截并转发 AI 工具请求到指定 Provider
硅基流动 (SiliconFlow)	国内大模型聚合平台，提供 Anthropic Messages 兼容 API，可低成本调用多种大模型

1.2 为什么需要 CC-Switch？

无缝切换：Claude Code 原生只能连接 Anthropic 官方 API，CC-Switch 通过本地代理+环境变量注入让它可以连接任意兼容 Provider
可视化管理：GUI 界面管理多个 Provider（DeepSeek、硅基流动、Anthropic 官方等），一键切换
自动故障转移：支持主备 Provider 自动切换（enableFailoverToggle）
多工具统一：同时管理 Claude Code、Codex、Gemini CLI 等多个 AI 编码工具的 Provider 配置

2. 前置准备

2.1 已安装软件

安装 Claude Code

如果尚未安装，通过 npm 全局安装：

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

系统要求： 需要 Node.js 18+。安装后可通过 claude --version 验证。

安装 CC-Switch

从 GitHub Releases 下载最新版安装包：

下载地址： CC-Switch Releases
Windows 用户下载 .exe 安装包，macOS 用户下载 .dmg

安装完成后，确认运行正常：

# 检查 Claude Code
claude --version

# 检查 CC-Switch（查看系统托盘是否有 CC-Switch 图标）
# 或者查看进程
tasklist | findstr cc-switch

2.2 CC-Switch 关键配置

CC-Switch 的数据文件位置：

文件	路径	作用
主设置	`~/.cc-switch/settings.json`	应用行为（语言、开机启动、代理端口等）
Provider 数据库	`~/.cc-switch/cc-switch.db`	所有 Provider 配置（SQLite）
环境变量备份	`~/.cc-switch/backups/`	切换 Provider 时的环境变量快照

2.3 Claude Code 环境变量

Claude Code 通过以下环境变量感知 Provider 配置：

ANTHROPIC_AUTH_TOKEN     # API Key（x-api-key 认证方式）
ANTHROPIC_BASE_URL       # API 基础地址
ANTHROPIC_MODEL          # 默认模型
ANTHROPIC_DEFAULT_HAIKU_MODEL   # 快速模式模型
ANTHROPIC_DEFAULT_SONNET_MODEL  # 标准模式模型
ANTHROPIC_DEFAULT_OPUS_MODEL    # 深度模式模型

注意： CC-Switch 会自动管理这些环境变量，你通常不需要手动设置。

3. 硅基流动获取 API Key

3.1 注册并登录

nex-agi/Nex-N2-Pro 当前限免，新用户注册即送免费额度，实名认证还可领约 ¥14-16 代金券。

访问硅基流动官网（推荐链接）注册即可，注册即享限免模型 + 免费额度

进入官网，支持手机号或微信登录，30 秒完成注册
注册后即可使用免费额度和限免模型

3.2 创建 API Key

登录后进入控制台：API 密钥管理
点击「新建 API 密钥」
输入描述名称（如 ClaudeCode-CCSwitch），点击创建
立即复制保存

密钥格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3.3 模型广场（选模型参考）

访问模型广场查看所有可用模型，包括：

DeepSeek 系列、Qwen 系列、GLM 系列、Kimi 系列、Llama 系列等
每个模型页面标注了 API 端点格式（Chat Completions / Responses / Anthropic Messages）
注意：Claude Code 需要选择支持 Anthropic Messages 格式的模型

4. CC-Switch 配置硅基流动

4.1 打开 CC-Switch 管理界面

在系统托盘找到 CC-Switch 图标（蓝色/绿色 S 图标）
右键 →「显示主窗口」或双击图标
确保左侧 Claude 标签页被激活（高亮状态）

4.2 添加硅基流动 Provider

步骤一：点击添加按钮

在 Provider 列表区域，点击右上角的 「+」 按钮。

步骤二：填写 Provider 信息

在弹出的对话框中填写：

字段	填写内容	说明
Provider 名称	`硅基流动`	自定义，便于识别
API Key	`sk-你的密钥`	从硅基流动控制台复制
API Base URL	`https://api.siliconflow.cn`	不要加尾部斜杠
API 格式	`Anthropic Messages`	Claude Code 使用 Anthropic 原生协议

步骤三（可选）：设置默认模型映射

Claude Code 有三种工作模式，可分别映射到不同模型：

模式	Claude Code 内部名称	推荐映射（硅基流动）	适用场景
快速模式	Haiku	`deepseek-ai/DeepSeek-V3`	简单问答、代码补全
标准模式	Sonnet	`Pro/zai-org/GLM-4.7`	日常开发
深度模式	Opus	`Pro/zai-org/GLM-5`	复杂架构设计、大型重构

💡 提示： 如果不设置默认模型，每次启动 Claude Code 时需要手动指定 --model 参数。

填写示例：

在这里插入图片描述

步骤四：保存并激活

点击「添加」保存配置
在 Provider 列表中找到刚添加的「硅基流动」
点击选中它 → 该 Provider 变为当前激活状态（通常有高亮或对勾标识）

4.3 重启 Claude Code

Provider 切换后，需要重启 Claude Code 才能生效：

# 在 CC-Switch 中点击 Claude 的「重启」按钮
# 或手动操作：
# 1. 关闭所有 Claude Code 终端窗口
# 2. 重新打开终端，输入 claude

4.4 验证切换成功

启动 Claude Code 后，检查模型标识。正常情况下终端会显示类似：

Powered by Pro/zai-org/GLM-4.7 (via 硅基流动)

也可以在 Claude Code 中对话时，注意 lastModelUsage 字段会记录实际使用的模型名称。

5. 手动环境变量方式（可选）

如果你不想通过 CC-Switch GUI，也可以直接设置环境变量。CC-Switch 实际上就是在帮你管理这些变量。

5.1 设置系统环境变量（永久生效）

Windows：

# 以管理员身份运行 PowerShell
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.siliconflow.cn', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-你的密钥', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'Pro/zai-org/GLM-4.7', 'User')

macOS / Linux：

# 添加到 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_BASE_URL="https://api.siliconflow.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="Pro/zai-org/GLM-4.7"

5.2 项目级配置（仅当前项目生效）

⚠️ 安全警告： API Key 属于敏感凭据，切勿提交到 Git。请务必将 .claude/settings.local.json 加入项目的 .gitignore，避免密钥泄露。

在项目根目录创建 .claude/settings.local.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_MODEL": "Pro/zai-org/GLM-4.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-ai/DeepSeek-V3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "Pro/zai-org/GLM-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "Pro/zai-org/GLM-5"
  }
}

5.3 手动测试连通性

Windows PowerShell：

# 用 PowerShell 测试硅基流动 Anthropic 兼容端点
$body = @{
    model = "Pro/zai-org/GLM-4.7"
    max_tokens = 100
    messages = @(
        @{ role = "user"; content = "你好，请简单介绍一下你自己" }
    )
} | ConvertTo-Json

Invoke-RestMethod -Uri "https://api.siliconflow.cn/v1/messages" `
    -Method Post `
    -ContentType "application/json" `
    -Headers @{ Authorization = "Bearer sk-你的密钥" } `
    -Body $body

macOS / Linux (curl)：

# 直接用 curl 测试硅基流动 Anthropic 兼容端点
curl --request POST \
  --url https://api.siliconflow.cn/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "Pro/zai-org/GLM-4.7",
    "max_tokens": 100,
    "messages": [
      {"role": "user", "content": "你好，请简单介绍一下你自己"}
    ]
  }'

预期响应（200 OK）：

{
  "id": "msg_xxx",
  "model": "Pro/zai-org/GLM-4.7",
  "content": [{"type": "text", "text": "你好！我是..."}],
  "role": "assistant",
  "usage": {"input_tokens": ..., "output_tokens": ...}
}

6. 推荐模型列表

以下是硅基流动平台上在 Claude Code 中实测可用的模型（均支持 Anthropic Messages 格式）：

6.1 编程强项模型

模型 ID	特点	推荐模式	参考价格
`nex-agi/Nex-N2-Pro`	🔥 硅基流动限免模型，性能强劲	Sonnet（标准）	限时免费
`Pro/zai-org/GLM-4.7`	智谱最新旗舰，代码能力强	Sonnet（标准）	¥0.001/1K tokens
`Pro/zai-org/GLM-5`	智谱最强推理，适合复杂任务	Opus（深度）	¥0.002/1K tokens
`deepseek-ai/DeepSeek-V3`	DeepSeek 最新版，综合能力强	Sonnet（标准）	¥0.001/1K tokens
`deepseek-ai/DeepSeek-R1`	推理增强版，适合逻辑分析	Opus（深度）	¥0.004/1K tokens
`moonshotai/Kimi-K2-Instruct-0905`	Moonshot 出品，中英双语佳	Sonnet（标准）	¥0.001/1K tokens
`Qwen/Qwen2.5-Coder-7B-Instruct`	阿里通义千问代码专用模型	Haiku（快速）	¥0.0005/1K tokens

6.2 经济实惠方案

用途	模型	估计月花费
🔥 免费体验	`nex-agi/Nex-N2-Pro`（限免）	¥0
日常开发	`deepseek-ai/DeepSeek-V3`	¥15-30/月
轻量任务	`Qwen/Qwen2.5-Coder-7B-Instruct`	¥5-10/月
复杂任务	`Pro/zai-org/GLM-5`	¥30-60/月

⚠️ 温馨提示： 模型 ID 和价格以硅基流动模型广场实时展示为准，上表仅为撰写时的参考数据，可能随时间调整。

💡 省钱技巧：

使用 CC-Switch 的「默认模型映射」功能，让简单问答走便宜模型，复杂任务走强模型

硅基流动新用户送免费额度，先用后付

关注硅基流动的节假日优惠活动

7. 验证与调试

7.1 确认 CC-Switch 代理运行正常

# 检查端口 15721 是否被 CC-Switch 占用
netstat -ano | findstr 15721

预期输出（有 LISTENING 状态的条目）：

TCP    127.0.0.1:15721    0.0.0.0:0    LISTENING    <PID>

7.2 查看 CC-Switch 日志

# 查看最新日志
type "%USERPROFILE%\.cc-switch\logs\cc-switch.log"

正常日志应包含：

[SRV-001] 代理服务器启动于 127.0.0.1:15721

7.3 查看当前环境变量

# PowerShell - 查看 Anthropic 相关变量
Get-ChildItem Env: | Where-Object {$_.Name -like "*ANTHROPIC*"}

CC-Switch 管理的环境变量备份文件位于：

%USERPROFILE%\.cc-switch\backups\env-backup-*.json

7.4 Claude Code 内验证模型

在 Claude Code 对话中执行：

/model

会显示当前使用的模型名称。

在这里插入图片描述

7.5 检查 API 调用历史

打开 Claude Code 的 JSON 状态文件：

%USERPROFILE%\.claude.json

搜索 lastModelUsage，可以看到最近使用的模型和 Token 消耗。

8. 常见问题排查

8.1 Claude Code 启动后仍连接 Anthropic 官方

症状： 启动 Claude Code 后显示 Anthropic 官方模型，而非硅基流动的模型。

排查步骤：

确认 CC-Switch 中 Claude Provider 已正确切换
- 打开 CC-Switch 主窗口
- 确认「硅基流动」Provider 有高亮/选中状态

确认环境变量未被其他来源覆盖

# 检查系统环境变量（可能的冲突来源）
reg query "HKCU\Environment" /v ANTHROPIC_BASE_URL
reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v ANTHROPIC_BASE_URL

手动检查 Claude Code 读取的环境变量

# 查看 CC-Switch 的环境备份
type "%USERPROFILE%\.cc-switch\backups\env-backup-*.json"

重启 CC-Switch 和 Claude Code
- 从系统托盘退出 CC-Switch
- 重新启动 CC-Switch
- 重新启动 Claude Code

8.2 返回 401 Unauthorized 错误

原因： API Key 无效或未正确设置。

解决：

确认 API Key 完整复制（以 sk- 开头）
在硅基流动控制台确认密钥状态是否「已启用」
账户是否欠费（余额不足）
在 CC-Switch 中重新输入 API Key

8.3 返回 404 Not Found 或模型不可用

原因： 模型名称填写错误或该模型不支持 Anthropic Messages 格式。

解决：

在硅基流动模型广场确认模型 ID 拼写
确认该模型标注了「支持 Anthropic Messages 格式」
尝试使用 Pro/zai-org/GLM-4.7 测试（已确认支持）

8.4 返回超时错误

解决方案：

在 .claude/settings.local.json 中增加超时时间：

{
  "env": {
    "API_TIMEOUT_MS": "180000"
  }
}

检查网络代理/VPN 是否干扰连接

测试直连：

curl -o /dev/null -s -w "Connect: %{time_connect}s\nTotal: %{time_total}s\n" https://api.siliconflow.cn/v1/messages

8.5 CC-Switch 托盘图标消失或界面打不开

解决：

# 杀掉 CC-Switch 进程并重启
taskkill /f /im cc-switch.exe
# 然后从开始菜单重新启动 CC-Switch

9. 附录：多 Provider 切换技巧

9.1 场景化切换策略

CC-Switch 支持为不同 AI 工具独立配置 Provider：

场景	Claude Code Provider	Codex Provider
低成本日常开发	硅基流动 (DeepSeek-V3)	硅基流动
高难度架构设计	Anthropic 官方 (Opus)	不适用
紧急故障修复	Anthropic 官方 (Sonnet)	Anthropic 官方
试验新模型	硅基流动 (任意模型)	硅基流动

9.2 开启自动故障转移

在 CC-Switch 设置中启用 enableFailoverToggle，可以实现：

主 Provider 不可用时自动切到备用 Provider
主 Provider 恢复后自动切回

9.3 Provider 数据库备份

CC-Switch 的 Provider 配置存储在 SQLite 数据库中，建议定期备份：

# 备份 CC-Switch 数据库
copy "%USERPROFILE%\.cc-switch\cc-switch.db" "%USERPROFILE%\.cc-switch\backups\cc-switch-manual-backup-%DATE:/=-%.db"

9.4 快速切换命令（高级）

如果你习惯命令行操作，可以通过修改环境变量备份文件实现快速切换：

# 切换到硅基流动（PowerShell）
$env:ANTHROPIC_BASE_URL="https://api.siliconflow.cn"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的硅基流动Key"
$env:ANTHROPIC_MODEL="Pro/zai-org/GLM-4.7"

# 切换到 DeepSeek
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeekKey"
$env:ANTHROPIC_MODEL="deepseek-v4-pro"

注意： 命令行方式仅影响当前终端会话，关闭终端后失效。如需永久切换请使用 CC-Switch GUI。

参考链接

资源	URL
CC-Switch GitHub	https://github.com/farion1231/cc-switch
CC-Switch 使用文档	https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/zh
硅基流动官网	https://cloud.siliconflow.cn/i/fSpqKYJM（推荐注册）
硅基流动 Claude Code 集成指南	https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-ClaudeCode
Claude Code 官方文档	https://docs.anthropic.com/en/docs/claude-code

📝 文档说明： 本文档基于 Windows 11 + CC-Switch v3.15.0 + Claude Code v2.1.x 编写。不同版本界面和操作可能存在差异，请以实际版本为准。

亚马逊云科技技术品牌专区

更多推荐

聊聊KES时序库超表架构：分片这事儿，到底怎么就变简单了

亚马逊云科技技术品牌专区

Doctave 实时预览开发流：Live Reload 让文档写作效率翻倍的秘密

你是否曾经写完一段 Markdown 文档，还要手动切换终端、重新构建、再刷新浏览器才能看到效果？**Doctave** 是一款开箱即用的文档站点生成器，它内置的 **Live Reload 实时预览**功能，让你在保存文件的瞬间，浏览器就自动刷新并展示最新内容，彻底告别"改代码—构建—刷新"的循环。今天我们就来揭开 Doctave 实时预览开发流的秘密，看看它是如何让文档写作效率翻倍的。[!

亚马逊云科技技术品牌专区

免费开源视频超分辨率工具 Video2X：一个命令让模糊老视频快速变身4K高清

三年前的家庭录像，如今在 4K 电视上糊成一团，放大后的每一个像素都在提醒你"它已经过时了"。**Video2X** 就是为这种时刻准备的——一个机器学习驱动的**视频超分辨率与帧插值框架**，2018 年诞生于 Hack the Valley II 黑客马拉松，2025 年已迭代到 6.4.0，能在一台普通电脑上把 480p 老视频逐帧重建出清晰细节，全程不向磁盘写一张中间帧。## 先用 3

亚马逊云科技技术品牌专区

所有评论(0)

查看更多评论

m0_73827294

@m0_73827294

已为社区贡献4条内容

零成本用上ClaudeCode-硅基流动接入保姆级教程

m0_73827294

📋 3 分钟快速上手

目录

1. 架构概览

1.1 三者关系

1.2 为什么需要 CC-Switch？

2. 前置准备

2.1 已安装软件

安装 Claude Code

安装 CC-Switch

2.2 CC-Switch 关键配置

2.3 Claude Code 环境变量

3. 硅基流动获取 API Key

3.1 注册并登录

3.2 创建 API Key

3.3 模型广场（选模型参考）

4. CC-Switch 配置硅基流动

4.1 打开 CC-Switch 管理界面

4.2 添加硅基流动 Provider

步骤一：点击添加按钮

步骤二：填写 Provider 信息

步骤三（可选）：设置默认模型映射

步骤四：保存并激活

4.3 重启 Claude Code

4.4 验证切换成功

5. 手动环境变量方式（可选）

5.1 设置系统环境变量（永久生效）

5.2 项目级配置（仅当前项目生效）

5.3 手动测试连通性

6. 推荐模型列表

6.1 编程强项模型

6.2 经济实惠方案

7. 验证与调试

7.1 确认 CC-Switch 代理运行正常

7.2 查看 CC-Switch 日志

7.3 查看当前环境变量

7.4 Claude Code 内验证模型

7.5 检查 API 调用历史

8. 常见问题排查

8.1 Claude Code 启动后仍连接 Anthropic 官方

8.2 返回 401 Unauthorized 错误

8.3 返回 404 Not Found 或模型不可用

8.4 返回超时错误

8.5 CC-Switch 托盘图标消失或界面打不开

9. 附录：多 Provider 切换技巧

9.1 场景化切换策略

9.2 开启自动故障转移

9.3 Provider 数据库备份

9.4 快速切换命令（高级）

参考链接

所有评论(0)

温馨提示：您尚未绑定手机号

m0_73827294