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