跳到主要內容
essevin
← 返回博客

Claude Code 國內接入完整實踐:10 分鐘從註冊到第一行補全

Read in English

Claude Code 國內接入完整實踐:10 分鐘從註冊到第一行補全

Claude Code 是目前公認最好用的 AI 編程工具之一,但在香港與中國,第一步往往就卡住:官方註冊不支援你所在的地區。好在 Claude Code 本身支援自訂 API 地址。這篇給出一條完整路徑——不用魔法、不改一行代碼,十分鐘左右完成接入。

為什麼可以這樣接

Claude Code 官方支援以環境變數指定 API 地址:ANTHROPIC_BASE_URL 指定伺服器,ANTHROPIC_AUTH_TOKEN 提供憑證。把這兩項指向 Essevin,Claude Code 就會用你的 Essevin 帳戶工作。Essevin 在國內可直接訪問,無需任何代理。

工具還是那個官方 CLI,換的只是它連接的地址與密鑰。

三步接入

第一步,到 console.essevin.com 免費註冊並登入。Essevin 採用月費訂閱,訂閱現已開放;註冊後在控制台「訂閱」頁揀選方案,即可按以下步驟使用。

第二步,進入「API key」頁面,點「新增 API key」,填寫名稱(例如 claude-code),在「用途」中選 Claude,建立一個 sk- 開頭的密鑰。

第三步,二選一完成設定:

  • 一鍵接入(推薦):點密鑰右側的「一鍵接入」,彈窗選 Claude Code 和你的系統(macOS / Linux 或 Windows PowerShell),複製命令貼到終端機執行。腳本會自動安裝 Claude Code(已裝則跳過)、備份並寫入 ~/.claude/settings.json、驗證密鑰,看到綠色「接入成功」就完成了。命令裡帶的是 15 分鐘內有效、只能使用一次的接入權杖,不會暴露密鑰本身。
  • 手動設定:在終端機設定兩個環境變數:
# Claude Code 連接 Essevin(地址不帶 /v1)
export ANTHROPIC_BASE_URL=https://api.essevin.com
export ANTHROPIC_AUTH_TOKEN=sk-你的密鑰

claude   # 正常使用,用量在控制台「使用記錄」可查

運行 claude 發起一次對話,看到正常回覆,接入就完成了。手動設定想長期生效,把這兩行寫進 ~/.zshrc 或 ~/.bashrc;Windows 用 setx 寫入用戶環境變數後重開終端機。偏好圖形介面、或需要在多個供應商之間切換,可以用 CC Switch;完整說明見 Claude Code 接入文檔。

三個最常見的坑

  • 環境變數沒生效:改完 shell 設定檔後要開新終端機或 source 一次;IDE 裡啟動的終端機可能不讀取你的 shell 設定。
  • 地址多寫了 /v1,或用錯了密鑰:Claude Code 走 Anthropic 協議,地址是 https://api.essevin.com,不帶 /v1(否則請求會變成 /v1/v1/messages);密鑰必須是用途為 Claude 的那一把,GPT 用途的密鑰不能用於 Claude Code。這兩種配錯都會返回 404。
  • 公司代理干擾:企業內網的 HTTPS 代理可能改寫請求頭,遇到奇怪的 401/403 時先在無代理環境驗證。

按任務切換模型

一把 Claude 密鑰可以使用方案包含的 Claude 模型。會話中輸入 /model 選擇,或啟動時加 --model:

模型適用場景特點
claude-opus-5-5複雜重構、跨檔案推理能力最強,扣點最多
claude-sonnet-5-5日常開發主力官方單價約為 Opus 5.5 的一半
claude-haiku-5-5簡單改動、批量小任務單價最低

以上 ID 只是示例,以當前密鑰調用 GET https://api.essevin.com/v1/models 返回的為準。

驗證與用量透明

發起一次請求後,控制台「使用記錄」會出現這條記錄——模型、token 數與扣掉的點數一一對應。Essevin 採用固定月費訂閱,對話、圖片與影片共用每月點數,按實際用量扣、每月重設,沒有按量收費的餘額。prompt cache 命中的部分按較低的緩存價折算,Claude Code 這類會話式工具的緩存命中比例通常相當可觀,實際扣點往往低於按牌價的直覺估算。訂閱現已開放,到 essevin.com 看清楚各方案,再到 console.essevin.com 免費註冊並訂閱。