跳轉到主要內容

​
概覽

類型: 程式工具主要路徑: OpenAI 相容支援級別: 支援路徑
OpenCode 是一個在終端機中執行的開源 AI 程式設計助理。它支援多種 LLM 供應商，並可設定為使用 LemonData 的 API，以存取 300+ 個模型。

​
安裝

curl -fsSL https://opencode.ai/install | bash
驗證安裝： 
opencode --version

​
設定

​
步驟 1：設定環境變數

export OPENAI_API_KEY="sk-your-lemondata-key"
如需永久設定，請加入至 ~/.bashrc 或 ~/.zshrc： 
echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
source ~/.zshrc

​
步驟 2：設定 OpenCode

OpenCode 目前的文件建議透過 opencode.json 或 opencode.jsonc 設定供應商。對於 LemonData，請使用自訂供應商，而不是覆寫內建的 openai 供應商： 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lemondata": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LemonData",
      "options": {
        "baseURL": "https://api.lemondata.cc/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "lemondata/gpt-5.4"
}
使用 @ai-sdk/openai-compatible 以相容於 chat-completions 風格。如果你明確需要建立在 /v1/responses 上的供應商路徑，OpenCode 的文件建議將套件切換為 @ai-sdk/openai。

​
基本用法

啟動互動模式： 
opencode
搭配 prompt 執行： 
opencode "Explain this codebase"
指定模型： 
opencode --model lemondata/gpt-5.4 "Fix the bugs in main.py"

​
可用模型

模型最適合用途
gpt-5.4複雜任務、程式碼架構
gpt-5-mini快速修正、簡單查詢
claude-sonnet-4-6程式碼審查、文件撰寫
claude-opus-4-6複雜推理
gemini-2.5-flash快速回應
deepseek-r1演算法設計

​
常用指令

分析程式碼： 
opencode "What does this function do?" < src/utils.ts
產生程式碼： 
opencode "Create a REST API with Express"
檢查變更： 
git diff | opencode "Review these changes"
修正錯誤： 
opencode "Fix the TypeScript errors in this project"

​
互動指令

指令說明
/help顯示可用指令
/model <name>切換至不同模型
/clear清除對話歷史
/exit結束 OpenCode

​
疑難排解

  • 確認 options.baseURL 已設為 https://api.lemondata.cc/v1
  • 檢查網路連線
  • 嘗試 curl https://api.lemondata.cc/v1/models 進行測試
  • 確認已設定 OPENAI_API_KEY 環境變數
  • 確認 options.apiKey 參照的是 {env:OPENAI_API_KEY} 或其他有效的 secret 來源
  • 檢查 key 是否以 sk- 開頭
  • 確保該 key 已在 LemonData dashboard 中啟用

​
最佳實務

從你的專案根目錄執行 OpenCode，以更好地理解你的程式碼庫。
對於簡單任務使用較快的模型（gpt-5-mini），對於複雜任務則使用較強的模型（gpt-5.4、claude-sonnet-4-6）。
在將變更套用到你的專案之前，務必審查 AI 產生的程式碼。