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