說明文件

Cline:用 OpenAI 相容介面跑 Claude 與 GPT

本指南需要一組 API Key

註冊帳號並在約一分鐘內產生金鑰,再填入下方步驟中需要金鑰的位置。

註冊無需綁卡 · 使用 API 前需先充值

Cline 是 VS Code 的開源 coding agent;把 Code By AI 加成 OpenAI 相容供應商,就能用一把金鑰跑 Claude 與 GPT 模型。

Cline 會在側邊欄裡操作檔案、終端機與瀏覽器。它的 OpenAI Compatible 供應商只要求 base URL、API Key 與模型 ID,所以同一個 Code By AI 端點就能服務兩個模型家族。

一條命令?

setup.sh 不配置 Cline。它的供應商設定存在一個由 VS Code 擴充、CLI 與背景 hub 共用的檔案裡;只要有一筆 Cline 無法驗證的項目,它就會把整個檔案當成空的,所有供應商(包括 Cline 自己的登入)都會消失。請用下面的步驟。

1. 安裝 Cline

從 VS Code Marketplace 安裝 Cline,再從活動列打開它的面板。

2. 打開供應商設定

在 Cline 面板點齒輪圖示,打開 API Configuration。

3. 設定 Code By AI

  • API Provider: OpenAI Compatible
  • Base URL: https://www.codebyai.net/api/agent/v1
  • API Key: 從 API Keys 頁面取得的 sk-proj-...
  • Model: gpt-5.6-terra

點 Verify 或送出一句簡短提示。Cline 要的是 base URL,不是完整端點;/chat/completions 由它自己接上。

4. 模型設定

打開 Model Configuration,填入模型實際支援的限制:

  • Context Window: 200000
  • Max Output Tokens: 65536
  • Computer Use: 支援工具呼叫的模型請保持開啟,Cline 才能執行工具
  • Image Support: 只有要送截圖或圖片時才開

這些是 Cline 的單模型設定。與閘道限制保持一致,可以避免請求失敗或回覆被提前截斷。

5. 切換到 Claude

把 Model 改成 claude-sonnet-5,base URL 與金鑰不變。閘道會把 claude-* ID 轉往 Claude 通道,並依 Claude 價格計費,所以一個供應商就能同時服務兩邊。模型 ID 以 模型廣場 列出的為準。

疑難排解

  • 404 — Base URL 多了 /chat/completions 或重複的 /v1。請用 https://www.codebyai.net/api/agent/v1。
  • 401/金鑰無效 — 金鑰前後有空白、已被刪除或已過期。到 API Keys 頁面重新建立。
  • 餘額不足 — 到 Wallet 頁面儲值。
  • Agent 不再呼叫工具 — Model Configuration 裡關掉了工具使用,或所選 ID 不支援。打開 Computer Use,並從模型廣場挑一個 agentic 模型。
  • 回覆被截斷 — 調高 Max Output Tokens;閘道的模型單次最多支援 65,536 個輸出 token。

開始使用

四個步驟送出第一個請求

  1. 01

    建立免費帳號

    使用 Google、GitHub 或 Email 與密碼註冊,無需綁定信用卡。

  2. 02

    產生 API 金鑰

    在控制台一鍵產生,讓你的 CLI 通過 Code By AI 驗證。

  3. 03

    充值餘額

    首次請求前先充值,使用量會按 token 從餘額扣除。

  4. 04

    把 CLI 指向 Code By AI

    設定一個 base URL 環境變數,或在 config.toml 加入 model provider 區塊。各工具的接入指南都列出完整指令。

立即使用充值後送出請求看一個月實際要花多少

註冊無需綁卡 · 使用 API 前需先充值