Claude Code 接入阿里云百炼 / 硅基流动免费额度：settings.json 环境变量配置教程

准备

• 已安装 Node.js 18 或更高版本（百炼文档要求 v18.0+）
• 阿里云百炼 API Key（获取与配置 API Key）或 SiliconFlow API Key（API 密钥 页面新建）
• Windows 用户需先装 WSL 或 Git for Windows，在 WSL / Git Bash 里操作

步骤

1. 01

   先搞懂原理：Claude Code 只认两个变量

   Anthropic 官方文档说明：ANTHROPIC_BASE_URL 决定请求发往哪里，ANTHROPIC_AUTH_TOKEN（以 Authorization: Bearer 头发送）或 ANTHROPIC_API_KEY（以 x-api-key 头发送）是凭证。只要第三方平台提供 Anthropic Messages 兼容接口，把这两个变量指过去即可，费用由该平台结算。

   注意：Anthropic 官方明确表示不为通过网关调用非 Claude 模型提供支持，所以出问题时要找平台文档排查，而不是 Anthropic。

2. 02

   安装 Claude Code

   在终端执行下面的命令，装完用 claude --version 能看到版本号即成功。

   bash复制

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

3. 03

   跳过官方登录引导

   按百炼文档，编辑或新建 ~/.claude.json（Windows：C:\Users\<用户名>\.claude.json），把 hasCompletedOnboarding 设为 true。不设置的话，Claude Code 启动时会先去连 Anthropic 官方服务做登录验证。

   json复制

   {
     "hasCompletedOnboarding": true
   }

4. 04

   方案 A：阿里云百炼（按量计费 + 新人免费额度）

   新建 ~/.claude/settings.json，写入下面的 env。百炼文档说明按量计费的 ANTHROPIC_BASE_URL 按地域设置，北京地域为 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic（把 {WorkspaceId} 换成你的业务空间 ID）；文档 FAQ 也给出了按量计费通用地址 https://dashscope.aliyuncs.com/apps/anthropic，配套使用 sk- 开头的百炼 API Key。

   • 模型名示例取自百炼官方文档，模型会更新，以百炼控制台为准；
   • 新人免费额度只适用于华北2（北京）地域，别选成新加坡或美国地域；
   • ANTHROPIC_DEFAULT_HAIKU/SONNET/OPUS_MODEL 决定 Claude Code 内部三档模型分别映射到哪个百炼模型。

   json复制

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "你的百炼API Key",
       "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
       "ANTHROPIC_MODEL": "qwen3.7-max",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
       "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-max"
     }
   }

5. 05

   方案 B：SiliconFlow（硅基流动）

   SiliconFlow 官方文档给的手动配置是三行环境变量（适用于 Mac / Linux），ANTHROPIC_MODEL 换成 模型广场 里你想用的模型名即可。也可以把这三项写进 ~/.claude/settings.json 的 env 里，效果相同且对新终端持久生效。

   SiliconFlow 还提供一键安装脚本（会提示你粘贴 Key、选择模型），见文末来源里的官方页面。

   bash复制

   export ANTHROPIC_BASE_URL="https://api.siliconflow.cn/"
   export ANTHROPIC_MODEL="moonshotai/Kimi-K2-Instruct-0905"
   export ANTHROPIC_API_KEY="你的SiliconFlow API Key"

6. 06

   验证：新开终端，跑一句话，再看 /status

   • 新开一个终端窗口，执行 claude "你好"，能正常回复就说明通了；
   • 进入 Claude Code 后执行 /status，确认 Anthropic base URL 一行显示的是百炼或硅基流动的地址；
   • 用 ANTHROPIC_API_KEY 时，交互模式下首次会提示你确认是否使用这个 Key，选同意即可。

注意事项

• Key 和地址必须配套：百炼的按量计费、Coding Plan、Token Plan 各有专属 Base URL 和 API Key，混用会报 401 invalid_api_key。用免费额度就选按量计费那一套。
• Agent 很费 Token：SiliconFlow 文档提醒，在 Claude Code 场景下 token 消耗会显著增加。免费额度可能很快用完，建议在平台控制台开好额度用尽即停之类的保护。
• 百炼免费额度按模型独立计算：各模型的免费额度互不共享，用完一个模型的额度后继续调用会产生费用。
• 别把 Key 写进项目里的 .claude/settings.json：Anthropic 文档提醒该文件会被提交到仓库，个人 Key 放用户目录 ~/.claude/settings.json。
• 切换 SiliconFlow 模型：官方文档说明 Claude Code 不支持添加多个自定义模型，需要修改 ANTHROPIC_MODEL 后重开终端。

常见问题

相关优惠

• 新人 · 阿里云百炼新人免费额度每个模型 100 万 Tokens（70+ 模型，总额超 7000 万），90 天有效

信息来源

• Claude Code · Connect Claude Code to an LLM gatewaydocs.anthropic.com/en/docs/claude-code/llm-gateway-connect
• Claude Code · Other LLM gatewaysdocs.anthropic.com/en/docs/claude-code/llm-gateway
• 阿里云百炼 · Claude Codehelp.aliyun.com/zh/model-studio/claude-code
• 阿里云百炼 · Cherry Studio（新人免费额度地域说明）help.aliyun.com/zh/model-studio/cherry-studio
• SiliconFlow · Claude Codedocs.siliconflow.cn/cn/usercases/use-siliconcloud-in-ClaudeCode

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准