Model Bay API 使用教學¶

歡迎來到 Model Bay 使用教學，您可以在這裡找到您的工具接入方式。

統一參數¶

Base URL：https://model-bay.com/v1
API Key：Model Bay Key（以 sk- 開頭）
模型填寫：以 /v1/models 返回的可用模型名稱為準

目前文件涵蓋內容¶

Claude Code 安裝與設定指南
Gemini CLI 設定指南
Codex 設定指南
Cursor 設定 API Key 指南
Cherry Studio 設定 API Key 指南
VS Code 外掛 Kilo 設定教學
Opencode 設定教學
OpenClaw 設定

Claude Code 安裝與設定指南¶

1. 安裝 Claude Code¶

方式一：本機安裝（推薦）¶

本機安裝是官方推薦方式，優點包括：

自帶可執行檔
無需依賴 Node.js
自動更新較穩定

Homebrew（macOS、Linux）macOS、Linux、WSLWindows PowerShellWindows CMD

brew install --cask claude-code

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

方式二：NPM 安裝¶

適用於偏好或需要 NPM 的環境：

npm install -g @anthropic-ai/claude-code

注意：不要使用 sudo npm install -g，這可能導致權限問題與安全風險。

Windows 額外說明¶

選項 1：在 WSL 中執行（支援 WSL 1 與 WSL 2）
選項 2：在本機使用 Git Bash 執行（需安裝 Git for Windows）

安裝完成後，進入專案目錄並啟動：

cd your-awesome-project
claude

詳細資訊可參考官方文件：https://code.claude.com/docs/zh-CN/setup#安装

Claude Code 設定檔指南¶

本文說明如何透過使用者目錄下 .claude 資料夾中的 JSON 設定檔管理 Claude Code 的全域設定（例如編輯器偏好、自動更新、權限控制等）。

1. 方式一：手動設定檔位置¶

先在 .claude.json 中加入以下內容，啟動時便不需要輸入 account。

檔案路徑：

Windows: C:\Users\<使用者名稱>\.claude.json
macOS / Linux: ~/.claude.json

Claude Code 的設定檔位於使用者主目錄（Home Directory）下的隱藏資料夾 .claude 中。

檔案路徑：

Windows: C:\Users\<使用者名稱>\.claude\settings.json
macOS / Linux: ~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://model-bay.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

補充：第一次安裝好 Claude Code 之後，需要先完成初始化，系統才能辨識 settings.json。因此需要先設定以下臨時變數來初始化 Claude Code。初始化完成後，下次開啟便可直接使用 settings.json 內的設定。

PowerShell 設定臨時變數¶

$env:ANTHROPIC_BASE_URL="https://model-bay.com/v1"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"
claude

CMD 設定臨時變數¶

set ANTHROPIC_BASE_URL=https://model-bay.com/v1
set ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxx
claude

macOS / Linux 設定臨時變數¶

export ANTHROPIC_BASE_URL="https://model-bay.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxx"
claude

常見問題¶

Windows 安裝後提示找不到指令：重新開啟終端機，並確認 %APPDATA%\npm 已加入 PATH
settings.json 寫好後未生效：先用臨時環境變數啟動一次 claude
提示權限不足：使用系統管理員 PowerShell 重試，或執行 npm config set prefix "$env:APPDATA\npm"

VS Code 整合本機 Claude Code¶

2. 方式二：使用 CC Switch 進行設定¶

點擊下載連結進入 CC Switch 的 GitHub Release 頁面
捲動至頁面底部，選擇適合自己版本的安裝套件
Windows 系統建議下載一般 .msi 副檔名的安裝檔進行安裝

Claude Code 設定¶

開啟你下載的 CC Switch 軟體
在分組列中，把分組切換至 Claude
在供應商分組中，選擇自訂設定
輸入以下模板設定，並將 ANTHROPIC_AUTH_TOKEN 替換成自己的 API Key。此時需要為這個 API 設定一個名稱，可自行命名。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://model-bay.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx"
  }
}

新增成功後，主畫面會顯示你設定的分組；在右側點擊「啟用」按鈕，顯示「使用中」即表示設定完成
在終端機執行 claude，若看到對話介面並可正常回覆，即表示設定完成

Gemini CLI 設定指南¶

按照以下步驟完成接入，即可透過 Model Bay 使用 Gemini CLI 模型呼叫服務。

前置條件：安裝 Gemini CLI¶

請先確認已安裝 Node.js（v20 或以上版本），然後透過 npm 全域安裝：

npm install -g @google/gemini-cli

