HopBaseClaude Code 是目前公認最好用的 AI 編程工具，但國內直連官方 API 時斷時續：高峰期超時、請求中途斷流、賬號莫名受限。這篇文章給出一條經過大量用戶驗證的穩定路徑——不用魔法、不改一行代碼，兩個環境變數完成接入。
為什麼需要一層網關
直連官方最大的問題不是「連不上」，而是不確定。跨境鏈路的抖動你控制不了，上游的風控你預測不了，而寫代碼的人最怕的恰恰是「剛才還好好的」。網關做的事，是把這些不確定性擋在你的工作流之外：多上游調度、失敗自動切換、請求級計費透明。
網關的價值不在於轉發本身，而在於把「上游的不確定性」擋在你的工作流之外。
三步接入
第一步，註冊並登入控制台，在「API Key」頁新建一個 Key。第二步，在終端裡設定兩個環境變數：
# 一行環境變數，Claude Code 直連網關
export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=你的Key
claude # 正常使用，用量在控制台實時可見第三步，運行 claude 發起一次對話。看到補全正常返回，接入就完成了。想長期生效，把這兩行寫進 ~/.zshrc 或 ~/.bashrc 即可。
三個最常見的坑
- 環境變數沒生效：改完 shell 配置文件後要開新終端或
source一次；IDE 裡啟動的終端可能不讀取你的 shell 配置。 - Key 權限對不上：一個 Key 綁定一個計費分組，如果提示模型不可用，先到控制台確認該分組是否包含你要用的模型。
- 公司代理干擾：企業內網的 HTTPS 代理可能改寫請求頭，遇到奇怪的 401/403 時先在無代理環境驗證。
按需選擇分組
同一個 Key 可以使用你所在分組的全部模型，不同分組對應不同的價格與調度策略：
| 分組 | 適用場景 | 特點 |
|---|---|---|
| 穩定組 | 日常開發、生產整合 | 多上游調度，自動 failover |
| 高速組 | 互動式重度使用 | 首字延遲優先 |
| 經濟組 | 批量任務、離線處理 | 單價最低 |
驗證與計費透明
發起一次請求後，控制台的用量頁會立刻出現這條記錄——模型、token 數、緩存命中與費用一一對應。prompt cache 命中的部分按折扣價計費，Claude Code 這類會話式工具的緩存命中比例通常相當可觀，實際成本往往低於按牌價的直覺估算。