跳至正文
上新Nano Banana 2.1 已上線：Google 新一代生圖模型，單張低至 $0.0336，原生 4K，約上一代半價查看模型
HopBase
← 返回博客

團隊統一設定 AI 程式設計工具:Codex CLI/Cursor/Cline | HopBase

HopBase 2026年11月05日 13 分鐘閱讀

團隊統一設定 AI 程式設計工具,核心只有兩步:管理員發給每位開發者一把帶額度、帶對應分組的 Key;開發者依工具選對協定、填好 Base URL。Claude 模型一律走 Anthropic Messages,Base URL 填 https://api.hop-base.com(不帶 /v1);GPT、Gemini、GLM 走 OpenAI 相容,填 https://api.hop-base.com/v1。Claude Code 用 ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN,Codex CLI 用 config.toml 加 OPENAI_API_KEY,Cursor、Cline、Roo Code、Continue、Trae 在設定裡選供應商類型即可。

先看這張表:每個工具走哪個協定

工具模型協定 / 供應商類型Base URL設定位置
Claude CodeClaudeAnthropic Messageshttps://api.hop-base.comANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN,或 ~/.claude/settings.json
Codex CLIGPTOpenAI Responses(wire_api = "responses")https://api.hop-base.com/v1~/.codex/config.toml + OPENAI_API_KEY
CursorGPT / Gemini / GLMOverride OpenAI Base URLhttps://api.hop-base.com/v1Cursor Settings → Models
CursorClaudeAnthropic API Key 欄位https://api.hop-base.comCursor Settings → Models(需較新版本)
Cline / Roo CodeGPT / ClaudeOpenAI Compatible / AnthropicGPT 帶 /v1,Claude 不帶外掛設定 → API Provider
ContinueGPT / Claudeprovider: openai / provider: anthropic同上~/.continue/config.yaml
TraeGPT / ClaudeOpenAI 相容 / Anthropic同上設定 → 模型 → 新增模型

Zed、JetBrains AI 等其他編輯器同理:Claude 用 Anthropic 類型,其他模型用 OpenAI 相容類型。最常見的兩種設定錯誤:Base URL 多寫了 /v1(請求變成 /v1/v1/messages),或用 Claude 分組的 Key 選了 OpenAI Compatible,兩者都會回傳 404「目前平台不支援該 API 路徑」。

第一步:管理員發 Key 給每位開發者

  1. 建部門。在企業主控台依團隊建部門(如「後端組」「前端組」),設定部門月度額度。部門負責人會收到本部門的額度預警。
  2. 新增成員並設成員額度。成員以電子郵件與密碼登入,自行建立密鑰;成員額度由其名下所有密鑰共用。
  3. 依工具分 Key。建議一個工具一把 Key:Claude Code 用含 Claude 分組的 Key,Codex CLI 用含 Codex Plus 或 Codex Pro 分組的 Key。每把 Key 可含 1–10 個分組,只能呼叫這些分組的模型。注意 Claude Max(ccmax)分組僅限 Claude Code 用戶端,在 Cursor、Cline 等編輯器要用 Claude Max 企業版分組的 Key。
  4. 為 Key 加上限制。依需要設定 Key 額度、到期時間、IP 名單與並發。Claude Code 計算 token 的 count_tokens 請求也會占用並發,設定時要預留空間。
  5. 設定餘額預警。依可用餘額設多檔門檻,跌破時發送電子郵件與站內通知。

額度用完時,請求在處理前即被拒絕(HTTP 402 insufficient_quota),不會產生費用。部門與成員的月度額度於帳期日(每月 1–28 號)統一重置。

第二步:開發者設定各個工具

Claude Code

建議用主控台「一鍵接入」:在「API 密鑰」點密鑰右側的「一鍵接入」,選 Claude Code 與作業系統,產生指令後貼到終端機執行。指令使用 15 分鐘內有效、只能用一次的接入權杖,不會在指令中暴露密鑰。腳本把設定寫入 ~/.claude/settings.json 的 env(原檔先備份);之後在 shell 設定的同名環境變數不會生效,要換 Key 請改這個檔案或重新一鍵接入。

手動設定(macOS / Linux):

export ANTHROPIC_BASE_URL=https://api.hop-base.com
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

工作階段中用 /model 切換模型,或啟動時加 --model claude-sonnet-5-5。完整步驟見 Claude Code 接入文件,個人從註冊到第一次補全的實作見 Claude Code 接入完整實踐。

Codex CLI

