Windows 接入 Claude Code
前置条件
开始之前,确保你已经完成:
- ✅ 环境准备(PowerShell 策略 + Git)
- ✅ 小蓝中转站 账号已注册并充值
- ✅ 已创建 API 密钥(以
sk-开头的字符串) - ✅ 已从模型广场复制模型名
还没做?先回 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 Key | 以 sk- 开头,从控制台复制 |
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
claudeClaude 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_DISCOVERY 为 1 |
| Key 无效 / 鉴权失败 | Key 被停用或余额不足 | 回控制台检查 Key 状态和余额 |
| 模型不存在 | 模型名写错了 | 回模型广场重新复制完整模型名,不要手动编 |
claude 命令不存在 | 安装没成功或 PATH 未更新 | 重新安装后关闭终端重开 |
遇到以上方法无法解决的问题,去 排障手册 按层级排查。