Claude Code 接入 BCL AI 教程

Claude Code 是 Anthropic 官方出品的终端智能编码工具，可以通过自然语言命令直接在命令行中帮你完成代码生成、读取本地文件、调试和重构等任务。

通过接入 BCL AI ，修改环境变量，您可以将 Claude Code 的默认官方接口替换为 BCL AI，从而享受更稳定、高性价比的 API 服务。

一、接入前准备

开始前，请先准备好以下 2 个核心配置信息。请登录 BCL AI 控制台获取你的专属密钥：

配置项	推荐填写内容	注意事项
API Key	`sk-xxxxxxxxxxxxxxxx`	填写控制台 Key
Base URL	`https://ai-router.bcltech.net`	不要 `/v1` 后缀

二、安装 Claude Code

请确保你的电脑已安装 Node.js (18 或更高版本)。打开终端（Windows 用户请务必使用 PowerShell），你可以先运行 node --version检查当前环境。

如果环境没有Node 24，点击跳转下载

然后依次运行以下命令：

1. 基础安装

2. 升级为原生安装包（极其重要）

Claude Code 官方目前已切换为 Native 安装模式。为了避免后续报错，请在基础安装完成后，紧接着运行以下命令：

提示：安装成功后，系统会绿色字体提示 Claude Code successfully installed!。

三、Windows 用户专属避坑指南

Windows 系统的严格安全策略通常会拦截 Claude Code 的运行。如果你是 Windows 用户，请务必在配置前执行以下操作（Mac/Linux 用户可直接跳过此步）：

1. 解除脚本运行限制

在 PowerShell 中运行以下命令。如果系统提示是否更改执行策略，请输入 Y 并回车确认：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

防坑说明：如果不执行此步，运行 claude 时会报红字错误，在此系统上禁止运行脚本。

2. 解决“无法识别 claude”报错

如果你输入claude提示找不到命令，说明安装路径没有自动加入环境变量。

按 Win 键搜索“环境变量”，将 C:\Users\你的用户名\.local\bin 路径添加到当前用户的 Path 变量中，然后重启 PowerShell。

四、配置 BCL AI 并启动

Claude Code 严格依赖环境变量来识别自定义代理。请务必确保设置变量和运行命令在同一个终端窗口中进行。

方式一：临时配置（推荐首次测试使用）

打开终端（Windows 需打开 PowerShell），按顺序逐行粘贴以下代码并回车：

Windows (PowerShell):

macOS / Linux:

方式二：长期配置（永久生效，推荐）

如果你希望以后每次打开终端直接输入 claude 就能用，无需每次敲代码设置变量，请配置系统的全局环境变量：

Windows: 在系统“环境变量” -> “用户变量”中，新建两个变量：变量名 ANTHROPIC_AUTH_TOKEN 对应你的 Key；变量名 ANTHROPIC_BASE_URL 对应 https://ai-router.bcltech.net ，配置后重启终端

Mac/Linux: 将 export 语句写入你的~/.zshrc或 ~/.bashrc 文件中，并执行 source ~/.zshrc。

五、如何测试是否成功？

当你在设置了环境变量的终端中输入 claude 并回车后：

系统不会再提示红色的 Not logged in · Please run /login。

你将直接进入带有 > 提示符的交互界面。

输入一个简单的测试问题，例如：请帮我用 Python 写一个 Hello World。

如果 Claude 能够正常输出代码，恭喜你，接入成功！

六、常见问题 (FAQ)

Q1：报错信息：Your credit balance is too low to access the Anthropic API.

可能 BCL AI 账号没有余额了：你填入的这个 sk-... 的 Key，里面对应的 Token 额度可能已经耗尽了，充值即可。

如果 BCL AI 账号有余额，那么可以尝试换分组或者换模型。

换分组：在控制台token页面点击编辑，切换令牌分组，然后提交即可。

换模型：在claudecode界面输入：

Q2：为什么还是提示 Not logged in / Please run /login？

检查变量名是否是 ANTHROPIC_AUTH_TOKEN。

最常见原因：环境变量是单窗口生效的。你可能在窗口 A 设置了变量，却在新开的窗口 B 运行了 Claude。请务必在同一个窗口内操作。

Q3：Base URL 加不加 /v1？

不加/v1，在目前 BCL AI 的接口规范和 Claude Code 的新版逻辑下，请严格填写 https://ai-router.bcltech.net

Q4：不小心输入了 /login 怎么办？

/login 是用来登录 Anthropic 官方账号的。如果你接入的是 BCL AI，请不要使用此命令。如果不小心进入了登录界面，一直按 Esc 键退出即可，系统会自动退回并读取你的环境变量。

Claude Code

Claude Code 接入 BCL AI 教程#

一、接入前准备#

二、安装 Claude Code#

然后依次运行以下命令：#

1. 基础安装#

2. 升级为原生安装包（极其重要）#

三、Windows 用户专属避坑指南#

1. 解除脚本运行限制#

2. 解决“无法识别 claude”报错#

四、配置 BCL AI 并启动#

方式一：临时配置（推荐首次测试使用）#

方式二：长期配置（永久生效，推荐）#

五、如何测试是否成功？#

六、常见问题 (FAQ)#