Claude Code
通过一键接入或环境变量将 Claude Code 连接到 HopBase。
Anthropic 官方 CLI。推荐用控制台「一键接入」,一条命令自动装好配好;懂终端的也可以手动设置环境变量。
🚀 推荐 · 控制台一键接入(自动安装 + 自动配置 + 自动验证)
不需要懂环境变量,Windows / macOS / Linux 都支持:
复制你系统对应的命令
弹窗选 Claude Code,系统按需切换 macOS / Linux 或 Windows 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 转发,用量在控制台逐笔可查。卡住了?看报错速查。