其他 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 URL | https://api.hakila.ai/v1 |
| API Key | Hakila 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-5Windows 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-5Aider 不認得 Hakila 的模型名稱時會提示找不到 context window 等資訊,不影響使用;可加 --no-show-model-warnings 關閉提示。
用 --editor-model、--weak-model 指定其他模型時,同樣要加 openai/ 前綴。
OpenHands
OpenHands 同樣透過 LiteLLM 呼叫模型。在 Settings → LLM 打開 Advanced,填入:
| 欄位 | 值 |
|---|---|
| Custom Model | openai/anthropic/claude-sonnet-5 |
| Base URL | https://api.hakila.ai/v1 |
| API Key | Hakila 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_KEYRoo Code
Roo Code 在設定的 Providers 新增一組設定檔:
| 欄位 | 值 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.hakila.ai/v1 |
| API Key | Hakila 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 Provider | OpenAI Compatible |
| Base URL | https://api.hakila.ai/v1 |
| API Key | Hakila 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_KEYOPENAI_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 模型。