Skip to content

Windows 接入 Claude Code

前置条件

开始之前,确保你已经完成:

  1. 环境准备(PowerShell 策略 + Git)
  2. ✅ 小蓝中转站 账号已注册并充值
  3. ✅ 已创建 API 密钥(以 sk- 开头的字符串)
  4. ✅ 已从模型广场复制模型名

还没做?先回 Windows 快速接入 的第一阶段。

第 1 步:安装 Claude Code

打开 PowerShell(建议以管理员身份运行),选一种方式安装:

方式一:官方脚本(推荐,不需要 Node.js)

powershell
irm https://claude.ai/install.ps1 | iex

方式二:WinGet

powershell
winget install Anthropic.ClaudeCode

方式三:npm(需要已安装 Node.js)

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

安装完成后,关闭 PowerShell,重新打开一个新窗口,验证:

powershell
claude --version

应该输出版本号(如 1.0.x)。如果提示命令不存在,说明安装没成功或 PATH 没有更新,重新安装后再关闭终端重开。

第 2 步:配置 小蓝中转站 网关

Claude Code 需要知道三样东西:地址、Key、是否开启模型发现。

在 PowerShell 里执行以下三条命令(把 sk-你的专属Key 替换成你在控制台创建的真实 Key):

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://xiaolan.ainb.plus", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的专属Key", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "1", "User")

每条命令的含义:

变量含义注意
ANTHROPIC_BASE_URL小蓝中转站 网关地址只能写 https://xiaolan.ainb.plus,不要加 /v1
ANTHROPIC_AUTH_TOKEN你的 API Keysk- 开头,从控制台复制
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY启动时自动发现可用模型设为 1 开启

最常见的错误

Base URL 不要写成 https://xiaolan.ainb.plus/v1。Claude Code 会自己在后面拼接路径,你多写一个 /v1 会导致最终地址变成 .../v1/v1/...,报 404 错误。

设置完后,关闭 PowerShell,打开一个新的,验证环境变量是否生效:

powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

应该分别输出 https://xiaolan.ainb.plus 和你的 Key。如果输出为空,说明设置没成功。

第 3 步:固定默认模型(可选)

如果你想让 Claude Code 每次启动都用同一个模型,可以设置:

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "从模型广场复制的模型名", "User")

也可以不设置,启动后用 /model 命令手动选择。

第 4 步:测试

创建一个测试目录,启动 Claude Code:

powershell
mkdir $env:USERPROFILE\xiaolan-claude-test
cd $env:USERPROFILE\xiaolan-claude-test
claude

Claude Code 启动后,输入一句话(比如「你好」)。如果能收到回复,说明配置成功。

如果弹出了官方登录界面,说明环境变量没有被正确读取。关闭 Claude Code,回到第 2 步重新检查。

配置成功后,你就可以在真实项目目录里使用 Claude Code 了:

powershell
cd 你的项目目录
claude

常见问题

现象可能原因怎么处理
弹出官方登录、连不上环境变量没写入或没生效重新执行第 2 步,关闭终端再开新的,用 echo $env:ANTHROPIC_BASE_URL 验证
报 404 错误Base URL 多写了 /v1检查 ANTHROPIC_BASE_URL 必须是 https://xiaolan.ainb.plus(不带 /v1
启动后看不到模型列表模型发现没开确认 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY1
Key 无效 / 鉴权失败Key 被停用或余额不足回控制台检查 Key 状态和余额
模型不存在模型名写错了回模型广场重新复制完整模型名,不要手动编
claude 命令不存在安装没成功或 PATH 未更新重新安装后关闭终端重开

遇到以上方法无法解决的问题,去 排障手册 按层级排查。

小蓝中转站使用文档