OpenCode 快速設定

一行指令把公司 LLM 接進 OpenCode。模型清單由伺服器提供,之後要更新只要再執行一次。

交給 AI 代理代做

自己操作不順時,把下面這段複製給你電腦上的 AI 代理(例如 OpenCode、Claude Code),並另外提供你的 API Key。

請幫我在這台電腦設定 OpenCode 連到公司的 LLM 伺服器。
1. 判斷作業系統。Windows 請在 PowerShell 執行(一整行):
   $env:OPENCODE_SETUP_NONINTERACTIVE='1'; $env:OPENCODE_SETUP_KEY='<我的 API Key>'; irm https://llm-oc-setup.umall.dev/setup.ps1 | iex; Remove-Item Env:OPENCODE_SETUP_KEY, Env:OPENCODE_SETUP_NONINTERACTIVE
   macOS 請在終端機執行(一整行):
   OPENCODE_SETUP_NONINTERACTIVE=1 OPENCODE_SETUP_KEY='<我的 API Key>' /bin/bash -c "$(curl -fsSL https://llm-oc-setup.umall.dev/setup.sh)"
2. 確認輸出有「完成!」與模型清單;若出現錯誤,把完整訊息回報給我,不要自行修改 OpenCode 設定檔。
3. 提醒我完全關閉 OpenCode 後重新開啟。

自己動手(約 1 分鐘)

開啟 PowerShell:按 Win 鍵,輸入 PowerShell,按 Enter。
貼上這行(在視窗按右鍵即可貼上),按 Enter:
```
irm https://llm-oc-setup.umall.dev/setup.ps1 | iex
```
伺服器網址直接按 Enter;接著貼上 API Key 再按 Enter(輸入時畫面不會顯示,是正常的)。
看到綠色的「完成!」和模型清單,完全關閉 OpenCode 後重新開啟即可。

之後要更新模型

再執行一次同一行指令,連按兩次 Enter(沿用上次的網址與金鑰)就好。畫面會列出這次新增或移除了哪些模型。

常見問題

顯示「金鑰無效或已停用」

確認貼上的是完整的 API Key(通常以 sk- 開頭),或向管理者確認金鑰是否已停用。腳本會讓你重新輸入,最多 3 次。

想換一把新的 API Key

重新執行指令,網址按 Enter,金鑰那一步貼上新的金鑰即可。

以前用過「OpenCode 快速設定工具」(.exe / .app)

直接改用這行指令即可,舊的設定會被更新。往後不需要再下載工具。

會不會動到我其他的 OpenCode 設定?

不會。腳本只改公司 LLM 那一個 provider,其他設定原樣保留;改動前的檔案會備份成 opencode.json.bak-日期-時間。API Key 只存在你的電腦上。

設定完 OpenCode 還是看不到新模型

OpenCode 只在啟動時讀設定:請完全關閉(包含系統匣/選單列圖示)後再開。仍有問題請把指令的完整輸出截圖給管理者。

OpenCode 快速設定

交給 AI 代理代做

自己動手(約 1 分鐘)

之後要更新模型

常見問題

運作方式(給工程師)