什麼是 VS Code 的 Cline？
Cline 是 VS Code 的開源編碼代理，可以使用與 OpenAI 相容的自訂 API 來讀取程式碼、提出編輯建議並執行核准的工具。
此 Cline VS Code 設定將您的提供者憑證和模型選擇保留在 Cline 自己的設定中，然後在批准任何寫入存取之前使用唯讀編碼任務來驗證連線。 Cline 將模型回應與文件存取、終端命令、瀏覽器操作和編輯器內的審批控制項結合。成功的聊天回應只是第一次檢查：使用測試工作區，最初停用自動審批，並在依賴模型進行編輯或長時間自主任務之前驗證本機工具呼叫。
Cline 可以透過 TokenHub 的 OpenAI compatible 相容 API 中轉模型請求。本文保留官方安裝方式，並只替換 API key、Base URL 和模型 ID。
本指南使用的 TokenHub endpoint 是 https://us-api.tokenhub.com/v1/chat/completions。
何時使用
適合先在小型倉庫或測試專案中驗證。先讓工具讀檔、解釋程式碼或產生方案，再逐步開啟修改和自動化任務。
安裝或開啟工具
先依照 Cline 官方文件 安裝或開啟工具。版本不同時，請以官方文件目前的入口為準。
對於 CLI 工具，先確認可執行檔可用，再加入 TokenHub 憑證：
# open the tool, then open its model or provider settings準備 TokenHub 憑證
建立 TokenHub API key，並在 TokenHub 模型列表中選擇一個適合這個工具的模型。
export TOKENHUB_API_KEY="sk-..."請將金鑰保存在本機 shell、IDE 的密鑰儲存或工具的安全 API key 欄位中，不要提交到程式碼倉庫。
設定 TokenHub 服務商
在工具的模型、供應商、API Keys 或 OpenAI Compatible 設定頁面中填入下列值。
服務商填寫值
| 欄位 | 填寫值 |
|---|---|
| 供應商 | OpenAI Compatible 或 Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY 的值 |
| 模型 | gpt-4.1 或其他 TokenHub 模型 ID |
設定檔位置
| 欄位 | 填寫值 |
|---|---|
| Provider settings | Cline settings panel |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
外掛擁有自己的設定 schema 時，優先使用設定 UI。UI 會把同樣的值寫入使用者設定檔，也能避免猜測不同版本可能變動的私有 key。
在工具 UI 中保存 TokenHub provider。如果工具分開 Chat、Edit、Apply、Fast 或 Autocomplete 模型，第一次測試先全部指向 TokenHub。
如果工具將 chat、edit、apply 和 fast model 分開，第一次測試先全部使用同一個 TokenHub 模型。確認可用後，再依成本、延遲和推理能力拆分。
臨時環境變數只用於排錯
外掛擁有自己的設定 schema 時，優先使用設定 UI。UI 會把同樣的值寫入使用者設定檔，也能避免猜測不同版本可能變動的私有 key。
臨時變數適合確認 Key、網路和模型名。驗證通過後，請把同樣的值寫回上方的持久設定。
驗證連線
先使用唯讀提示測試，確認模型能讀取上下文且不會改動檔案。成功後再測試編輯、Apply 或 Agent 任務。
閱讀目前專案的 README，請用三句話總結。不要修改任何檔案。提示成功後，回到 TokenHub 請求記錄確認模型名稱、endpoint、token 用量和計費分組。
常見問題
| 現象 | 處理方式 |
|---|---|
| 401 或驗證失敗 | 確認 TOKENHUB_API_KEY 有效，且保存在同一個 terminal、IDE 或用戶端設定檔中。 |
| 404 或找不到模型 | 使用 TokenHub 工作區中存在，且符合所選協議的模型 ID。 |
| endpoint 不正確 | Base URL 必須與上方一致。OpenAI 相容工具通常需要 /v1；Claude 相容工具通常不需要。 |
| 請求逾時 | 檢查到 https://us-api.tokenhub.com 的網路、代理設定，以及工作區 allowlist。 |
| 工具使用了其他模型 | 重新檢查 chat、edit、apply、fast 或 autocomplete 等所有模型欄位。 |
如何選擇推薦模型？
Cline for VS Code API 常見問題解答
我應該在 Cline 中哪裡保存 TokenHub 配置？
透過 Cline 的 API Provider 設定面板保存它。團隊文件可以共用基本 URL 和模型 ID，但不能共用真正的 API 金鑰。
為什麼 Cline 可以回答問題但不能編輯文件？
首先確認模型支援工具使用，然後檢查Cline的檔案寫入權限和核准設定。文字回應僅證明基本連接有效。
為什麼重新打開工作區後提供者會改變？
工作區層級的配置可能會覆蓋使用者設定。檢查活動提供者、基本 URL 和模型 ID 是否仍指向 TokenHub。
Cline API 成本是如何計算的？
擴充功能和模型 API 是單獨的計費層。 TokenHub 根據所選模型的實際令牌和適用的快取使用情況以當前模型頁面價格收費。
Cline 規則和 .clinerules 有什麼作用？
它們提供專案約定、命令約束和工作流程指南。它們不會取代提供者基本 URL、API 金鑰或模型 ID 配置。
參考資料
本頁設定依據 TokenHub 教學與官方資料，最後驗證日期為 2026-09-04。
