Skip to Content
工具整合OpenCode

OpenCode 設定

OpenCode  是一款開源 AI 編碼智能體，提供終端機 TUI、桌面客戶端和 IDE 外掛。Ofox 已內建在 OpenCode 的提供商目錄中（資料來自 models.dev ），無需自訂 Base URL，選中 Ofox、填入 API Key 即可使用 GPT、Claude、Gemini、DeepSeek 等模型。

前置條件

  • 已註冊 OfoxAI 帳號並取得 API Key（前往取得 ）
  • 已安裝 OpenCode：
# 任選其一
curl -fsSL https://opencode.ai/install | bash
npm i -g opencode-ai@latest
brew install anomalyco/tap/opencode

桌面客戶端可在 opencode.ai/download  下載。

方式一：桌面客戶端

1. 開啟提供商設定

打開 OpenCode，點擊左側欄的 设置 → 提供商，在「熱門提供商」列表底部點擊 查看更多提供商。

设置 → 提供商

2. 搜尋並選擇 Ofox

在搜尋框輸入 ofox，點擊 Ofox。

搜尋 Ofox

3. 填入 API Key

貼上你的 OfoxAI API Key，點擊 继续。連接成功後，Ofox 會出現在「已連接的提供商」中。

填入 Ofox API Key

4. 啟用 Ofox 模型

進入 设置 → 模型，搜尋 ofox，把需要用的模型開關打開。只有開啟的模型才會出現在會話的模型選擇器裡。

设置 → 模型，開啟 Ofox 下的模型

5. 選擇模型開始對話

新建會話，點擊輸入框下方的模型選擇器，在 Ofox 分組下選擇剛才開啟的模型即可開始對話。點擊底部的 管理模型 可隨時回到第 4 步增減模型。

在模型選擇器的 Ofox 分組下選擇模型

方式二：終端機 TUI

在專案目錄下啟動 OpenCode，輸入 /connect：

opencode
/connect

在提供商列表中搜尋 Ofox 並按 Enter，貼上 API Key。然後輸入 /models，選擇 Ofox 下的模型即可。

憑證保存在 ~/.local/share/opencode/auth.json，桌面端與終端機共用，只需設定一次。

也可以直接用命令列完成登入並驗證：

opencode auth login          # 選擇 Ofox，貼上 API Key
opencode models ofox         # 列出 Ofox 下可用模型
opencode run -m ofox/anthropic/claude-sonnet-4.6 "你好，介紹一下你自己"

選用：環境變數與設定檔

OpenCode 會自動讀取 OFOX_API_KEY 環境變數，適合 CI 或不想把 Key 存在本地檔案裡的場景：

~/.zshrc
export OFOX_API_KEY=<你的 OFOXAI_API_KEY>

如需把 Ofox 設為預設模型，在專案根目錄或 ~/.config/opencode/ 下的 opencode.json 中寫入：

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "ofox/anthropic/claude-sonnet-4.6"
}

模型 ID 格式為 ofox/<OfoxAI 模型 ID>，完整清單請見 模型廣場 。

協議說明：內建提供商 vs 自訂提供商

走內建 Ofox 提供商時，每個模型預設使用其對應的原生協議，無需手動選擇：

模型協議端點
Claude 系列（anthropic/*）Anthropic 原生協議https://api.ofox.ai/anthropic/v1
Gemini 系列（google/*）Gemini 原生協議https://api.ofox.ai/gemini/v1beta
GPT 系列（openai/*）OpenAI 協議https://api.ofox.ai/v1
其他模型（DeepSeek、Qwen、GLM 等）OpenAI 相容協議https://api.ofox.ai/v1

如果需要自行指定協議——例如用 OpenAI 協議呼叫 Claude——就不能走內建提供商，需要新增一個自訂提供商，手動設定 Base URL、API Key 和模型。

在桌面客戶端新增自訂提供商

设置 → 提供商 → 查看更多提供商，選擇 自定义 OpenAI 兼容提供商，按下表填寫後點擊 提交：

欄位填寫內容
提供商 ID自訂，如 ofox-openai（不要與內建的 ofox 重名）
顯示名稱自訂，如 Ofox (OpenAI 协议)
基礎 URLhttps://api.ofox.ai/v1
API 金鑰你的 OfoxAI API Key
模型ID 填 OfoxAI 模型 ID（如 anthropic/claude-sonnet-4.6），名稱自訂；可點擊「添加模型」新增多個

自訂提供商：用 OpenAI 協議接入 Claude

新增後，模型選擇器裡會多出一個 Ofox (OpenAI 协议) 分組，其中的模型都透過 OpenAI 相容協議呼叫。

或者寫在 opencode.json 中

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ofox-openai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ofox (OpenAI 协议)",
      "options": {
        "baseURL": "https://api.ofox.ai/v1",
        "apiKey": "{env:OFOX_API_KEY}"
      },
      "models": {
        "anthropic/claude-sonnet-4.6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}

使用時模型 ID 寫作 ofox-openai/anthropic/claude-sonnet-4.6。

推薦模型

推薦模型請參考 模型廣場 。

Last updated on
OpenClaw 🦞DeepSeek Harness