Aider

只需設定兩個環境變數並加上前綴。將 OPENAI_API_BASE 設為 https://api.kunavo.com/v1、將 OPENAI_API_KEY 設為你的 sk-kn-… 金鑰，然後使用 --model openai/<id> 執行 Aider。無須變更儲存庫或 Aider 安裝。

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在啟動 Aider 的 shell 中匯出 OPENAI_API_BASE 和 OPENAI_API_KEY，或依照下方範例將其放入 ~/.aider.conf.yml。
3. 在儲存庫中使用 aider --model openai/claude-sonnet-5 啟動 Aider。
4. Aider 啟動時會列印它解析出的模型。如果該行顯示你指定的 ID，就表示端點已正確連接。

Aider 自己對此的參考說明是OpenAI 相容 API 頁面。

不要放在 shell 設定檔中

這兩個值也可以放在 Aider 設定檔中；如果你依專案切換端點，設定檔會是更合適的位置。

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

先驗證，再除錯 Aider

一次請求就能確認故障出在端點、金鑰或 Aider 的模型解析。如果此請求傳回模型 ID 的 JSON 清單，相同的基底 URL 和金鑰就能在 Aider 中使用——剩下可能出錯的部分就是 openai/ 前綴。

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

該選哪些模型

Kunavo 上的所有文字模型都可透過 openai/<id> 呼叫——完整清單位於模型頁面，也可透過 GET /v1/models 即時取得。費率以每 1M token 的美元金額表示，順序為輸入／輸出。