Claude Code 安装配置指南 —— 使用硅基流动 API 轻松上手

Claude Code 是 Anthropic 推出的 AI 编程助手，可以直接在终端中帮你写代码、调试、重构，堪称"终端里的 AI 搭档"。但官方服务需要海外网络和信用卡，对国内用户不太友好。本文将教你如何通过硅基流动平台接入 Claude Code，无需海外网络，几步即可搞定！

---

一、前期准备：注册硅基流动并获取 API Key

1.1 注册账号

访问 硅基流动官网，点击右上角"登录"，支持手机号、邮箱或 GitHub账号登录。

邀请码: ssNJib8u
邀请链接: https://cloud.siliconflow.cn/i/ssNJib8u

1.2 完成实名认证

登录后进入控制台，按照提示完成实名认证（需上传身份证）。实名认证后才能正常调用 API。

1.3 创建 API Key

1. 进入 API 密钥页面
2. 点击"新建 API 密钥"
3. 复制生成的 API Key（注意：密钥只显示一次，请妥善保存！）

---

二、安装 Claude Code

2.1 安装 Node.js

Claude Code 需要 Node.js v18.0 或更高版本。

• macOS / Linux：推荐使用 nvm 安装，或直接从 Node.js 官网 下载。
• Windows：从 Node.js 官网 下载安装包，按提示安装即可。

安装完成后，打开终端验证：

node --version
# 应输出 v18.x.x 或更高版本

2.2 安装 Claude Code

macOS / Linux：直接在终端执行：

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

Windows：需要先安装 WSL 或 Git for Windows，然后在 WSL 或 Git Bash 中执行：

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

2.3 验证安装

claude --version

有版本号输出，说明安装成功！

---

三、配置硅基流动 API（核心步骤）

Claude Code 默认连接 Anthropic 官方服务，我们需要通过环境变量把它指向硅基流动的 API。只需设置三个环境变量：

环境变量	值	说明
ANTHROPIC_BASE_URL	https://api.siliconflow.cn	硅基流动 API 地址
ANTHROPIC_API_KEY	你的 API Key	从硅基流动控制台获取
ANTHROPIC_MODEL	模型名称	选择你想使用的模型

3.1 macOS / Linux 配置

先查看你用的是哪种 Shell：

echo $SHELL

如果输出 /bin/zsh（默认）：

# 将 YOUR_API_KEY 替换为你的硅基流动 API Key
echo 'export ANTHROPIC_BASE_URL="https://api.siliconflow.cn"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="Qwen/Qwen2.5-Coder-32B-Instruct"' >> ~/.zshrc

如果输出 /bin/bash：

echo 'export ANTHROPIC_BASE_URL="https://api.siliconflow.cn"' >> ~/.bash_profile
echo 'export ANTHROPIC_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="Qwen/Qwen2.5-Coder-32B-Instruct"' >> ~/.bash_profile

使环境变量生效：

# zsh 用户
source ~/.zshrc

# bash 用户
source ~/.bash_profile

验证配置：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_MODEL

如果三个变量都正确输出，说明配置成功。

3.2 Windows 配置

CMD（命令提示符）：

REM 将 YOUR_API_KEY 替换为你的硅基流动 API Key
setx ANTHROPIC_BASE_URL "https://api.siliconflow.cn"
setx ANTHROPIC_API_KEY "YOUR_API_KEY"
setx ANTHROPIC_MODEL "Qwen/Qwen2.5-Coder-32B-Instruct"

PowerShell：

# 将 YOUR_API_KEY 替换为你的硅基流动 API Key
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.siliconflow.cn", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "Qwen/Qwen2.5-Coder-32B-Instruct", [EnvironmentVariableTarget]::User)

⚠️ 注意：Windows 设置环境变量后，需要重新打开一个新的终端窗口才能生效！

验证配置（新终端窗口中）：

:: CMD
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_API_KEY%
echo %ANTHROPIC_MODEL%

# PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_MODEL

---

四、首次启动与跳过登录

进入你的项目目录，运行：

claude

首次启动时，Claude Code 可能会要求你登录 Anthropic 账户。因为我们用的是硅基流动的 API，不需要登录，请按以下步骤跳过：

1. 找到用户主目录下的 .claude.json 文件：

   • macOS / Linux：~/.claude.json
   • Windows：C:\Users\你的用户名\.claude.json

2. 将 hasCompletedOnboarding 设置为 true（如果没有则添加）：

{
  "hasCompletedOnboarding": true
}

3. 保存文件，重新运行 claude 即可。

---

五、模型选择建议

硅基流动提供了丰富的模型，你可以根据需求选择不同的模型。修改 ANTHROPIC_MODEL 环境变量即可切换：

使用场景	推荐模型	说明
日常编码（推荐）	Qwen/Qwen2.5-Coder-32B-Instruct	专为代码优化，性价比高
复杂推理任务	deepseek-ai/DeepSeek-V3	综合能力强，适合架构设计
推理思考模式	Pro/deepseek-ai/DeepSeek-R1	深度推理，适合复杂算法
通用 + 思考	Pro/zai-org/GLM-4.7	支持思维链，平衡能力与速度
轻量快速任务	Qwen/Qwen2.5-7B-Instruct	速度快，成本低

更多模型请前往 硅基流动模型广场 查看。

---

六、进阶配置（可选）

6.1 按任务类型配置不同模型

Claude Code 会根据任务复杂度自动选择模型，你可以分别配置：

# 复杂推理任务（架构设计等）
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-ai/DeepSeek-V3"

# 日常编码任务
export ANTHROPIC_DEFAULT_SONNET_MODEL="Qwen/Qwen2.5-Coder-32B-Instruct"

# 简单任务（语法检查等）
export ANTHROPIC_DEFAULT_HAIKU_MODEL="Qwen/Qwen2.5-7B-Instruct"

6.2 临时切换模型

在 Claude Code 对话中，可以随时切换模型：

/model Qwen/Qwen2.5-Coder-32B-Instruct

或者启动时指定：

claude --model deepseek-ai/DeepSeek-V3

6.3 使用配置文件永久设置

在项目根目录或用户主目录创建 .claude/settings.json：

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-V3",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "Qwen/Qwen2.5-Coder-32B-Instruct",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen2.5-7B-Instruct"
  }
}

---

七、常见问题

Q1：启动后提示 “UNABLE TO CONNECT TO ANTHROPIC SERVICES” 怎么办？

这说明 Claude Code 还在尝试连接官方服务。请检查：

1. 环境变量是否正确配置（ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY）
2. .claude.json 中 hasCompletedOnboarding 是否已设为 true
3. 修改配置后是否重新打开了终端

Q2：Token 消耗太快怎么办？

• 在具体项目目录中启动 Claude Code，避免扫描无关文件
• 使用 /compact 命令总结对话，减少上下文占用
• 指令尽量具体明确，避免模糊提问触发大量文件扫描
• 开启新任务前用 /clear 重置上下文

Q3：如何查看费用和余额？

登录 硅基流动控制台，在"账单"页面可以查看详细的 Token 消耗和费用明细。

---

写在最后

通过硅基流动接入 Claude Code，无需海外网络和信用卡，国内用户也能轻松使用 AI 编程助手。
邀请码：ssNJib8u
邀请链接：点击此处注册