安裝完成後，確認是否成功：

gemini --version

如需升級到最新版本：

npm upgrade -g @google/gemini-cli

方式一：環境變數設定（推薦）¶

透過設定環境變數，將 Gemini CLI 指向 Model Bay 平台。

macOS / Linux¶

export GOOGLE_GEMINI_BASE_URL="https://model-bay.com/v1"
export GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"

如需永久生效，可將以上兩行加入 Shell 設定檔：

# 加入 ~/.bashrc 或 ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://model-bay.com/v1"' >> ~/.bashrc
echo 'export GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell¶

$env:GOOGLE_GEMINI_BASE_URL="https://model-bay.com/v1"
$env:GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"

如需永久生效，可將以上兩行加入 PowerShell 設定檔：

# 加入 $PROFILE
Add-Content $PROFILE 'Set-Item -Path Env:GOOGLE_GEMINI_BASE_URL -Value "https://model-bay.com/v1"'
Add-Content $PROFILE 'Set-Item -Path Env:GEMINI_API_KEY -Value "sk-xxxxxxxxxxxxxxxx"'

Windows CMD¶

set GOOGLE_GEMINI_BASE_URL=https://model-bay.com/v1
set GEMINI_API_KEY=sk-xxxxxxxxxxxxxxxx

如需永久生效（系統層級）：

按 Win + R，輸入 sysdm.cpl，然後按 Enter
點擊「進階」→「環境變數」
在「使用者變數」中按「新增」，分別加入 GOOGLE_GEMINI_BASE_URL 與 GEMINI_API_KEY
重新開啟終端機使變數生效

方式二：`.env` 檔案設定¶

Gemini CLI 支援自動從 .env 檔案載入變數。在使用者主目錄下建立 .gemini/.env 檔案：

檔案路徑：

Windows: C:\Users\<使用者名稱>\.gemini\.env
macOS / Linux: ~/.gemini/.env

GOOGLE_GEMINI_BASE_URL="https://model-bay.com/v1"
GEMINI_API_KEY="sk-xxxxxxxxxxxxxxxx"

說明：Gemini CLI 會依以下順序尋找 .env 檔案：

目前專案目錄 .gemini/.env
使用者主目錄 ~/.gemini/.env
~/.env

找到第一個後便停止，不會合併多個檔案。

指定模型（可選）¶

如需指定預設模型，可額外設定 GEMINI_MODEL 環境變數。

macOS / Linux¶

export GEMINI_MODEL="gemini-2.5-pro"

Windows PowerShell¶

$env:GEMINI_MODEL="gemini-2.5-pro"

或在 .gemini/.env 中加入：

GEMINI_MODEL="gemini-2.5-pro"

亦可在啟動時透過命令列參數指定：

gemini --model gemini-2.5-pro

驗證設定¶

設定完成後，在終端機執行以下命令啟動 Gemini CLI：

gemini

啟動後輸入對話內容，若所有設定正確，Gemini CLI 便會成功連接至 Model Bay 平台。

可使用 /auth 指令查看目前的驗證方式，並選擇 Use Gemini API key。

常見問題¶

提示 `GEMINI_API_KEY` 未設定¶

檢查環境變數是否已正確設定（注意變數名稱拼寫）
如使用 .env 檔案，確認檔案路徑是否正確（應為 ~/.gemini/.env，而不是 ~/.gemini.env）
Windows 使用者在設定系統變數後，需重新開啟終端機

連線逾時或報錯¶

確認 GOOGLE_GEMINI_BASE_URL 的值為 https://model-bay.com/v1（注意結尾不要多加 /）
檢查網絡連線是否正常
確認 API Key 有效且未過期

如何切換模型¶

方法 1：設定 GEMINI_MODEL 環境變數
方法 2：啟動時使用 gemini --model <模型名> 參數
方法 3：在 .gemini/.env 中指定 GEMINI_MODEL

Codex 設定指南¶

按照以下步驟完成接入，即可透過 Model Bay 使用 Codex 模型呼叫服務。

前置條件：安裝 Codex¶

方式一：透過 npm 全域安裝（推薦）¶

請先確認已安裝 Node.js（v22 或以上版本），然後執行：

npm install -g @openai/codex

方式二：使用 yarn 安裝¶

yarn global add @openai/codex

安裝完成後，確認是否成功：

codex --version

步驟 1：設定 `config.toml` 檔案¶

找到並編輯 config.toml（如不存在則建立新檔），填入以下內容：

model_provider = "model-bay"
model = "gpt-5.3-codex"

