Claude Code 接入

选择支持 Anthropic 的 Claude 线路,配置 Orbis 地址、模型与 Key,核对实际调用。

将已安装的 Claude Code CLI 接到 Orbis。还没安装,或想跟着做一个完整项目?看 Claude Code 新手入门图文教程。

1. 选模型和线路,获取 Key

打开 模型广场,选择 Claude 模型,再选支持 Anthropic Messages 的线路,为它 创建 Key。例如 Claude Haiku 5.5 的 Claude Code · AH线路。

文档适用于 Claude 系列;实际可用的模型和协议以所选线路为准。Key 绑定线路,只改模型 ID 不会换线路。主模型与后台小模型都必须在该 Key 的可用范围内。

2. 配置地址与模型

在线路的 快速接入 → 工具接入 → Claude Code 中,选择刚创建的 Key,按生成配置合并到 ~/.claude/settings.json;Windows 对应 %USERPROFILE%\.claude\settings.json。已有文件先备份,保留其他设置。

以 Haiku 为例,文件的 env 中包含:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.orbiorbi.com",
    "ANTHROPIC_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

地址末尾不加 /v1。换模型时使用接入页给出的精确 ID,并检查后台小模型的配置。

3. 输入 Key 并启动

在准备使用的项目目录打开终端,选对应系统的命令。提示出现后粘贴 Key,输入不会显示。

$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new('', (Read-Host '粘贴 Orbis Key' -AsSecureString)).Password
claude
# macOS 默认终端 Zsh
printf '粘贴 Orbis Key:'
read -rs ANTHROPIC_AUTH_TOKEN
printf '\n'
export ANTHROPIC_AUTH_TOKEN
claude

密钥变量只供当前终端及它启动的程序使用;新开终端需重新输入。已有 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 时,先确认凭据来源,避免同时启用多套认证。编辑器扩展的环境另按 Claude Code 官方网关说明 配置。

4. 确认接通

  1. 输入 /status,核对 Orbis 地址、凭据来源、模型和工作目录。
  2. 发送“只回复 OK”,到 使用日志 核对请求的模型、线路与扣费。这一步会消耗 API 额度。
  3. 再让它读取练习目录的一份小文件,确认出现真实工具记录;普通回复成功不等于全部工具都兼容。
现象检查什么
401 / 要求重新登录当前进程是否获得 Key,是否有旧认证配置覆盖
404 / 模型不存在地址不带 /v1,模型 ID 精确匹配,Key 属于所选线路
主对话正常,小任务失败后台小模型是否也在该线路的可用范围内
429 / 无额度账户余额、Key 限额与线路限制

需要安装、切回官方账号、文件修改与完整练习,继续看 图文教程。