Windows 部署 Claude Code + 硅基流动完整配置指南

本文详解在 Windows 系统上安装 Claude Code 的两种方法,配置硅基流动 API,以及排查修复常见问题。


一、为什么要配置硅基流动?

因为没钱,新人认证会送16元代金券,适用于国内所有大模型。硅基流动注册地址


二、自主安装 Claude Code CLI

2.1 环境准备

第一步:安装 Node.js

Claude Code 基于 Node.js 运行,需要先安装:

  1. 访问 Node.js 官网 下载 LTS 版本(推荐20以上版本)
  2. 运行安装包,务必勾选「Add to PATH」
  3. 验证安装:
    node --version
    npm --version
    
第二步:安装 Claude Code

电脑打开 PowerShell或者CMD,执行:

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

安装完成后验证版本:

claude --version
第三步:配置 API Key
  1. 获取硅基流动 API Key

    • 登录 硅基流动 控制台
    • 进入「API 密钥」页面
    • 创建新密钥并保存
  2. 通过 Claude Code 配置
    往往在c盘当前用户名目录文件下 /.claude/settings.json 中添加:

    {
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_api_key",
        "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",
        "ANTHROPIC_MODEL": "Pro/zai-org/GLM-4.7"
      }
    }
    
第四步:启动使用
claude

首次使用会引导你完成配置,按照提示操作即可。


三、使用 CC Switch配置大模型(非必须)

3.1 什么是 CC Switch?

CC Switch 是一款专为 Claude Code 设计的代理工具,支持中文,主要功能:

  • 模型切换 - 一键在不同模型间切换
  • 第三方 API 支持 - 对接硅基流动、阿里云等
  • 请求整流器 - 自动适配不同 API 的参数格式
  • 用量统计 - 记录各模型 API 使用情况

3.2 下载安装 CC Switch

  1. 访问 CC Switch GitHub Releases
  2. 下载最新版本的 Windows 安装包
  3. 运行安装程序,完成后启动

3.3 配置硅基流动 API

通过 CC Switch 界面配置
  1. 打开 CC Switch

  2. 点击「添加新供应商」 在这里插入图片描述

  3. 选择「SiliconFlow」

  4. 填入你的硅基流动API密钥

  5. 复制你想配置的模型名称,粘贴到主模型配置内
    挑选你自己中意的模型
    在这里插入图片描述

  6. 保存

3.4 启用代理接管

  1. 打开 CC Switch → Settings(左上角小齿轮) → 代理
  2. 启用「本地代理」
  3. 在「选择要接管的应用」中找到 Claude
  4. 开启 Claude 的代理接管开关

3.5 启用请求整流器

这是解决 thinking 参数兼容性问题的关键!

  1. 在 Proxy 设置页面找到「请求整流」区域
  2. 启用「请求整流」总开关
  3. 启用「Thinking Budget 整流」

Thinking Budget 整流功能会在 API 返回 thinking 参数错误时,自动将 thinking 规范为正确格式并重试,确保 Claude Code 的 Extended Thinking 功能正常工作。


五、问题排查与修复

5.1 常见错误:thinking type should be enabled or disabled

错误信息:

API Error: 400 thinking type should be enabled or disabled

原因分析:

Claude Code 发送的 thinking 参数格式可能是:

  • thinking: "enabled" (字符串) → ❌ 报错
  • thinking: { type: "enabled" } (对象) → ✅ 成功

硅基流动等第三方 API 对 thinking 参数格式有严格要求,而 Claude Code 默认发送的格式可能不兼容。

解决方案一:启用 CC Switch 整流器(推荐)

如 3.5 节所述,启用「Thinking Budget 整流」功能,让 CC Switch 自动转换参数格式。

解决方案二:重置 Thinking 模式

在 Claude Code 中按 Alt + T 两次:

  1. 第一次:关闭 thinking mode
  2. 第二次:重新打开 thinking mode

这会重置 Claude Code 内部的 thinking 参数状态。如何还是报错就直接关闭thinking mode。参考https://github.com/farion1231/cc-switch/issues/1489这个问题,即便关闭,硅基流动的模型也会正常推理。

六、 验证模型配置

运行以下命令测试:

claude

在 Claude Code 中输入:

你当前的模型是什么?

如果返回正确的模型名称(如 GLM-5.0),说明配置成功。


七、常见问题

Q: 可以同时使用多个 API 提供商吗?

A: 可以。通过 CC Switch 可以配置多个供应商,通过界面一键切换。

Q: CC Switch 安全吗?

A: CC Switch 是开源工具,API Key 仅存储在本地,不会发送到第三方服务器。


八、总结

文章中对应的软件版本Windows 11 + Node.js v20 + Claude Code v2.1.85 + CC Switch v3.12.3,如果新人注册硅基流动可以填写我的邀请码aQdCDcVf,如有疑问大家可以留言沟通

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