国内环境部署 AI 助手：硅基流动 + Claude Code 完整开发环境教程

国内环境部署AI助手：硅基流动 +  Claude Code 完整开发环境教程

一、方案概述

本教程基于硅基流动（SiliconFlow）国内大模型平台 + Claude Code 官方客户端，实现完全国内直连、无需翻墙、数据合规、低成本的AI代码助手开发环境，完美适配Windows系统，支持GLM-5.1、  DeepSeek 、Qwen等国产顶尖代码模型。

二、前置环境准备

1. 系统要求

Windows 10 21H2 及以上 / Windows 11（原生支持winget包管理器）

管理员权限（用于安装软件、配置环境）

稳定的国内网络（无需科学上网）

2. 安装 Node.js（Claude Code 依赖）

Claude Code 运行依赖 Node.js 18.x 及以上版本，推荐安装LTS长期支持版：

访问 Node.js 官网，下载 LTS 版本（推荐 20.x/22.x）

运行安装包，务必勾选「Add to PATH」，一路默认安装即可

验证安装：以管理员身份打开PowerShell，执行：

node -v npm -v

输出版本号即表示安装成功。

3. 安装/更新 Claude Code（官方最新版）

使用Windows原生winget工具一键安装/更新官方最新版Claude Code：

以管理员身份打开PowerShell（或CMD）

执行更新/安装命令：

winget upgrade Anthropic.ClaudeCode

若首次安装，执行：winget install Anthropic.ClaudeCode

若提示No installed package found，直接执行安装命令即可

验证安装：执行

claude --version

输出版本号（如v2.1.97）即表示安装成功。

三、硅基流动平台准备（国内大模型服务）

1. 注册与认证

访问 硅基流动官网，使用手机号完成注册

完成实名认证（国内大模型服务合规要求，认证后可免费领取额度）

https://cloud.siliconflow.cn/i/v6Gt105P
邀请码：v6Gt105P

2. 获取API Key（核心配置项）

登录硅基流动控制台，点击右上角头像 → API 密钥

点击「新建密钥」，命名后创建，复制并安全保存你的API Key（以sk-开头，仅显示一次）

确认账户余额/代金券充足（新用户有免费额度，可覆盖测试使用）

四、Claude Code 对接硅基流动（官方标准配置）

1. 配置文件方式（永久生效，推荐）

在PowerShell中执行以下命令，创建配置目录并打开配置文件：

mkdir -Force ~/.claude notepad ~/.claude/settings.json

在打开的记事本中，粘贴以下配置（替换为你的API Key）：

{  "env": {    "ANTHROPIC_AUTH_TOKEN": "sk-你的硅基流动API Key",    "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",    "ANTHROPIC_MODEL": "Pro/zai-org/GLM-5.1"  } }

关键参数说明：

ANTHROPIC_AUTH_TOKEN：替换为你刚才复制的硅基流动API Key

ANTHROPIC_BASE_URL：固定为https://api.siliconflow.cn（禁止加/v1后缀，否则报错）

ANTHROPIC_MODEL：硅基流动支持的模型ID，可根据需求替换

保存文件并关闭记事本，重启PowerShell使配置生效。

2. 常用模型ID参考（硅基流动）

3. 临时环境变量配置（单次生效，测试用）

若仅需单次测试，可在PowerShell中执行以下命令（替换API Key）：

$env:ANTHROPIC_AUTH_TOKEN="sk-你的硅基流动API Key" $env:ANTHROPIC_BASE_URL="https://api.siliconflow.cn" $env:ANTHROPIC_MODEL="Pro/zai-org/GLM-5.1" claude

五、环境验证与功能测试

1. 启动Claude Code

重启PowerShell，进入你的项目目录（如D:\claudeCodeWorkspaces）

执行启动命令：

claude

首次启动会进入主题选择界面，选择1. Dark mode（默认深色模式，适配终端），按回车确认：

进入主界面，显示Welcome back!、当前模型Pro/zai-org/GLM-5.1，即表示配置成功：

2. 功能测试（代码生成验证）

在Claude Code输入框中，输入测试指令：

利用scala2.13写一个冒泡排序

模型会正常生成完整代码、注释、复杂度分析，如下所示：

3. 费用验证（硅基流动后台）

测试完成后，登录硅基流动控制台 → 费用明细，可查看调用记录、token用量、扣费情况（新用户代金券可覆盖测试费用，账单金额为0）：

六、常见问题与解决方案

1. 报错：claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件的名称

原因：Claude Code未正确安装，或环境变量未生效

解决方案：

重新执行winget install Anthropic.ClaudeCode安装

重启电脑，使环境变量生效

手动添加Claude Code安装路径到系统PATH（默认路径：C:\Program Files\Anthropic\Claude Code）

2. 报错：401 Unauthorized / 400 Bad Request

原因：API Key错误、Base URL配置错误、模型ID错误

解决方案：

检查ANTHROPIC_BASE_URL是否为https://api.siliconflow.cn（禁止加/v1）

确认API Key正确，无多余空格

核对模型ID，确保与硅基流动模型列表一致

确认API Key未过期、账户余额充足

3. 报错：权限不足 / 执行策略限制

解决方案：在PowerShell中执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入Y确认，允许脚本执行。

4. 模型切换方法

永久切换：修改~/.claude/settings.json中的ANTHROPIC_MODEL，重启Claude Code

临时切换：启动时指定模型：

$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V2-Chat" claude

七、进阶优化与使用技巧

1. 一键配置脚本（Windows）

将以下代码保存为setup-siliconflow-claude.ps1，替换API Key，右键「使用PowerShell运行」，一键完成配置：

# 硅基流动+Claude Code一键配置脚本 $apiKey = "sk-你的硅基流动API Key" $model = "Pro/zai-org/GLM-5.1" # 创建配置目录 mkdir -Force ~/.claude # 写入配置文件 @" {  "env": {    "ANTHROPIC_AUTH_TOKEN": "$apiKey",    "ANTHROPIC_BASE_URL": "https://api.siliconflow.cn",    "ANTHROPIC_MODEL": "$model"  } } "@ | Out-File ~/.claude/settings.json -Encoding utf8 Write-Host "✅ 配置完成！重启PowerShell，执行 claude 即可使用。" -ForegroundColor Green

2. Claude Code 常用命令

3. 成本优化建议

优先使用轻量模型（如GLM-4-9B）处理简单任务，复杂任务再切换GLM-5.1

定期清理对话上下文，减少冗余token消耗

参与硅基流动推荐活动，领取代金券降低成本（活动有效期至2026年12月31日）

八、方案优势总结

九、适用场景

高校大数据/计算机专业教学、实验环境搭建

大学生学科竞赛（挑战杯、蓝桥杯等）备赛AI辅助

企业内部AI代码助手部署（数据安全合规）

个人开发者日常编码、调试、重构

后续可扩展

配置VSCode Claude Code插件，实现IDE内AI辅助开发

部署本地LiteLLM代理，支持多模型负载均衡

自定义Claude Code系统提示词，适配特定开发场景（如Flink、Spark大数据开发）

#硅基流动 #Claude Code #AI #Scala