[model_providers.model-bay]
name = "model-bay"
base_url = "https://model-bay.com/v1"
wire_api = "responses"
requires_openai_auth = true

檔案路徑¶

Windows: C:\Users\<使用者名稱>\.codex\config.toml
macOS: /Users/<使用者名稱>/.codex/config.toml
Linux: ~/.codex/config.toml

步驟 2：設定 `auth.json` 檔案¶

找到並編輯 auth.json（如不存在則建立新檔），將 OPENAI_API_KEY 的值替換成你在後台產生的金鑰：

{
  "OPENAI_API_KEY": "你的金鑰"
}

檔案路徑¶

Windows: C:\Users\<使用者名稱>\.codex\auth.json
macOS: /Users/<使用者名稱>/.codex/auth.json
Linux: ~/.codex/auth.json

驗證設定¶

設定完成後，在終端機執行以下命令啟動 Codex：

codex

如果一切設定正確，Codex 會成功連接到 Model Bay 平台，並使用 gpt-5.3-codex 模型。

常見問題¶

提示找不到 `config.toml` 或 `.codex` 目錄？¶

請手動建立 .codex 目錄：

# Windows (PowerShell)
mkdir "$env:USERPROFILE\.codex"

# macOS / Linux
mkdir -p ~/.codex

提示驗證失敗？¶

檢查 auth.json 中的金鑰是否正確（以 sk- 開頭）
確認金鑰沒有多餘的空格或換行符號
確認金鑰未過期，可在後台令牌管理中查看狀態

如何更換模型？¶

編輯 config.toml，把 model 欄位修改為平台支援的其他模型名稱即可。

Cursor¶

在 Settings -> Models 中填寫：

啟用 OpenAI API Key
填入 Model Bay Key
啟用 Override OpenAI Base URL
填入 https://model-bay.com/v1

如果模型列表沒有自動出現，可以手動新增一個可用模型。

回到會話頁並啟用該模型即可。

Cherry Studio¶

7.1 新增模型服務¶

打開：

設定 -> 模型服務 -> 新增

供應商類型選擇：

Anthropic

填入：

API 地址：https://model-bay.com/v1
API Key：Model Bay Key

7.2 取得模型¶

點擊底部管理頁中的重新整理按鈕，自動取得模型，然後把需要的模型加入即可。

VS Code 外掛 Kilo¶

8.1 選擇供應商¶

先把 API 供應商選成：

Anthropic

8.2 啟用自訂基礎 URL¶

填寫：

Base API 地址：https://model-bay.com/v1
API Key：Model Bay Key

8.3 測試¶

填好後測試模型回覆，若能成功返回，即表示設定完成。

OpenCode¶

1、建立設定檔¶

在你的使用者目錄下建立檔案：

C:\Users\<你的使用者名稱>\opencode.json

💡 提示：把「你的使用者名稱」換成你自己的，例如：

C:\Users\Administrator\opencode.json

可直接在檔案總管地址列輸入 .opencode.json 並按 Enter 建立。

填入以下內容（把 apiKey 替換成你自己的）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "zenchao": {
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "haiku 4.5"
        },
        "claude-opus-4-5-20251101": {
          "name": "opus 4.5"
        },
        "claude-opus-4-6": {
          "name": "opus 4.6"
        },
        "claude-sonnet-4-5-20250929": {
          "name": "sonnet 4.5"
        },
        "claude-sonnet-4-6": {
          "name": "sonnet 4.6"
        }
      },
      "npm": "@ai-sdk/anthropic",
      "options": {
        "apiKey": "sk-***",
        "baseURL": "https://model-bay.com/v1"
      }
    }
  }
}

2、設定環境變數¶

OpenCode 不會自動讀取上面的檔案，必須手動指定路徑：

按 Win + R
輸入 sysdm.cpl，然後按 Enter
點擊「進階」→「環境變數」
在「使用者變數」中按「新增」

填入：

變數名稱：OPENCODE_CONFIG
變數值：C:\Users\<你的使用者名稱>\opencode.json

⚠️ 重啟 PowerShell 或 CMD。

3、保存 API 金鑰¶

執行：

opencode auth login

然後：

Provider ID 輸入：model-bay
選擇：Other
輸入你的 API Key（例如 sk-xxxxxx）

4、驗證¶

執行：

opencode

進入介面後輸入：

/models

如果看到模型列表，表示設定成功。

OpenClaw¶

1. 打開設定檔¶

Web UI 方式¶

openclaw dashboard

然後在 Web UI 左側進入：

