OpenCode 安裝與設定教學 — macOS 版

本教學說明如何在 macOS 安裝 OpenCode，並修改設定檔 opencode.json，將模型服務指向 MyAI168。

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

若尚未安裝 OpenCode，開「終端機」執行下列其中一種安裝方式（官方文件：https://opencode.ai/docs/）：

# 方式 1：官方安裝腳本（推薦）
curl -fsSL https://opencode.ai/install | bash

# 方式 2：Homebrew（官方推薦 tap，版本最新）
brew install anomalyco/tap/opencode

# 方式 3：npm（需已安裝 Node.js）
npm install -g opencode-ai

安裝完成後先啟動一次（在終端機輸入 opencode，或開啟桌面版），讓程式建立設定資料夾，接著再依「步驟二」完全關閉程式。

※ 官方並未保證首次啟動一定會自動產生設定檔 opencode.json；若依「步驟三」找不到該檔案，請參考該步驟末的說明手動建立。

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

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

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

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

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

open ~/.config/opencode/

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

※ OpenCode 也接受 JSONC 格式（opencode.jsonc）；若資料夾裡已有 opencode.jsonc，直接編輯它即可，後續步驟相同。

※ 若資料夾裡找不到 opencode.json，可在 Finder 的搜尋框直接搜尋檔名 opencode.json。

若仍找不到 opencode.json（資料夾是空的或不存在）：代表程式尚未自動產生設定檔，請手動建立。開啟終端機，貼上以下兩行後各按 Enter：

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

完成後再依前面方式開啟該資料夾，即可看到剛建立的空白 opencode.json。手動建立的檔案是空白的，直接進入「步驟五」把完整內容貼進去即可。

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

※ 重點：一定要用純文字編輯器，不要用 Word、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/ntue/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/ntue/api/anthropic/v1",
        "apiKey": "請填入您的金鑰"
      },
      "models": {
        "claude-opus-4-8": { "name": "Claude Opus 4.8" }
      }
    }
  }
}

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

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

※ 注意：存檔後請確認檔名仍是 opencode.json，副檔名沒有被改成 .txt。

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

• MyAI168 → GPT-5.6 Sol
• MyAI168 Claude → Claude Opus 4.8

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

• 改設定前務必完全關閉程式，這是最常見的出錯原因。
• 兩個模型的網址結尾不同是正常的：OpenAI 那組結尾是 /openai/v1，Claude 那組是 /anthropic/v1，請勿自行統一或更動。
• 若日後要新增模型，在對應的 models 區塊內，參照現有格式增加一行（記得前一行結尾要加逗號）。
• 本教學採「金鑰直接寫在設定檔」的簡化方式。官方標準流程是先在 OpenCode 內用 /connect 指令儲存金鑰（憑證存於 ~/.local/share/opencode/auth.json，不進設定檔），再於設定檔配置 provider——兩種方式擇一即可；若改用 /connect 儲存金鑰，設定檔 options 內可省略 apiKey 欄位。