接入 Claude Code

Claude Code 官方现在支持原生安装脚本、Homebrew、WinGet 和 npm。接入 小蓝中转站 时，真正决定请求走向的是 Base URL、Key 和模型；安装方式只是把 claude 这个命令装到本机。

环境还没准备好时，先完成 Windows 快速接入 或 macOS 快速接入。

Claude Code 读取的是 Anthropic 协议变量，所以这里和 OpenAI 兼容工具不一样。Base URL 只能填根地址：

https://xiaolan.ainb.plus

不要加 /v1。Claude Code 会自己补 Anthropic 接口路径；如果这里先写成 https://xiaolan.ainb.plus/v1，最终请求路径很容易拼成错误地址，表现通常是鉴权失败、接口 404，或者启动后一直连不上模型。

安装方式怎么选

场景	更省事的装法	原因
只是先把 Claude Code 跑起来	原生安装脚本	不需要先准备 npm
macOS 本来就常用 Homebrew	Homebrew	升级和卸载更顺手
Windows 不想先装 Node.js	WinGet	适合纯 Windows 命令行环境
后面还要装 Codex、Gemini CLI、各种 npm CLI	npm	一套 Node/npm 环境能继续复用

后面还会折腾 Codex、Gemini CLI、Cherry Studio 插件生态或其他 npm 工具时，哪怕 Claude Code 本身不一定非要靠 npm 安装，提前把 Node.js 和 npm 准备好，后面整体会更省事。

官方入口：

• 官方文档：https://code.claude.com/docs
• 官方快速开始：https://docs.anthropic.com/en/docs/claude-code/quickstart

开始前先检查

Claude Code 处理代码仓库时，会依赖终端环境、Git 状态和模型配置。Windows 上如果装了 Git for Windows，还能给 Claude Code 提供 Git Bash，这比纯 PowerShell 更接近很多教程和脚本默认的 Bash 环境。

先检查这些命令：

# Git 用来读取仓库状态、diff、分支信息
git --version

# 走 npm 安装时，下面两条必须可用
node -v
npm -v

# 只影响 npm 下载速度，不影响 小蓝中转站 的接口地址
npm config get registry

打算用 npm，而下载速度很慢时，先切镜像源：

# 改成国内常用 npm 镜像，加快安装 Claude Code 及其依赖
npm config set registry https://registry.npmmirror.com

Node.js 和 Git 还没装好时，可以先看：

• Windows Node 安装
• macOS Node 安装

先把 claude 装到本机

原生安装脚本

适合想尽快开始、又不想先准备 npm 的环境。

macOS / Linux / WSL：

# 官方原生安装脚本
curl -fsSL https://claude.ai/install.sh | bash

# 确认 claude 命令已经可用
claude --version

Windows PowerShell：

# 官方 PowerShell 安装脚本
irm https://claude.ai/install.ps1 | iex

# 确认 claude 命令已经可用
claude --version

Homebrew

适合已经在用 Homebrew 管理命令行工具的 macOS 用户。

# 安装 Claude Code 稳定版
brew install --cask claude-code

# 确认 claude 命令已经可用
claude --version

WinGet

适合纯 Windows 命令行环境，不想先碰 npm。

# 通过官方 WinGet 包安装 Claude Code
winget install Anthropic.ClaudeCode

# 确认 claude 命令已经可用
claude --version

npm

适合本机已经装好 Node.js，或者后面还会继续安装 Codex、Gemini CLI 等 npm CLI 的环境。

# 通过 npm 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 确认 claude 命令已经可用
claude --version

macOS 上用浏览器安装 Node.js 的机器，实际执行时更常见的写法是：

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

终端出现钥匙图标或 Password: 提示后，密码不会显示任何字符，直接输入完成后按回车即可。

Git for Windows 到底值不值得装

Windows 上写代码时，建议还是装。

原因很直接：

• git 命令让 Claude Code 更容易读懂当前仓库的改动、分支和提交历史。
• Git for Windows 会附带 Git Bash，很多常见 shell 命令和脚本在这里比纯 PowerShell 更顺手。
• 就算现在的新版本 Claude Code 在 Windows 上没有 Git Bash 也能退回 PowerShell，装好 Git 之后，很多教程、命令示例和跨平台脚本仍然更好对齐。

如果 Git 已经装了，但 Claude Code 找不到 Git Bash，可以补这个路径：

# 只在 Claude Code 找不到 Git Bash 时再设置
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")

方式一：使用 CC-Switch

希望用图形界面统一管理 Claude Code、Codex、Gemini CLI 的地址、Key 和模型时，可以直接用 CC-Switch。

在 Claude 面板里填：

• Base URL：https://xiaolan.ainb.plus
• API Key：小蓝中转站控制台创建的专属 Key
• Model：从 模型广场 复制完整模型名

切换后，Claude Code 对配置变化通常感知得比其他 CLI 更快；很多场景下保存后就能直接生效。
如果当前会话仍然沿用旧模型或旧 Key，再开一个新终端窗口最稳。

方式二：手动写入环境变量

手动方式最透明：地址写在哪里、Key 从哪里读、模型怎么切，都能自己看得清楚。

第一次配置时，建议先把变量写好，再启动 claude，这样更不容易在首次打开时直接走官方登录流程。

macOS 和 Linux

把下面内容追加到 ~/.zshrc 或 ~/.bashrc：

# Claude Code 的网关地址。这里只能写根地址，不能加 /v1
export ANTHROPIC_BASE_URL="https://xiaolan.ainb.plus"

