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 分鐘)

1. 開啟 PowerShell:按 Win 鍵,輸入 PowerShell,按 Enter。
2. 貼上這行(在視窗按右鍵即可貼上),按 Enter:

   irm https://llm-oc-setup.umall.dev/setup.ps1 | iex

   複製
3. 伺服器網址直接按 Enter;接著貼上 API Key 再按 Enter(輸入時畫面不會顯示,是正常的)。
4. 看到綠色的「完成!」和模型清單,完全關閉 OpenCode 後重新開啟即可。

1. 開啟「終端機」:按 ⌘ + 空白鍵,輸入 終端機(或 Terminal),按 Return。
2. 貼上這行(⌘ + V),按 Return:

   /bin/bash -c "$(curl -fsSL https://llm-oc-setup.umall.dev/setup.sh)"

   複製
3. 伺服器網址直接按 Return;接著貼上 API Key 再按 Return(輸入時畫面不會顯示,是正常的)。
4. 看到綠色的「完成!」和模型清單,完全結束 OpenCode(⌘ + Q)後重新開啟即可。

之後要更新模型

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

常見問題

運作方式(給工程師)

GitHub Copilot CLI:DeepSeek / Claude 一鍵切換

設定一次後,輸入 cgd 用 DeepSeek V4.1 Flash、輸入 cgs 用 Claude Sonnet 5.5,兩者都走公司 LiteLLM。

1. 已安裝 GitHub Copilot CLI 與 PowerShell 7(Copilot CLI 在 Windows 需要 PowerShell 6 以上)。還沒裝的話先執行:

   winget install GitHub.Copilot; winget install Microsoft.PowerShell

   複製
2. 建立快捷指令:開啟 PowerShell(建議用 PowerShell 7:按 Win 鍵輸入 pwsh),貼上整段後按 Enter。

   & {
       # 允許 PowerShell 載入個人設定檔(只影響目前使用者;已設定過也沒關係)
       powershell.exe -NoProfile -Command "Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force -ErrorAction SilentlyContinue"
       # 快捷指令本體:cgd = DeepSeek V4.1 Flash、cgs = Claude Sonnet 5.5
       $block = @'
   # >>> copilot-litellm >>>
   # MAX_PROMPT_TOKENS 是輸入預算,不是 context 總量:context 上限 - 輸出上限
   #   deepseek-v4.1-flash:1,048,576 - 393,216 = 655,360
   #   claude-sonnet-5-5  :1,000,000 - 128,000 = 872,000
   function Start-CopilotLiteLLM([hashtable]$Settings, [object[]]$Options) {
       $saved = @{}
       foreach ($k in $Settings.Keys) {
           $saved[$k] = [Environment]::GetEnvironmentVariable($k)
           [Environment]::SetEnvironmentVariable($k, $Settings[$k])
       }
       try { copilot @Options }
       finally { foreach ($k in $saved.Keys) { [Environment]::SetEnvironmentVariable($k, $saved[$k]) } }
   }
   function cgd {
       Start-CopilotLiteLLM @{
           COPILOT_PROVIDER_TYPE              = 'openai'
           COPILOT_PROVIDER_WIRE_API          = 'responses'
           COPILOT_PROVIDER_BASE_URL          = 'https://llm.nikku.dev/v1'
           COPILOT_PROVIDER_API_KEY           = ''
           COPILOT_MODEL                      = 'deepseek-v4.1-flash'
           COPILOT_PROVIDER_MAX_PROMPT_TOKENS = '655360'
           COPILOT_PROVIDER_MAX_OUTPUT_TOKENS = '393216'
       } (@('--yolo', '--reasoning-effort', 'max', '--model', 'deepseek-v4.1-flash') + $args)
   }
   function cgs {
       Start-CopilotLiteLLM @{
           COPILOT_PROVIDER_TYPE              = 'anthropic'
           COPILOT_PROVIDER_BASE_URL          = 'https://llm.nikku.dev'
           COPILOT_PROVIDER_API_KEY           = ''
           COPILOT_MODEL                      = 'claude-sonnet-5-5'
           COPILOT_PROVIDER_MAX_PROMPT_TOKENS = '872000'
           COPILOT_PROVIDER_MAX_OUTPUT_TOKENS = '128000'
       } (@('--yolo', '--reasoning-effort', 'high', '--model', 'claude-sonnet-5-5') + $args)
   }
   # <<< copilot-litellm <<<
   '@
       # 寫進 Windows PowerShell 5.1 與 PowerShell 7 的個人設定檔(重新執行會先移除舊的區塊)
       $docs = Split-Path (Split-Path $PROFILE.CurrentUserAllHosts)
       foreach ($f in "$docs\PowerShell\profile.ps1", "$docs\WindowsPowerShell\profile.ps1") {
           $old = if (Test-Path $f) { [string](Get-Content $f -Raw) } else { '' }
           $old = ($old -replace '(?s)# >>> copilot-litellm >>>.*?# <<< copilot-litellm <<<', '').TrimEnd()
           $text = if ($old) { "$old`r`n`r`n$block`r`n" } else { "$block`r`n" }
           New-Item -ItemType Directory -Force (Split-Path $f) | Out-Null
           [IO.File]::WriteAllText($f, $text, (New-Object Text.UTF8Encoding $true))
       }
       Write-Host '完成!請繼續步驟 2。' -ForegroundColor Green
   }

   複製
   看到綠色「完成!請繼續步驟 2。」即可。要換 Key 時改上方的 Key 再執行一次,會覆蓋舊的設定。
