OpenCode 設定教學

本教學涵蓋 macOS、Windows 與 Linux 三種作業系統，說明如何開啟並修改 OpenCode 的設定檔 opencode.jsonc，將模型服務指向 MyAI168。

請依照下方「一」到「七」的步驟依序操作；若操作中遇到問題，可參考最後的「常見注意事項」。

若是剛安裝完、從未開啟過 OpenCode，設定資料夾與 opencode.jsonc 可能尚未被建立，後續步驟會找不到該檔案。

因此首次設定前，請先做這件事：

1. 正常開啟 OpenCode 一次（等主畫面完全載入）。
2. 接著再依「步驟二」完全關閉程式。

啟動過一次後，程式才會自動建立設定資料夾與 opencode.jsonc，後面的步驟才找得到檔案。

※ 若已使用過 OpenCode、確定設定檔已存在，可略過本步驟。

※ 即使啟動過一次，個別環境仍可能尚未產生 opencode.jsonc。若依「步驟三」仍找不到該檔案，請參考該步驟末的說明手動建立。

修改前一定要先關掉程式，否則改完可能被舊設定覆蓋。

macOS

按 Cmd + Q 關閉視窗，並確認螢幕右上角選單列沒有 OpenCode 的小圖示（若有，點它選結束）。

Windows

關閉視窗，並確認右下角工具列（系統匣）沒有 OpenCode 圖示（若有，在圖示上按右鍵選結束／Exit）。

Linux

關閉視窗，並確認系統匣／頂部狀態列沒有 OpenCode 圖示（若有，在圖示上按右鍵選結束／Quit）。若不確定是否完全關閉，可開啟終端機執行以下指令強制結束：

pkill -f opencode

設定檔叫 opencode.jsonc，放在使用者個人資料夾的隱藏目錄裡。

macOS

1. 打開「終端機」（在 應用程式 → 工具程式 裡）。
2. 貼上這行後按 Enter：

open ~/.config/opencode/

Finder 會跳出該資料夾，裡面就有 opencode.jsonc。

Windows

1. 按 Win + R 開啟「執行」。
2. 貼上這行後按 Enter：

%USERPROFILE%\.config\opencode\

檔案總管會跳出該資料夾，裡面就有 opencode.jsonc。

Linux

1. 打開「終端機」（Terminal）。
2. 貼上這行後按 Enter（會用預設檔案管理員開啟該資料夾）：

xdg-open ~/.config/opencode/

檔案管理員會跳出該資料夾，裡面就有 opencode.jsonc。

※ 若資料夾裡找不到 opencode.jsonc，可在檔案管理員／Finder 的搜尋框直接搜尋檔名 opencode.jsonc。

※ Linux 的隱藏資料夾（開頭為 . 的資料夾）預設不顯示，在檔案管理員中可按 Ctrl + H 切換顯示隱藏檔案。

若仍找不到 opencode.jsonc（資料夾是空的或不存在）：代表程式尚未自動產生設定檔，請手動建立。

macOS／Linux

開啟終端機，貼上以下兩行後各按 Enter：

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.jsonc

完成後再依前面方式開啟該資料夾，即可看到剛建立的空白 opencode.jsonc。

Windows

開啟「執行」（Win + R），貼上下行按 Enter 建立資料夾：

cmd /c "mkdir %USERPROFILE%\.config\opencode 2>nul & type nul > %USERPROFILE%\.config\opencode\opencode.jsonc"

完成後再依前面方式開啟該資料夾，即可看到剛建立的空白 opencode.jsonc。

手動建立的檔案是空白的，直接進入「步驟五」把完整內容貼進去即可。

macOS

對著 opencode.jsonc 按右鍵 → 「打開檔案的應用程式」→ 選「文字編輯」（TextEdit）。

Windows

對著 opencode.jsonc 按右鍵 → 「開啟方式」→ 選「記事本」（Notepad）。

Linux

對著 opencode.jsonc 按右鍵 → 「開啟方式」→ 選純文字編輯器（例如 gedit、Kate、Text Editor 等，依桌面環境而定）。或在終端機直接用編輯器開啟，例如：

nano ~/.config/opencode/opencode.jsonc

※ 重點：一定要用純文字編輯器，不要用 Word、LibreOffice Writer 之類的文書軟體開啟，以免存檔時格式跑掉。

把檔案內容改成下面這樣（可整段複製貼上覆蓋）：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "myai168": {
      "name": "MyAI168",
      "npm": "@ai-sdk/openai",
      "options": {
        "baseURL": "https://www.myai168.com/nou/api/openai/v1",
        "apiKey": "請填入您的金鑰"
      },
      "models": {
        "gpt-5.5": { "name": "GPT-5.5" }
      }
    },
    "myai168_claude": {
      "name": "MyAI168 Claude",
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://www.myai168.com/nou/api/anthropic/v1",
        "apiKey": "請填入您的金鑰"
      },
      "models": {
        "claude-opus-4-8": { "name": "Claude Opus 4.8" }
      }
    }
  }
}

唯一需要您填寫的地方：把兩處「請填入您的金鑰」換成您實際的 API 金鑰（兩處填一樣的）。其他內容請勿更動。

macOS

按 Cmd + S 存檔。若文字編輯跳出詢問格式，選「使用純文字」。

Windows

按 Ctrl + S 存檔。

Linux

按 Ctrl + S 存檔。若使用 nano 編輯，按 Ctrl + O 後按 Enter 存檔，再按 Ctrl + X 離開。

※ 注意：存檔後請確認檔名仍是 opencode.jsonc，副檔名沒有被改成 .txt。記事本若不小心存成 opencode.jsonc.txt，需把多出來的 .txt 刪掉。

重開程式後，在模型選擇選單即可看到兩個模型：

• MyAI168 → GPT-5.5
• MyAI168 Claude → Claude Opus 4.8

選擇任一個即可開始使用。

• 改設定前務必完全關閉程式，這是最常見的出錯原因。
• 兩個模型的網址結尾不同是正常的：OpenAI 那組結尾是 /openai/v1，Claude 那組是 /anthropic/v1，請勿自行統一或更動。
• 若日後要新增模型，在對應的 models 區塊內，參照現有格式增加一行（記得前一行結尾要加逗號）。
• 請勿使用程式內的「Custom provider」介面去重新設定，以免覆蓋掉這份已調校好的設定檔。