# 零成本用上 Claude Code硅基流动接入保姆级教程适用环境Windows 11 / CC-Switch v3.15.0 / Claude Code v2.1.x难度⭐⭐ (入门级) 3 分钟快速上手1️⃣ 注册硅基流动30秒 → 2️⃣ 领取 API Key1分钟 → 3️⃣ 配置 CC-Switch2分钟 → 开始使用目录架构概览前置准备硅基流动获取 API KeyCC-Switch 配置硅基流动手动环境变量方式可选推荐模型列表验证与调试常见问题排查附录多 Provider 切换技巧1. 架构概览1.1 三者关系┌──────────────┐ ┌─────────────────┐ ┌──────────────────┐ │ Claude Code │─────▶│ CC-Switch │─────▶│ 硅基流动 API │ │ (AI 编码助手) │ │ (本地代理网关) │ │ (大模型服务平台) │ └──────────────┘ └─────────────────┘ └──────────────────┘ │ 127.0.0.1:15721 (本地 HTTP 代理)组件角色Claude CodeAnthropic 官方 AI 编程 CLI 工具通过环境变量读取 API 配置CC-Switch第三方多 Provider 管理工具启动本地代理 (127.0.0.1:15721)拦截并转发 AI 工具请求到指定 Provider硅基流动 (SiliconFlow)国内大模型聚合平台提供 Anthropic Messages 兼容 API可低成本调用多种大模型1.2 为什么需要 CC-Switch无缝切换Claude Code 原生只能连接 Anthropic 官方 APICC-Switch 通过本地代理环境变量注入让它可以连接任意兼容 Provider可视化管理GUI 界面管理多个 ProviderDeepSeek、硅基流动、Anthropic 官方等一键切换自动故障转移支持主备 Provider 自动切换enableFailoverToggle多工具统一同时管理 Claude Code、Codex、Gemini CLI 等多个 AI 编码工具的 Provider 配置2. 前置准备2.1 已安装软件安装 Claude Code如果尚未安装通过 npm 全局安装npminstall-ganthropic-ai/claude-code系统要求需要 Node.js 18。安装后可通过claude --version验证。安装 CC-Switch从 GitHub Releases 下载最新版安装包下载地址CC-Switch ReleasesWindows 用户下载.exe安装包macOS 用户下载.dmg安装完成后确认运行正常# 检查 Claude Codeclaude--version# 检查 CC-Switch查看系统托盘是否有 CC-Switch 图标# 或者查看进程tasklist|findstr cc-switch2.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 Keyx-api-key 认证方式ANTHROPIC_BASE_URL# API 基础地址ANTHROPIC_MODEL# 默认模型ANTHROPIC_DEFAULT_HAIKU_MODEL# 快速模式模型ANTHROPIC_DEFAULT_SONNET_MODEL# 标准模式模型ANTHROPIC_DEFAULT_OPUS_MODEL# 深度模式模型注意CC-Switch 会自动管理这些环境变量你通常不需要手动设置。3. 硅基流动获取 API Key3.1 注册并登录nex-agi/Nex-N2-Pro当前限免新用户注册即送免费额度实名认证还可领约 ¥14-16 代金券。访问 硅基流动官网推荐链接 注册即可注册即享限免模型 免费额度进入官网支持手机号或微信登录30 秒完成注册注册后即可使用免费额度和限免模型3.2 创建 API Key登录后进入控制台API 密钥管理点击「新建 API 密钥」输入描述名称如ClaudeCode-CCSwitch点击创建立即复制保存密钥格式sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3.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 Keysk-你的密钥从硅基流动控制台复制API Base URLhttps://api.siliconflow.cn不要加尾部斜杠API 格式Anthropic MessagesClaude Code 使用 Anthropic 原生协议步骤三可选设置默认模型映射Claude Code 有三种工作模式可分别映射到不同模型模式Claude Code 内部名称推荐映射硅基流动适用场景快速模式Haikudeepseek-ai/DeepSeek-V3简单问答、代码补全标准模式SonnetPro/zai-org/GLM-4.7日常开发深度模式OpusPro/zai-org/GLM-5复杂架构设计、大型重构提示如果不设置默认模型每次启动 Claude Code 时需要手动指定--model参数。填写示例步骤四保存并激活点击「添加」保存配置在 Provider 列表中找到刚添加的「硅基流动」点击选中它 → 该 Provider 变为当前激活状态通常有高亮或对勾标识4.3 重启 Claude CodeProvider 切换后需要重启 Claude Code 才能生效# 在 CC-Switch 中点击 Claude 的「重启」按钮# 或手动操作# 1. 关闭所有 Claude Code 终端窗口# 2. 重新打开终端输入 claude4.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 或 ~/.bashrcexportANTHROPIC_BASE_URLhttps://api.siliconflow.cnexportANTHROPIC_AUTH_TOKENsk-你的密钥exportANTHROPIC_MODELPro/zai-org/GLM-4.75.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.7max_tokens 100 messages ({role user;content 你好请简单介绍一下你自己})}|ConvertTo-JsonInvoke-RestMethod-Urihttps://api.siliconflow.cn/v1/messages-Method Post -ContentTypeapplication/json-Headers {Authorization Bearer sk-你的密钥}-Body$bodymacOS / Linux (curl)# 直接用 curl 测试硅基流动 Anthropic 兼容端点curl--requestPOST\--urlhttps://api.siliconflow.cn/v1/messages\-HContent-Type: application/json\-HAuthorization: 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 tokensPro/zai-org/GLM-5智谱最强推理适合复杂任务Opus深度¥0.002/1K tokensdeepseek-ai/DeepSeek-V3DeepSeek 最新版综合能力强Sonnet标准¥0.001/1K tokensdeepseek-ai/DeepSeek-R1推理增强版适合逻辑分析Opus深度¥0.004/1K tokensmoonshotai/Kimi-K2-Instruct-0905Moonshot 出品中英双语佳Sonnet标准¥0.001/1K tokensQwen/Qwen2.5-Coder-7B-Instruct阿里通义千问代码专用模型Haiku快速¥0.0005/1K tokens6.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|findstr15721预期输出有 LISTENING 状态的条目TCP 127.0.0.1:15721 0.0.0.0:0 LISTENING PID7.2 查看 CC-Switch 日志# 查看最新日志type%USERPROFILE%\.cc-switch\logs\cc-switch.log正常日志应包含[SRV-001] 代理服务器启动于 127.0.0.1:157217.3 查看当前环境变量# PowerShell - 查看 Anthropic 相关变量Get-ChildItem Env:|Where-Object{$_.Name-like*ANTHROPIC*}CC-Switch 管理的环境变量备份文件位于%USERPROFILE%\.cc-switch\backups\env-backup-*.json7.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 queryHKCU\Environment/v ANTHROPIC_BASE_URL reg queryHKLM\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 Code8.2 返回 401 Unauthorized 错误原因API Key 无效或未正确设置。解决确认 API Key 完整复制以sk-开头在硅基流动控制台确认密钥状态是否「已启用」账户是否欠费余额不足在 CC-Switch 中重新输入 API Key8.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-wConnect: %{time_connect}s\nTotal: %{time_total}s\nhttps://api.siliconflow.cn/v1/messages8.5 CC-Switch 托盘图标消失或界面打不开解决# 杀掉 CC-Switch 进程并重启taskkill /f /im cc-switch.exe# 然后从开始菜单重新启动 CC-Switch9. 附录多 Provider 切换技巧9.1 场景化切换策略CC-Switch 支持为不同 AI 工具独立配置 Provider场景Claude Code ProviderCodex 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:/-%.db9.4 快速切换命令高级如果你习惯命令行操作可以通过修改环境变量备份文件实现快速切换# 切换到硅基流动PowerShell$env:ANTHROPIC_BASE_URLhttps://api.siliconflow.cn$env:ANTHROPIC_AUTH_TOKENsk-你的硅基流动Key$env:ANTHROPIC_MODELPro/zai-org/GLM-4.7# 切换到 DeepSeek$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic$env:ANTHROPIC_AUTH_TOKENsk-你的DeepSeekKey$env:ANTHROPIC_MODELdeepseek-v4-pro注意命令行方式仅影响当前终端会话关闭终端后失效。如需永久切换请使用 CC-Switch GUI。参考链接资源URLCC-Switch GitHubhttps://github.com/farion1231/cc-switchCC-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-ClaudeCodeClaude Code 官方文档https://docs.anthropic.com/en/docs/claude-code 文档说明本文档基于 Windows 11 CC-Switch v3.15.0 Claude Code v2.1.x 编写。不同版本界面和操作可能存在差异请以实际版本为准。