Codex CLI 同樣支援一鍵接入,也可以手動在 ~/.codex/config.toml(Windows 為 C:\Users\你的使用者名稱\.codex\config.toml)寫入:

model_provider = "hopbase"
model = "gpt-5.6-sol"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

再設定 export OPENAI_API_KEY=sk-your-key 後執行 codex。三點注意:

  • 手動設定用 env_key,一鍵接入用 requires_openai_auth = true 加 ~/.codex/auth.json,兩種寫法不要混用,否則會回傳 401 missing_api_key。
  • 一鍵接入預設 model_reasoning_effort = "xhigh",token 消耗最多;團隊日常可改為 high 或 medium。
  • 聯網搜尋(/v1/alpha/search)與遠端上下文壓縮(/v1/responses/compact)目前不支援,會回傳 404;不影響一般對話。

詳見 Codex CLI 接入文件。

Cursor

  • GPT / Gemini / GLM:在 Cursor Settings → Models 的 API Keys 填入對應分組的 Key,開啟「Override OpenAI Base URL」,填 https://api.hop-base.com/v1,再加入模型 ID。
  • Claude:用 Anthropic API Key 欄位,Anthropic Base URL 填 https://api.hop-base.com(不帶 /v1,需較新版本 Cursor)。

Cursor 的 Tab 補全等內建功能仍使用 Cursor 自己的服務,這裡的設定只影響 Chat 中選取的自訂模型。

Cline / Roo Code

外掛設定 → API Provider:GPT 模型選「OpenAI Compatible」,Base URL 填 https://api.hop-base.com/v1;Claude 模型選「Anthropic」,Base URL 填 https://api.hop-base.com。再填 API Key 與 Model ID,儲存即可。

Continue

# ~/.continue/config.yaml
models:
  - name: HopBase GPT
    provider: openai
    model: gpt-5.6-sol
    apiBase: https://api.hop-base.com/v1
    apiKey: sk-your-key
  - name: HopBase Claude
    provider: anthropic
    model: claude-sonnet-5-5
    apiBase: https://api.hop-base.com
    apiKey: sk-your-key

兩個 apiKey 分別填對應分組的 Key。Trae 的路徑是:設定 → 模型 → 新增模型,GPT 選「OpenAI 相容」,Claude 選「Anthropic」。各編輯器完整說明見編輯器 / IDE 接入文件。

第三步:驗證與排錯

  1. 確認模型 ID:用這把 Key 呼叫 GET /v1/models,只使用回傳清單中的 ID。 
    curl https://api.hop-base.com/v1/models -H "Authorization: Bearer sk-your-key"
  2. 最小測試:在工具裡選取新模型,傳送「只回覆 ok」。通過後再開啟工具呼叫、圖片與長上下文。
  3. 依錯誤排查:404 先查 /v1 是否多寫或漏寫、Claude 是否誤選 OpenAI 類型;401 查 Key 是否正確、Codex 是否混用兩種密鑰寫法;402 代表額度用完,請管理員調整額度。

上線後怎麼管

  • 看消耗:用量頁可依日期、Key、成員、部門、Key 建立者篩選並匯出 CSV。依工具分 Key 之後,就能直接看出 Claude Code 與 Codex CLI 各花了多少。
  • 查操作:額度調整、密鑰建立與停用等操作全程留痕,可依時間與對象查詢。
  • 離職回收:停用成員後,其名下所有密鑰立即失效;單把 Key 也能隨時停用或撤銷,不影響其他人。

準備讓團隊接入:註冊 HopBase,建立企業帳號後新增成員與部門。

常見問題

Codex CLI 怎麼自訂 base url?

在 ~/.codex/config.toml 新增一個 model_providers.hopbase,base_url 填 https://api.hop-base.com/v1,wire_api 填 responses,env_key 填 OPENAI_API_KEY,再把 model_provider 設為 hopbase。Key 要用 Codex Plus 或 Codex Pro 分組的。

Cursor 自訂 API 能用 Claude 嗎?

可以。不要用 Override OpenAI Base URL,而是在 Anthropic API Key 欄位填 Claude 分組的 Key,Anthropic Base URL 填 https://api.hop-base.com(不帶 /v1)。需要較新版本的 Cursor;Tab 補全仍走 Cursor 自己的服務。

團隊幾十人一起用 Claude Code,怎麼避免有人用超?

三級額度疊加:部門額度封頂整組,成員額度封頂個人,Key 額度封頂單一工具。任一層用完,請求在處理前就被拒絕(HTTP 402),不會產生費用。成員額度總和超過部門額度時先用先得。

企業教學