跳到主要内容

Claude Code 接入 B.AI API 配置指南

目录​


开始之前​

在开始配置前,请先完成以下两个前置步骤。

第一步:安装 Claude Code​

请根据你的操作系统选择安装方式:

macOS / Linux / WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

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

npm(需要 Node.js 18+):

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

第二步:获取 B.AI API Key​

  1. 登录 B.AI Chat 平台
  2. 进入 API Key 管理页面
  3. 点击创建新的 API Key

注意: 请妥善保管你的 API Key,后续配置时会用到。

完成以上两个步骤后,你可以选择下面任意一种方式来配置 B.AI API。


方式一:settings.json(推荐)​

这种方式通过 Claude Code 自身的设置文件完成配置,无需修改系统环境变量。

操作步骤​

  1. 找到 Claude Code 安装目录中的 settings.json 文件;如果文件不存在,请手动创建。
  2. 添加以下内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "Your-B.AI-API-Key",
"ANTHROPIC_BASE_URL": "https://api.b.ai",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"API_TIMEOUT_MS": "3000000"
}
}

提示: 请按下方选择模型与获取模型 ID 的说明获取模型 ID,并填入 ANTHROPIC_MODEL。

  1. 保存文件并重启终端。
  2. 运行以下命令验证配置:
claude --version
claude

如果 Claude Code 能正常启动,并通过 B.AI 模型完成响应,说明配置成功。


方式二:环境变量​

当你希望配置在当前系统中全局生效时,可以使用这种方式。

设置环境变量​

请将以下内容添加到对应的 Shell 配置文件中:

Bash(Linux / macOS)​

编辑 ~/.bashrc(macOS 也可以使用 ~/.bash_profile):

# Claude Code - B.AI Provider Configuration
export ANTHROPIC_BASE_URL="https://api.b.ai"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
# End of B.AI Provider Configuration

应用配置:

source ~/.bashrc

Zsh(Linux / macOS)​

编辑 ~/.zshrc:

# Claude Code - B.AI Provider Configuration
export ANTHROPIC_BASE_URL="https://api.b.ai"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
# End of B.AI Provider Configuration

应用配置:

source ~/.zshrc

PowerShell(Windows)​

编辑你的 $PROFILE 文件:

# Claude Code - B.AI Provider Configuration
$env:ANTHROPIC_BASE_URL = "https://api.b.ai"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key-here"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-6"
# End of B.AI Provider Configuration

应用配置:

. $PROFILE

配置文件路径参考​

操作系统Shell配置文件路径
LinuxBash~/.bashrc
LinuxZsh~/.zshrc
macOSBash~/.bashrc 或 ~/.bash_profile
macOSZsh~/.zshrc
WindowsPowerShell$PROFILE

验证配置​

claude --version
claude

如果 Claude Code 能正常启动,并通过 B.AI 模型完成响应,说明配置成功。


切换模型​

临时切换(仅当前会话生效)​

Linux / macOS:

ANTHROPIC_MODEL=claude-opus-4-6 claude

Windows PowerShell:

$env:ANTHROPIC_MODEL="claude-opus-4-6"; claude

永久切换​

修改 settings.json 或 Shell 配置文件中的 ANTHROPIC_MODEL 值,然后重启终端或重新加载配置即可。


选择模型与获取模型 ID​

在 API Key 页面找到需要使用的模型,点击模型右侧的复制按钮获取模型 ID,并填入 ANTHROPIC_MODEL。

也可以通过 GET /v1/models 查询当前 API Key 可用的模型列表。

用于 Claude Code 的模型需支持 B.AI 的 Anthropic 兼容 /v1/messages 接口及工具调用。模型在列表中可见,不代表一定适用于 Claude Code。

对于 Claude 模型,Claude Code 配置中连字符 alias 和点号版本 alias 均可使用。


常见问题​

问:出现 “claude command not found” 怎么办?

请先安装 Claude Code:

  • Linux / macOS: curl -fsSL https://claude.ai/install.sh | bash
  • Windows: irm https://claude.ai/install.ps1 | iex

安装完成后,重启终端再试。

问:安装或配置脚本执行失败,应该检查什么?

请确认以下几点:

  1. Claude Code 已安装成功(claude --version 能输出版本号)
  2. 系统中已安装 curl(Linux / macOS)
  3. 当前网络可以访问 https://api.b.ai

如果问题仍然存在,建议改用 方式二:环境变量 进行手动配置。

问:如何确认配置已经生效?

请检查环境变量是否已正确设置:

Linux / macOS:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL

Windows PowerShell:

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_MODEL