# 小蓝中转站控制台创建的专属 Key。Claude Code 会把它当 Bearer Token 使用
export ANTHROPIC_AUTH_TOKEN="sk-你的网关专属Key"

# 允许 Claude Code 启动时向网关读取可用模型，并显示到 /model 列表
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"

# 可选：把默认模型固定下来。没有这行时，后面也可以用 /model 再选
# export ANTHROPIC_MODEL="从模型广场复制的模型名"

写完后让当前终端立即生效：

# zsh 用户重载 zsh 配置
source ~/.zshrc

用的是 bash 时，把 ~/.zshrc 换成 ~/.bashrc 或 ~/.bash_profile。

Windows（PowerShell）

# Claude Code 的网关地址。这里只能写根地址，不能加 /v1
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://xiaolan.ainb.plus", "User")

# 小蓝中转站控制台创建的专属 Key。Claude Code 会把它当 Bearer Token 使用
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的网关专属Key", "User")

# 允许 Claude Code 启动时向网关读取可用模型，并显示到 /model 列表
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "1", "User")

# 可选：把默认模型固定下来。没有这行时，后面也可以用 /model 再选
# [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "从模型广场复制的模型名", "User")

写完后，完全关闭当前终端窗口，再打开一个新的 PowerShell。

分组和模型怎么选

这一步决定的是“这把 Key 能调用哪些模型、优先走哪类渠道”，不是随便填个名字就能用。

分组

第一次接入，还不清楚各分组的价格和路由差异时，先选 auto 或默认分组更稳。

这样做的好处是：

• 先把链路跑通，不会一上来就因为分组太窄而误判成工具配置错。
• 在允许的范围内，网关更容易帮你做同模型下的可用渠道切换。
• 后面等你已经确认 Claude Code 能正常对话，再按成本、地区或模型类型把分组收紧。

希望日志、额度和权限更清楚时，建议给 Claude Code 单独建一把 Key，不和 Cherry Studio、Codex 共用。

模型

模型名一律以 模型广场 为准。

选择时可以按这个顺序：

1. 先在模型广场筛选 Claude 系列或代码能力更强的模型。
2. 第一次验证先选一个当前可用、响应更快的模型，把链路先跑通。
3. 真正开始读仓库、改代码、做复杂任务时，再切到更强的模型。
4. 复制完整模型名，不要自己改日期、后缀和大小写。

模型能不能用，取决于三层是否一致：

• 这把 Key 的分组是否允许
• 这把 Key 的模型权限是否包含
• Claude Code 当前会话是否真的切到了这个模型

Claude Code 里怎么切模型

Claude Code 当前支持三种最常用的切法：

# 启动前临时指定这一次会话使用哪个模型
claude --model 从模型广场复制的模型名

进入 Claude Code 后：

/model

/model 会打开模型选择器。
如果已经开启 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1，Claude Code 会在启动时向网关读取一遍可用模型，把能识别的 Claude / Anthropic 模型放进列表里。

日常可以这样记：

• claude --model ...：只影响这一次启动
• ANTHROPIC_MODEL：影响带着这组环境变量启动的会话
• /model：进入 Claude Code 后立即切换，改完最直观

这个开关默认不是强制开启的，原因是 Claude 官方要避免“共享网关 Key 能看到的全部模型”被直接暴露给所有用户。
对个人 小蓝中转站 Key 来说，打开它通常更方便：你可以直接在 /model 里看到网关返回的可选模型，而不是一条条手写。

明确想把默认模型固定下来时，也可以写环境变量：

# 启动 Claude Code 时，把默认模型固定成这一项
export ANTHROPIC_MODEL="从模型广场复制的模型名"

首次测试

第一次不要直接丢给 Claude Code 一个大型仓库。先用一个干净目录，确认地址、鉴权和模型都没问题。

# 建一个最小测试目录，避免把首次问题和真实项目混在一起
mkdir -p ~/claude-xiaolan-test
cd ~/claude-xiaolan-test

# 启动 Claude Code
claude

进入后可以先发一句：

写一个 js 的 hello world，只返回代码。

能正常返回，再切到你的真实项目目录。

连通性测试与排障

启动后还在走官方登录

这通常不是 Claude Code “不支持网关”，而是当前终端根本没读到你写的变量。先检查：

macOS / Linux：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
echo $ANTHROPIC_MODEL

Windows PowerShell：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
echo $env:ANTHROPIC_MODEL

模型不存在或 /model 里看不到

先查这几件事：

• 这把 Key 有没有该模型权限
• 模型名是不是从模型广场复制的完整值
• CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 是否已经开启
• 当前网关返回的模型 ID 是否以 Claude / Anthropic 命名方式暴露

如果模型广场里明明有，但 /model 里没出来，先直接用完整模型名测试：

claude --model 从模型广场复制的模型名

鉴权失败

重点检查：

• ANTHROPIC_AUTH_TOKEN 是否有前后空格
• 控制台里这把 Key 是否已停用、余额耗尽或超出限制
• Base URL 是否误写成了 https://xiaolan.ainb.plus/v1

Windows 上命令执行不顺

已经装了 Git for Windows 时，优先确认 Git Bash 路径是否可见；没装 Git 时，Claude Code 现在也能退回 PowerShell，只是部分 Bash 风格命令和脚本不如 Git Bash 顺手。

npm 安装权限或下载问题

走的是 npm 安装路线时：

• 下载慢：先切 https://registry.npmmirror.com
• 权限错误：先回 macOS Node 安装 或 Windows Node 安装 处理 Node/npm 环境，不要直接用 sudo 或反复重装 Claude Code