跳轉到主要內容

​
概覽

OpenCode 是一款在終端機中運行的開源 AI 編碼助手。它支援多個 LLM 提供商，並可配置為使用 LemonData 的 API 以存取 300 多個模型。

​
安裝

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

​
配置

​
步驟 1：設置環境變數

export OPENAI_API_KEY="sk-your-lemondata-key"
export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"
如需永久配置，請將其添加到 ~/.bashrc 或 ~/.zshrc： 
echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
echo 'export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"' >> ~/.zshrc
source ~/.zshrc

​
步驟 2：配置 OpenCode

在您的專案根目錄中建立或編輯 ~/.config/opencode/opencode.json（全域）或 opencode.json： 
{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "sk-your-lemondata-key",
        "baseURL": "https://api.lemondata.cc/v1"
      }
    }
  },
  "model": "gpt-4o",
  "agent": {
    "coder": {
      "model": "gpt-4o"
    }
  }
}

​
基本用法

啟動互動模式： 
opencode
使用提示詞運行： 
opencode "Explain this codebase"
指定模型： 
opencode --model gpt-4o "Fix the bugs in main.py"

​
可用模型

模型最適用於
gpt-4o複雜任務、程式碼架構
gpt-4o-mini快速修復、簡單查詢
claude-sonnet-4-5程式碼審查、文件編寫
claude-opus-4-5複雜推理
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

​
疑難排解

  • 驗證 LOCAL_ENDPOINT 已設置為 https://api.lemondata.cc/v1
  • 檢查網路連線
  • 嘗試使用 curl https://api.lemondata.cc/v1/models 進行測試
  • 驗證 OPENAI_API_KEY 環境變數已設置
  • 檢查金鑰是否以 sk- 開頭
  • 確保金鑰在 LemonData 控制面板中處於啟用狀態

​
最佳實踐

從您的專案根目錄運行 OpenCode，以便更好地理解您的程式碼庫。
對於簡單任務使用更快的模型 (gpt-4o-mini)，對於複雜任務使用強大的模型 (gpt-4o, claude)。
在將變更應用到您的專案之前，請務必審查 AI 生成的程式碼。