Hakila Docs

其他 Coding Agent

讓 OpenCode、Aider、OpenHands、Roo Code、Cline、Goose、Open Interpreter 透過 Hakila 使用 GPT、Claude、Gemini 與 Grok

支援自訂 OpenAI 相容端點的 Agent,都能把 Base URL 指到 Hakila,用同一把 API Key 切換平台上所有 chat 模型。 這些工具走 Chat Completions:工具呼叫(function calling)、串流與推理等級都可以用, GPT-5 之後的 OpenAI 推理模型帶工具時,Hakila 會自動改走 OpenAI 原生 Responses API,工具與推理可以同時使用。

Codex 與 Claude Code 另有專屬設定,請見 Codex 與 Messages API; 個人助理與聊天 App 請見 AI 助理與聊天介面。

共通設定

欄位值
Base URLhttps://api.hakila.ai/v1
API KeyHakila API Key(建議放在環境變數 HAKILA_API_KEY)
模型完整的 Hakila 模型 id,例如 anthropic/claude-sonnet-5、openai/gpt-6-sol、google/gemini-pro-latest、x-ai/grok-4.6、hakila/auto
  • 模型須在這把 API Key 的允許清單內;可用的模型以 GET /v1/models 為準。 會自動讀取模型清單的工具,清單裡也會有 embedding、生圖等模型,寫程式請選 chat 模型。
  • 用量依各模型的 Hakila 價格計費,同樣受 API Key 與 Workspace 的預算管理。
  • Coding Agent 每一輪都會送出大量重複的上下文,Prompt Cache 能明顯降低成本。

OpenCode

OpenCode 以 @ai-sdk/openai-compatible 新增自訂供應商。把下面的內容寫進專案根目錄的 opencode.json, 或全域設定 ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hakila": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hakila",
      "options": {
        "baseURL": "https://api.hakila.ai/v1",
        "apiKey": "{env:HAKILA_API_KEY}"
      },
      "models": {
        "anthropic/claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "openai/gpt-6-sol": { "name": "GPT-6 Sol" },
        "google/gemini-pro-latest": { "name": "Gemini Pro (latest)" },
        "hakila/auto": { "name": "Hakila Auto" }
      }
    }
  },
  "model": "hakila/anthropic/claude-sonnet-5"
}

models 列出的模型會出現在 /models 選單,可以隨時切換;model 的格式是「供應商 id/模型 id」,所以前面要多加 hakila/。

Aider

Aider 透過 LiteLLM 呼叫 OpenAI 相容端點,模型名稱前面加上 openai/,其餘部分原樣送給 Hakila:

export OPENAI_API_BASE=https://api.hakila.ai/v1
export OPENAI_API_KEY=$HAKILA_API_KEY
aider --model openai/anthropic/claude-sonnet-5

Windows PowerShell:

$env:OPENAI_API_BASE="https://api.hakila.ai/v1"
$env:OPENAI_API_KEY=$env:HAKILA_API_KEY
aider --model openai/anthropic/claude-sonnet-5

也可以寫進專案或家目錄的 .aider.conf.yml:

openai-api-base: https://api.hakila.ai/v1
model: openai/anthropic/claude-sonnet-5

Aider 不認得 Hakila 的模型名稱時會提示找不到 context window 等資訊,不影響使用;可加 --no-show-model-warnings 關閉提示。 用 --editor-model、--weak-model 指定其他模型時,同樣要加 openai/ 前綴。

OpenHands

OpenHands 同樣透過 LiteLLM 呼叫模型。在 Settings → LLM 打開 Advanced,填入:

欄位值
Custom Modelopenai/anthropic/claude-sonnet-5
Base URLhttps://api.hakila.ai/v1
API KeyHakila API Key

用 CLI 或 SDK 時改設環境變數:

export LLM_MODEL=openai/anthropic/claude-sonnet-5
export LLM_BASE_URL=https://api.hakila.ai/v1
export LLM_API_KEY=$HAKILA_API_KEY

Roo Code

Roo Code 在設定的 Providers 新增一組設定檔:

欄位值
API ProviderOpenAI Compatible
Base URLhttps://api.hakila.ai/v1
API KeyHakila API Key
Model從清單選擇,或直接輸入模型 id,例如 anthropic/claude-sonnet-5

Roo Code 的每個模式(Architect、Code、Debug…)可以綁定不同的設定檔:例如規劃用 anthropic/claude-opus-5、寫程式用 anthropic/claude-sonnet-5,全部走同一把 Hakila API Key。

Cline

Cline 在設定的 API Configuration 填入:

欄位值
API ProviderOpenAI Compatible
Base URLhttps://api.hakila.ai/v1
API KeyHakila API Key
Model ID例如 anthropic/claude-sonnet-5

在 Model Configuration 依模型目錄填入 context window,並依模型勾選是否支援圖片, Cline 才會正確壓縮對話、允許貼上截圖。Plan 與 Act 模式可以分別指定模型。

Goose

Goose 執行 goose configure,選 Configure Providers → OpenAI,或直接設定環境變數:

export GOOSE_PROVIDER=openai
export GOOSE_MODEL=anthropic/claude-sonnet-5
export OPENAI_HOST=https://api.hakila.ai
export OPENAI_BASE_PATH=v1/chat/completions
export OPENAI_API_KEY=$HAKILA_API_KEY

OPENAI_HOST 不要加 /v1,路徑放在 OPENAI_BASE_PATH。Goose Desktop 也可以在 Settings → Models 新增 OpenAI 相容的自訂供應商, API URL 填 https://api.hakila.ai/v1。

Open Interpreter

Open Interpreter 在 ~/.openinterpreter/config.toml(或專案內的 .openinterpreter/config.toml)新增 Hakila 供應商:

model_provider = "hakila"
model = "openai/gpt-6-sol"

[model_providers.hakila]
name = "Hakila"
base_url = "https://api.hakila.ai/v1"
env_key = "HAKILA_API_KEY"
wire_api = "responses"

Hakila 的 Responses API 可以轉換到所有模型。Open Interpreter Desktop 則在 Settings → Models → New Model 選 Custom endpoint,填入 Base URL、API Key 與模型 id。

Open Interpreter 會在本機執行程式碼與指令。請保留執行前確認,不要在重要的機器上使用 -y 自動核准。

尚不支援:Gemini CLI

Gemini CLI 只會說 Gemini API 的原生協定(generateContent), Hakila 目前沒有提供這組端點,所以無法指向 Hakila。要在終端機使用 Gemini 模型,可以在上面任一個 Agent 選 google/gemini-pro-latest,或在 Claude Code 裡指定 Gemini 模型。

本頁目錄