OpenCode 設定教學

終端機和桌面版都適用的 OpenCode 安裝與模型切換教學。

**適用場景：**OpenCode 是開源 AI 程式設計工具，支援終端機和桌面版使用。本文按“安裝 OpenCode → 設定貴數 Token 模型 → 終端機/桌面版切換模型 → 驗證”的順序整理。

設定項目推薦填寫說明
Base URLhttps://api.llm-token.cn/v1優先使用帶 /v1 的根路徑；若出現錯誤，可移除末尾的 v1 後再試。
API Keysk-xxxxxxxx填你的完整貴數 Token Key。
Model ID模型清單裡的完整模型名必須逐字一致。

一、安裝 OpenCode

任選一種方式安裝。安裝完成後，在終端機輸入 opencode 能啟動即可。

系統 / 方式指令
npm
npm install -g opencode-ai
macOS / Linux Homebrew
brew install anomalyco/tap/opencode
安裝指令碼
curl -fsSL https://opencode.ai/install | bash

桌面版建議從官網下載安裝：https://opencode.ai/。指令列和桌面版可以配合同一套模型設定使用。

二、用 CC Switch 新增貴數 Token 供應商

如果你已經習慣使用 CC Switch，可以按下面截圖新增自訂供應商。

  1. 開啟 CC Switch，注意入口，選擇新增自訂供應商。
  2. 填寫服務供應商名稱，例如“貴數 Token”。
  3. Base URL 填 https://api.llm-token.cn/v1。
  4. API Key 填你的完整 Key。
  5. Model ID 填模型清單裡的完整模型名。

圖片展示了OpenCode終端機中的CC Switch介面。介面上方有“CC Switch”標誌及多個圖示。畫面中間提示“還沒有新增任何供應商”，並有“匯入目前設定”和“新增供應商”按鈕。圖片中紅色箭頭指向介面右上角的“+”號圖示。該圖片與文件中“終端機裡切換模型”步驟相關，對應步驟4，也就是捲動到自訂模型清單後，選擇剛剛設定的模型；此圖直觀呈現終端機介面中新增供應商的入口位置。圖片展示了OpenCode終端機中的CC Switch介面

圖片展示了OpenCode終端機裡切換模型時新增新供應商的介面。介面中有多個輸入欄位，如供應商名稱、API Key、Base URL等，均有紅色箭頭指向需填寫的內容，分別對應文件中“新增新供應商”步驟裡需填寫的“my - provider”、API Key、Base URL等資訊。此外，介面底部還有“新增模型”按鈕，提示可新增你想使用的模型。該圖片直觀呈現了文件中終端機切換模型時新增新供應商的操作介面及關鍵輸入項。圖片展示了OpenCode終端機裡切換模型時新增新供應商的介面

三、終端機裡切換模型

  1. 開啟終端機，執行 opencode。
  2. 進入 OpenCode 後按 Ctrl + P。
  3. 找到 Switch Model 並按 Enter 鍵。
  4. 捲動到自訂模型清單，選擇剛剛設定的模型。
opencode

這是OpenCode軟體的終端機介面截圖，介面頂部顯示有“OpenCode”的相關標識，輸入欄位內有提示語“Ask anything... 'Fix a TODO in the codebase'”，介面中明確標註目前選擇的模型為“GPT-5.5 OpenAI”，還顯示了操作提示相關內容，包括“Tip:/themes or Ctrl+X T to switch between 33 built-in themes”，以及介面右下角標註了版本號“1.14.30”，該介面對應文件中終端機切換模型環節的操作場景，是使用者進入OpenCode後可進行模型切換操作的介面。這是OpenCode軟體的終端機介面截圖，介面頂部顯示有“OpenCode”的相關標識，輸入欄位內有提示語“Ask anything... 'F…

Ctrl + P

圖片展示的是OpenCode終端機介面，顯示了終端機命令提示字元及部分程式碼內容。畫面中彈出一個指令選單，其中“Switch model”指令以橘色醒目標示，其右側對應快捷鍵為“ctrl+x m”。該圖片與文件中“三、終端機裡切換模型”部分內容相關，用於直觀呈現終端機中找到“Switch Model”並按 Enter 鍵操作的介面情況，協助使用者理解在終端機切換模型的操作步驟。圖片展示的是OpenCode終端機介面，顯示了終端機命令提示字元及部分程式碼內容

這張圖片是OpenCode工具的終端機介面，顯示“Select model”的模型選擇頁面。頁面包含多個內建模型選項，下方還有“custom”自訂選項，以及自訂的“gpt-5.5”模型選項；該選項以橘色醒目標示為已選取。介面底部還標註了操作快捷鍵，例如Connect provider對應ctrl+a、Favorite對應ctrl+f。這張圖對應文件中終端機切換模型步驟裡，捲動到自訂模型清單並選擇已設定模型的操作環節。這張圖片是OpenCode工具的終端機介面，顯示“Select model”的模型選擇頁面

四、桌面版使用

開啟 OpenCode 桌面版，在模型選擇位置找到 CC Switch 中設定好的模型，選中後即可開始使用。

這張圖片展示了OpenCode桌面版的操作介面，介面整體為深色風格。左側區域顯示了“構建任何東西”的相關內容，底部“Big Pickle”選項被紅色箭頭重點標出，該箭頭明確指向這個選項；右側區域顯示了“建立 Git 倉庫”的相關功能選項。這張圖片對應文件裡的桌面版使用部分，用於展示OpenCode桌面版操作介面中的關鍵操作入口位置，輔助使用者進行該部分的設定操作。這張圖片展示了OpenCode桌面版的操作介面，介面整體為深色風格

這張圖片展示的是OpenCode桌面版操作介面，用於指導使用者新增自訂模型。介面左側模型選擇區域已展開下拉選單，顯示了GPT-4 nano、GPT-4.5等模型選項，紅色箭頭指向其中標註為“gpt-5.5”的選項。介面中央有突出的藍色文字提示，說明後續可點選對應區域新增大模型，且新增時需選擇自訂模型。該圖片與桌面版使用環節相關，是設定自訂模型的操作引導圖，幫助使用者完成模型新增的關鍵步驟。這張圖片展示的是OpenCode桌面版操作介面，用於指導使用者新增自訂模型

五、驗證與常見問題

現象處理方式
啟動不了 opencode重新開啟終端機，確認 npm / brew 安裝路徑已經加入 PATH。
模型清單沒有自訂模型確認 CC Switch 已儲存，並重新啟動 OpenCode。
請求失敗檢查 Base URL、API Key、模型 ID；先用 https://api.llm-token.cn/v1。
模型回覆慢換快速回應模型測試，例如 claude-sonnet-4-6 或 MiniMax-M3-highspeed。

WorkBuddy 設定教學

自訂模型串接的三項必要設定：Base URL、API Key、模型 ID。

VS Code 設定教學

在 VS Code + Cline 裡用 OpenAI Compatible 串接貴數 Token。

本頁章節

一、安裝 OpenCode二、用 CC Switch 新增貴數 Token 供應商三、終端機裡切換模型四、桌面版使用五、驗證與常見問題