Config > Raw

終端方式¶

nano ~/.openclaw/openclaw.json

2. 填入設定¶

{
  "gateway": {
    "mode": "local"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "model-bay/claude-sonnet-4-5-20250929"
      },
      "models": {
        "model-bay/claude-sonnet-4-5-20250929": {},
        "model-bay/claude-haiku-4-5-20251001": {},
        "model-bay/claude-opus-4-5-20251101": {},
        "model-bay/claude-opus-4-6": {}
      }
    },
    "models": {
      "mode": "merge",
      "providers": {
        "model-bay": {
          "baseUrl": "https://model-bay.com/v1",
          "apiKey": "sk-xxxxx",
          "api": "anthropic-messages",
          "models": [
            {
              "id": "claude-haiku-4-5-20251001",
              "name": "claude-haiku-4-5-20251001",
              "reasoning": false,
              "input": ["text"],
              "cost": {
                "input": 0,
                "output": 0,
                "cacheRead": 0,
                "cacheWrite": 0
              },
              "contextWindow": 200000,
              "maxTokens": 64000
            },
            {
              "id": "claude-opus-4-5-20251101",
              "name": "claude-opus-4-5-20251101",
              "reasoning": false,
              "input": ["text"],
              "cost": {
                "input": 0,
                "output": 0,
                "cacheRead": 0,
                "cacheWrite": 0
              },
              "contextWindow": 200000,
              "maxTokens": 64000
            },
            {
              "id": "claude-sonnet-4-5-20250929",
              "name": "claude-sonnet-4-5-20250929",
              "reasoning": false,
              "input": ["text"],
              "cost": {
                "input": 0,
                "output": 0,
                "cacheRead": 0,
                "cacheWrite": 0
              },
              "contextWindow": 200000,
              "maxTokens": 64000
            },
            {
              "id": "claude-opus-4-6",
              "name": "claude-opus-4-6",
              "reasoning": false,
              "input": ["text"],
              "cost": {
                "input": 0,
                "output": 0,
                "cacheRead": 0,
                "cacheWrite": 0
              },
              "contextWindow": 200000,
              "maxTokens": 128000
            }
          ]
        }
      }
    }
  }
}

3. 儲存設定¶

如果在 Web UI 中修改：

先點擊右上角 Save
再點擊 Update

如果在終端中修改，儲存後執行：

openclaw gateway restart

Chatbox¶

在 Chatbox 的模型 / API 設定中填入：

Provider：OpenAI API
API Host / Base URL：https://model-bay.com/v1
API Key：Model Bay Key
Model：/v1/models 列表中的可用模型

常見錯誤：

401：Key 複製錯了，或不是 Model Bay 的 Key
404：Base URL 少了 /v1

騰訊 WorkBuddy¶

不同版本入口名稱可能不同，但核心是找到：

自訂模型
OpenAI 相容
自訂 API

建議填寫：

API Base URL：https://model-bay.com/v1
API Key：Model Bay Key
Model：/v1/models 列表中的可用模型

通用排障¶

報錯	常見原因	處理方法
401	Key 錯誤 / 多空格 / 不是 Model Bay Key	重新複製 Key，確認以 `sk-` 開頭
403	權限不足 / 額度不足 / 帳號被限制	在 Model Bay 控制台檢查額度、帳號狀態和可用模型權限
404	Base URL 填錯	按對應客戶端章節確認是否需要 `/v1`
429	觸發限流	稍後重試，降低併發
5xx	上游波動	退避重試，必要時記錄 request id 並提交客服
Model not found	模型名稱不正確	改用 `/v1/models` 返回的可用模型

高頻問題：

Claude Code 連不上：多數是把 ANTHROPIC_BASE_URL 錯寫成帶 /v1 的地址
OpenAI 相容客戶端報 404：多數是 Base URL 少了 /v1
OpenCode 不生效：通常是沒有設定 OPENCODE_CONFIG
Windows 設定環境變數後仍未生效：請重新開啟終端機後再試

參考文件¶

Claude Code 官方文件：https://code.claude.com/docs/en/overview#native-install-recommended
Node 安裝參考文件：https://blog.csdn.net/2509_94001037/article/details/156696400
CC Switch 參考文件：https://docs.packyapi.com/docs/ccswitch/
Cherry Studio 參考文件：https://docs.cherry-ai.com/
Opencode 參考文件：https://opencode.ai/docs
Opencode 設定參考文件：https://zhuanlan.zhihu.com/p/1992957270024283486

Galileo AI¶

