設定指南

中轉站設定指南

依工具瀏覽設定步驟與問題排查。

中轉站設定指南/OpenCode 配置

OpenCode 配置

OpenCode 是開源終端 AI 編碼助手。它適合在項目目錄裡進行代碼問答、文件修改和模型切換。新手優先走它自己的連接嚮導，不要一開始就手寫完整 JSON。

官方信息 下載和文檔以官方站點為準
OpenCode 官網 開源終端 AI 編碼助手 文檔 安裝、認證和命令說明 中轉站配置參考 參考 opencode.json 的配置思路

這個工具是什麼，用於什麼

配置文件位置

系統配置文件位置說明
WindowsC:\Users\你的用戶名\.config\opencode\opencode.json沒有文件就新建
macOS / Linux~/.config/opencode/opencode.json沒有文件就新建

先用連接嚮導

OpenCode 連接嚮導
cd 你的測試項目 opencode /connect

手動配置注意什麼

只有當你的服務商文檔明確寫了 OpenCode 的 Provider 字段、Base URL 和 Key 放在哪裡，再編輯配置文件。不同版本字段會變化，不要把其他工具的 JSON 示例直接搬到 OpenCode。

要核對的內容說明
Provider 類型OpenAI、Claude、Gemini 或其他協議不能混用
Base URL使用服務商給 OpenCode 或對應協議的完整地址
Key使用當前 Provider 對應的 Key
模型名照抄服務商後臺模型列表

保存後怎麼測試

  1. 進入一個測試項目目錄後運行 opencode。
  2. 先用 /models 確認能看到剛配置的模型。
  3. 選擇模型後發送“請只回覆：OpenCode 配置成功”。
  4. 第一次不要讓它修改文件，只讓它解釋當前目錄或當前文件。
  5. 如果失敗，先回到 /connect 或服務商文檔核對 Provider、Base URL、Key 和模型名。
現象優先檢查處理
/models 裡沒有模型Provider 是否保存成功、模型列表是否能拉取手動添加服務商後臺模型 ID / 模型名
連接失敗Base URL 是否屬於當前 Provider 協議不要把 Claude、Gemini、OpenAI 三類地址混用
配置文件無效JSON 格式、逗號、引號優先用連接嚮導生成配置，再少量手改
OpenCode 官網 查看安裝、認證和命令說明。
OpenCode 中轉站配置參考 參考 opencode.json 的配置思路。