工具接入

Claude Code

通过一键接入或环境变量将 Claude Code 连接到 HopBase。

Anthropic 官方 CLI。推荐用控制台「一键接入」,一条命令自动装好配好;懂终端的也可以手动设置环境变量。

🚀 推荐 · 控制台一键接入(自动安装 + 自动配置 + 自动验证)

不需要懂环境变量,Windows / macOS / Linux 都支持:

找到一键接入按钮

登录控制台 → 「密钥管理」,点密钥右侧的 🚀「一键接入」。

复制你系统对应的命令

弹窗选 Claude Code,系统按需切换 macOS / LinuxWindows PowerShell,点复制。

贴到终端,按 Enter

macOS 开「终端」,Windows 开「PowerShell」(开始菜单搜寻即可)。脚本会自动安装 Claude Code(已装则跳过)、写入密钥配置(原配置自动备份)并验证连接。

看到绿色「接入成功」就完成了

新开一个终端视窗,输入 claude 开始使用。

🔒 命令里带的是一次性接入令牌(15 分钟有效、只能用一次),不是密钥本身,泄露也不影响帐户安全。

⚡ 图形化 · 用 CC Switch 管理(适合怕命令行 / 多配置切换)

CC Switch 是免费的桌面小程序(Windows / macOS),点按钮就能完成连接,控制台已内置一键导入。

安装 CC Switch 桌面应用

Windows 下载 .msi、macOS 下载 .dmg;Windows 若弹蓝色「保护你的电脑」,点「其他信息 → 仍要执行」。

控制台一键导入

「密钥管理」里点密钥旁的「导入 CCS」,选择 Claude Code,浏览器会唤起 CC Switch 并自动填好地址与密钥。

在 CC Switch 里点 Enable 启用

支持热切换,无需重启终端。

手动配置 · macOS / Linux(zsh / bash)

临时设置(只在当前终端视窗有效,关窗即失效):

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥

# 然后正常启动
claude

永久写入配置(推荐,写进 shell 启动档,以后开窗即用):

# zsh(macOS 默认)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

# bash(Linux 常见;与上面 zsh 二选一)
echo 'export ANTHROPIC_BASE_URL=https://api.hop-base.com' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

手动配置 · Windows(PowerShell)

临时设置(只在当前 PowerShell 视窗有效):

$env:ANTHROPIC_BASE_URL = "https://api.hop-base.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"

# 然后正常启动
claude

永久设置(写入系统环境变量,设置后要关闭并重新开启终端才生效):

setx ANTHROPIC_BASE_URL "https://api.hop-base.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

✅ 请使用 Claude 套餐(Claude Max / Claude Kiro / AWS Bedrock 分组) 的密钥。设置后 Claude Code 的所有请求都会经 HopBase 转发,用量在控制台逐笔可查。卡住了?看报错速查

本页目录