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。
開始使用
四個步驟送出第一個請求
- 01
建立免費帳號
使用 Google、GitHub 或 Email 與密碼註冊,無需綁定信用卡。
- 02
產生 API 金鑰
在控制台一鍵產生,讓你的 CLI 通過 Code By AI 驗證。
- 03
充值餘額
首次請求前先充值,使用量會按 token 從餘額扣除。
- 04
把 CLI 指向 Code By AI
設定一個 base URL 環境變數,或在 config.toml 加入 model provider 區塊。各工具的接入指南都列出完整指令。