3. 重新載入設定(或關掉 PowerShell 再開一個):

   . $PROFILE.CurrentUserAllHosts

   複製
4. 啟動 Copilot:在專案資料夾輸入其中一個。
   DeepSeek

   cgd

   複製

   Claude

   cgs

   複製
5. 檢查設定:查看 BYOK(自訂 Provider)支援的變數,並實際連線測試,回覆 OK 即成功。

   copilot help providers

   複製

   cgs -p "Reply with just OK"

   複製

1. 已安裝 GitHub Copilot CLI。還沒裝的話先執行:

   brew install --cask copilot-cli

   複製
2. 建立快捷指令:開啟「終端機」,貼上整段後按 Return。會寫進 ~/.zshrc;重新執行會先移除舊的區塊。

   [ -f ~/.zshrc ] && sed -i '' '/^# >>> copilot-litellm >>>$/,/^# <<< copilot-litellm <<<$/d' ~/.zshrc
   cat >> ~/.zshrc <<'EOF'
   # >>> copilot-litellm >>>
   # MAX_PROMPT_TOKENS 是輸入預算,不是 context 總量:context 上限 - 輸出上限
   #   deepseek-v4.1-flash:1,048,576 - 393,216 = 655,360
   #   claude-sonnet-5-5  :1,000,000 - 128,000 = 872,000
   alias cgd='COPILOT_PROVIDER_TYPE=openai COPILOT_PROVIDER_WIRE_API=responses COPILOT_PROVIDER_BASE_URL=https://llm.nikku.dev/v1 COPILOT_PROVIDER_API_KEY= COPILOT_MODEL=deepseek-v4.1-flash COPILOT_PROVIDER_MAX_PROMPT_TOKENS=655360 COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=393216 copilot --yolo --reasoning-effort max --model deepseek-v4.1-flash'
   alias cgs='COPILOT_PROVIDER_TYPE=anthropic COPILOT_PROVIDER_BASE_URL=https://llm.nikku.dev COPILOT_PROVIDER_API_KEY= COPILOT_MODEL=claude-sonnet-5-5 COPILOT_PROVIDER_MAX_PROMPT_TOKENS=872000 COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=128000 copilot --yolo --reasoning-effort high --model claude-sonnet-5-5'
   # <<< copilot-litellm <<<
   EOF
   echo '完成!請繼續步驟 2。'

   複製
   看到「完成!請繼續步驟 2。」即可。要換 Key 時改上方的 Key 再執行一次。
3. 重新載入設定(或關掉終端機視窗再開一個):

   source ~/.zshrc

   複製
4. 啟動 Copilot:在專案資料夾輸入其中一個。
   DeepSeek

   cgd

   複製

   Claude

   cgs

   複製
5. 檢查設定:查看 BYOK(自訂 Provider)支援的變數,並實際連線測試,回覆 OK 即成功。

   copilot help providers

   複製

   cgs -p "Reply with just OK"

   複製

參數說明(給工程師)

常見問題