本教學說明如何在 Linux 安裝 OpenCode，並修改設定檔 opencode.json，將模型服務指向 MyAI168。
請依照下方「一」到「七」的步驟依序操作；若操作中遇到問題，可參考最後的「常見注意事項」。
若尚未安裝 OpenCode，開「終端機」執行下列其中一種安裝方式（官方文件：https://opencode.ai/docs/）：
# 方式 1：官方安裝腳本（推薦）
curl -fsSL https://opencode.ai/install | bash
# 方式 2：Homebrew（Linux 亦支援）
brew install anomalyco/tap/opencode
# 方式 3：npm（需已安裝 Node.js）
npm install -g opencode-ai
# Arch Linux（官方套件庫）
sudo pacman -S opencode安裝完成後先啟動一次（在終端機輸入 opencode，或開啟桌面版），讓程式建立設定資料夾，接著再依「步驟二」完全關閉程式。
※ 官方並未保證首次啟動一定會自動產生設定檔 opencode.json；若依「步驟三」找不到該檔案，請參考該步驟末的說明手動建立。
※ 若已安裝並使用過 OpenCode、確定設定檔已存在，可略過本步驟。
修改前一定要先關掉程式，否則改完可能被舊設定覆蓋。
關閉視窗，並確認系統匣／頂部狀態列沒有 OpenCode 圖示（若有，在圖示上按右鍵選結束／Quit）。若不確定是否完全關閉，可開啟終端機執行以下指令強制結束：
pkill -f opencode設定檔叫 opencode.json，放在使用者個人資料夾的隱藏目錄裡。
xdg-open ~/.config/opencode/檔案管理員會跳出該資料夾，裡面就有 opencode.json。
※ OpenCode 也接受 JSONC 格式（opencode.jsonc）；若資料夾裡已有 opencode.jsonc，直接編輯它即可，後續步驟相同。
※ 若資料夾裡找不到 opencode.json，可在檔案管理員的搜尋框直接搜尋檔名 opencode.json。
※ Linux 的隱藏資料夾（開頭為 . 的資料夾）預設不顯示，在檔案管理員中可按 Ctrl + H 切換顯示隱藏檔案。
若仍找不到 opencode.json（資料夾是空的或不存在）：代表程式尚未自動產生設定檔，請手動建立。開啟終端機，貼上以下兩行後各按 Enter：
mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json完成後再依前面方式開啟該資料夾，即可看到剛建立的空白 opencode.json。手動建立的檔案是空白的，直接進入「步驟五」把完整內容貼進去即可。
對著 opencode.json 按右鍵 → 「開啟方式」→ 選純文字編輯器（例如 gedit、Kate、Text Editor 等，依桌面環境而定）。或在終端機直接用編輯器開啟，例如：
nano ~/.config/opencode/opencode.json※ 重點：一定要用純文字編輯器，不要用 LibreOffice Writer 之類的文書軟體開啟，以免存檔時格式跑掉。
全新或空白的檔案：把下面整段內容複製貼上即可。檔案已有內容：請不要整段覆蓋——會刪掉您原有的 agent／permission／plugin／theme 等設定（OpenCode 的多份設定檔採合併機制、不是取代）；只要把下面 "provider" 區塊裡的兩個供應商合併進您既有設定的 "provider" 區塊即可（原本沒有 "provider" 區塊就整塊加進去）。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"myai168": {
"name": "MyAI168",
"npm": "@ai-sdk/openai",
"options": {
"baseURL": "https://www.myai168.com/mcu/api/openai/v1",
"apiKey": "請填入您的金鑰"
},
"models": {
"gpt-5.6-sol": { "name": "GPT-5.6 Sol" }
}
},
"myai168_claude": {
"name": "MyAI168 Claude",
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://www.myai168.com/mcu/api/anthropic/v1",
"apiKey": "請填入您的金鑰"
},
"models": {
"claude-opus-4-8": { "name": "Claude Opus 4.8" }
}
}
}
}唯一需要您填寫的地方：把兩處「請填入您的金鑰」換成您實際的 API 金鑰（兩處填一樣的）。其他內容請勿更動。
按 Ctrl + S 存檔。若使用 nano 編輯，按 Ctrl + O 後按 Enter 存檔，再按 Ctrl + X 離開。
※ 注意：存檔後請確認檔名仍是 opencode.json，副檔名沒有被改成 .txt。
重開程式後，在模型選擇選單即可看到兩個模型：
選擇任一個即可開始使用。
/openai/v1，Claude 那組是 /anthropic/v1，請勿自行統一或更動。models 區塊內，參照現有格式增加一行（記得前一行結尾要加逗號）。/connect 指令儲存金鑰（憑證存於 ~/.local/share/opencode/auth.json，不進設定檔），再於設定檔配置 provider——兩種方式擇一即可；若改用 /connect 儲存金鑰，設定檔 options 內可省略 apiKey 欄位。