若你使用 Galileo AI 的自訂供應商設定（Custom），可直接使用以下範本。

重點：

endpoint 請使用 Model Bay 網站 API 位址：https://model-bay.com/v1
YOUR_API_KEY_HEADER、YOUR_API_KEY_VALUE 請替換為你的實際設定

{
  "authentication_type": "api_key",
  "api_key_header": "YOUR_API_KEY_HEADER",
  "api_key_value": "YOUR_API_KEY_VALUE",
  "model_properties": [
    {
      "name": "gpt-5.2-codex",
      "alias": "GPT 5.2 Codex",
      "supported_parameters": [
        "max_tokens",
        "n",
        "reasoning_effort",
        "stop_sequences",
        "temperature",
        "tool_choice",
        "tools",
        "verbosity"
      ]
    },
    {
      "name": "gpt-5.3-codex",
      "alias": "GPT 5.3 Codex",
      "based_on": "gpt-5.3-codex"
    },
    {
      "name": "gpt-5.3-codex-spark",
      "alias": "GPT 5.3 Codex Spark",
      "based_on": "gpt-5.3-codex-spark"
    },
    {
      "name": "gpt-5.4",
      "alias": "GPT 5.4",
      "based_on": "gpt-5.4"
    },
    {
      "name": "gpt-5.5",
      "alias": "GPT 5.5",
      "based_on": "gpt-5.5"
    },
    {
      "name": "claude-haiku-4-6",
      "alias": "Claude Haiku 4.6",
      "based_on": "Claude Haiku 4.6"
    },
    {
      "name": "claude-opus-4-6",
      "alias": "Claude Opus 4.6",
      "based_on": "Claude Opus 4.6"
    },
    {
      "name": "claude-opus-4-7",
      "alias": "Claude Opus 4.7",
      "based_on": "Claude Opus 4.7"
    },
    {
      "name": "claude-sonnet-4-6",
      "alias": "Claude Sonnet 4.6",
      "based_on": "Claude Sonnet 4.6"
    }
  ],
  "endpoint": "https://model-bay.com/v1"
}

Model Bay API 使用教學¶

統一參數¶

目前文件涵蓋內容¶

Claude Code 安裝與設定指南¶

1. 安裝 Claude Code¶

方式一：本機安裝（推薦）¶

方式二：NPM 安裝¶

Windows 額外說明¶

Claude Code 設定檔指南¶

1. 方式一：手動設定檔位置¶

PowerShell 設定臨時變數¶

CMD 設定臨時變數¶

macOS / Linux 設定臨時變數¶

常見問題¶

VS Code 整合本機 Claude Code¶

2. 方式二：使用 CC Switch 進行設定¶

Claude Code 設定¶

Gemini CLI 設定指南¶

前置條件：安裝 Gemini CLI¶

方式一：環境變數設定（推薦）¶

macOS / Linux¶

Windows PowerShell¶

Windows CMD¶

方式二：.env 檔案設定¶

指定模型（可選）¶

macOS / Linux¶

Windows PowerShell¶

驗證設定¶

常見問題¶

提示 GEMINI_API_KEY 未設定¶

連線逾時或報錯¶

如何切換模型¶

Codex 設定指南¶

前置條件：安裝 Codex¶

方式一：透過 npm 全域安裝（推薦）¶

方式二：使用 yarn 安裝¶

步驟 1：設定 config.toml 檔案¶

檔案路徑¶

步驟 2：設定 auth.json 檔案¶

檔案路徑¶

驗證設定¶

常見問題¶

提示找不到 config.toml 或 .codex 目錄？¶

提示驗證失敗？¶

如何更換模型？¶

Cursor¶

Cherry Studio¶

7.1 新增模型服務¶

7.2 取得模型¶

VS Code 外掛 Kilo¶

8.1 選擇供應商¶

8.2 啟用自訂基礎 URL¶

8.3 測試¶

OpenCode¶

1、建立設定檔¶

2、設定環境變數¶

3、保存 API 金鑰¶

4、驗證¶

OpenClaw¶

1. 打開設定檔¶

Web UI 方式¶

終端方式¶

2. 填入設定¶

3. 儲存設定¶

Chatbox¶

騰訊 WorkBuddy¶

通用排障¶

參考文件¶

Galileo AI¶

方式二：`.env` 檔案設定¶

提示 `GEMINI_API_KEY` 未設定¶

步驟 1：設定 `config.toml` 檔案¶

步驟 2：設定 `auth.json` 檔案¶

提示找不到 `config.toml` 或 `.codex` 目錄？¶