工具接入

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 轉發,用量在控制檯逐筆可查。卡住了?看報錯速查

本頁目錄