跳到主要内容

Claude Code

Claude Code 是 Anthropic 提供的命令行编码助手，可以在终端中阅读项目、解释代码、修改文件、生成测试、排查问题并协助提交变更。接入彼源 AI 后，可通过彼源 AI 统一访问可用的 Claude 系模型，并使用彼源 AI 令牌进行鉴权和计费。

适用场景​

  • 希望在终端中直接使用 AI 编码助手。
  • 希望通过彼源 AI 令牌接入 Claude 系模型。
  • 希望把 Claude Code 的调用、消耗和权限统一纳入彼源 AI 控制台管理。
  • 希望为不同项目或设备单独配置令牌，避免共用同一个高权限密钥。

前置条件​

开始前，请先准备以下信息：

项目说明
Claude Code已在本机安装并可运行 claude 命令
API endpointhttps://api.biyuan.ai，即其他页面说的服务地址（Base URL），Claude Code 这里填不带 /v1 的地址
彼源 AI 令牌在“令牌管理”中创建的 sk- 开头令牌
模型名称从模型广场复制 Claude 系列模型 ID，例如 claude-sonnet-4-6；令牌设置了模型限制时，以 GET /v1/models 返回为准

Claude Code 会在 ANTHROPIC_BASE_URL 后自动请求 Claude Messages 路径。配置彼源 AI 时请填写根地址 https://api.biyuan.ai，不要填写成 https://api.biyuan.ai/v1。

安装 Claude Code​

如本机尚未安装 Claude Code，可参考官方安装方式。

macOS、Linux、WSL：

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

macOS 也可以使用 Homebrew：

brew install --cask claude-code

Windows PowerShell：

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

安装完成后，在终端中执行：

claude --version

如果能够输出版本号，说明本机已可以启动 Claude Code。

接入流程​

创建彼源 AI 令牌
  -> 确认可用 Claude 模型
  -> 配置 Claude Code 环境变量
  -> 启动 Claude Code
  -> 选择模型并发送测试请求

如何接入​

1. 创建 Claude Code 专用令牌​

进入彼源 AI 控制台：

令牌管理 -> 添加令牌

建议为 Claude Code 单独创建一个令牌，例如 claude-code-mac、claude-code-work。这样后续查看消耗、停用令牌或排查问题时更清晰。

2. 确认可用模型​

在控制台中确认当前令牌可以使用的 Claude 模型。首次接入建议只选择一个模型完成验证，例如：

claude-sonnet-4-6

具体模型名称以控制台和当前令牌权限为准。

3. 在当前终端配置 endpoint 和令牌​

在启动 Claude Code 之前，先在同一个终端窗口中设置以下环境变量：

export ANTHROPIC_BASE_URL="https://api.biyuan.ai"
export ANTHROPIC_AUTH_TOKEN="<你的彼源 AI 令牌>"
export ANTHROPIC_MODEL="<模型名称>"

示例：

export ANTHROPIC_BASE_URL="https://api.biyuan.ai"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="claude-sonnet-4-6"

其中：

  • ANTHROPIC_BASE_URL：彼源 AI API endpoint。
  • ANTHROPIC_AUTH_TOKEN：彼源 AI 令牌，Claude Code 会作为 Authorization: Bearer ... 发送。
  • ANTHROPIC_MODEL：默认使用的模型名称。

请勿把真实令牌写入公开文档、截图、代码仓库或聊天记录中。

4. 启动 Claude Code​

进入需要处理的项目目录，然后启动 Claude Code：

cd /path/to/your/project
claude

进入 Claude Code 后，可以先发送一个简单请求：

请用三句话总结这个项目的用途。

如请求成功，说明 Claude Code 已经通过彼源 AI 完成调用。

5. 在 Claude Code 中选择模型​

Claude Code 支持在会话中切换模型：

/model

也可以在启动时指定模型：

claude --model claude-sonnet-4-6

如果模型选择器中没有显示目标模型，可以继续使用 ANTHROPIC_MODEL 指定模型名称。模型是否可用，以彼源 AI 控制台和当前令牌权限为准。

长期配置方式​

如果不希望每次启动前手动输入环境变量，可以写入 Claude Code 的用户配置文件：

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.biyuan.ai",
    "ANTHROPIC_AUTH_TOKEN": "<你的彼源 AI 令牌>",
    "ANTHROPIC_MODEL": "<模型名称>"
  }
}

建议优先使用用户级配置 ~/.claude/settings.json。不要把包含真实令牌的配置写入项目仓库，也不要提交到 Git。

验证方法​

完成配置后，建议按以下顺序验证：

  1. 执行 claude --version，确认 Claude Code 已安装。
  2. 在同一终端中执行 echo $ANTHROPIC_BASE_URL，确认 endpoint 已生效。
  3. 启动 claude，发送一个简单问题。
  4. 回到彼源 AI 控制台，打开「使用日志」，能看到刚才这条请求（模型、时间、消耗），说明接入成功。
  5. 如需切换模型，在 Claude Code 中执行 /model 或重新设置 ANTHROPIC_MODEL。

常见问题​

Base URL 应该填写 /v1 吗​

不需要。Claude Code 会基于 ANTHROPIC_BASE_URL 请求 Claude Messages 接口。配置彼源 AI 时填写：

https://api.biyuan.ai

不要填写：

https://api.biyuan.ai/v1

如果把 /v1 写进 Base URL，可能导致请求路径异常。

已设置令牌，但仍然要求登录​

请确认环境变量是在启动 claude 的同一个终端窗口中设置的。可以先执行：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL

如输出为空，说明当前终端没有加载配置。请重新设置环境变量，或写入 ~/.claude/settings.json。

提示 401 或 403​

常见原因包括：

  • 令牌填写错误或已失效。
  • 当前令牌没有目标模型权限。
  • 令牌额度不足或被禁用。
  • 模型名称填写错误。

建议先在彼源 AI 控制台确认令牌状态和可用模型，再重新启动 Claude Code。

模型选择器里看不到目标模型​

部分模型不会自动出现在 Claude Code 的模型选择器中。可先通过环境变量固定模型：

export ANTHROPIC_MODEL="<模型名称>"

如果需要在模型选择器中展示自定义名称，可以使用 Claude Code 的自定义模型选项：

export ANTHROPIC_CUSTOM_MODEL_OPTION="<模型名称>"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Biyuan Claude"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="通过彼源 AI 接入的 Claude 模型"

如何确认请求是否经过彼源 AI​

回到彼源 AI 控制台，打开「使用日志」，能看到刚才这条请求（模型、时间、消耗），说明请求经过了彼源 AI。如果 Claude Code 请求成功，但「使用日志」里没有这条请求，通常说明当前终端没有使用彼源 AI endpoint，或启动 Claude Code 时未加载对应环境变量。

官方参考​

继续阅读​