編程工具接入

把 Token Cafe 接進 AI 編程工具。Claude Code/Codex 建議用 EchoBird 串接教學;也支援 Cline、Continue、OpenCode、Cherry Studio 等。一組 sk-cafe- Key 可用 OpenAI 與 Anthropic 雙協議。

先選工具,再選協議

最多人卡住的不是 API Key,而是 Base URL 多不多 /v1。照這張小抄設定,先用 MiniMax-M3 測通,再切正式模型。

First-run safe
Claude Code / Anthropic SDK 選 Anthropic-compatible。Base URL 用 https://api.aciemind.com,不要加 /v1 適合 repo 級代理、長任務、Claude 原生工具鏈。 走 EchoBird 教學 →
Codex / Cursor / Cline 選 OpenAI-compatible。Base URL 用 https://api.aciemind.com/v1,API Key 填 sk-cafe-... 適合 IDE、CLI、OpenAI SDK、常見 coding agent。 看配置範例 →
還不知道選哪個? 工具有 Provider 選單時,先找 Custom OpenAI / OpenAI Compatible;找不到再看是否支援 Anthropic Base URL。 第一次請用 MiniMax-M3,確認不會爆量呼叫。 看成本安全 →
401
Key 少貼、貼錯或已重建;回帳號中心新建一把。
402
既有額度不足;新的預付額度目前暫停,請查看付款政策或聯絡客服。
429
工具自動重試太密;降低並發/RPM 或換低成本模型。
502/503
上游暫時異常;查服務狀態或稍後重試。

快速設定

只要你的工具支援 OpenAI-compatibleAnthropic-compatible 自訂 Base URL,就可以接入 Token Cafe。若要用 Claude Code/Codex,建議直接走 EchoBird 串接教學

OpenAI Base URLhttps://api.aciemind.com/v1(Codex、OpenAI 相容工具)
Anthropic Base URLhttps://api.aciemind.com(Claude Code、Anthropic 相容工具;不要多加 /v1
API Keysk-cafe-...(兩邊可填同一把;帳號中心建立,只顯示一次)
Model ID使用短名稱,例如 gpt-5.4-miniclaude-haiku-4-5MiniMax-M3MiniMax-M3
模型清單token.aciemind.com/models.htmlGET https://api.aciemind.com/v1/models

如果工具要求「Provider」選項,優先選 OpenAI CompatibleCustom OpenAIOpenAI API Compatible 這類名稱。不要選內建 OpenAI 官方帳號,否則可能會忽略你的自訂 Base URL。

如果你想照圖一步一步操作,可以直接看 Token Cafe × VS Code 串接教學

通用 curl 測試

curl https://api.aciemind.com/v1/chat/completions \
  -H "Authorization: Bearer sk-cafe-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M3","messages":[{"role":"user","content":"請用一句話確認連線成功"}]}'

支援工具總覽

以下工具只要支援自訂 OpenAI-compatible / Anthropic-compatible Provider,就能使用。工具本身版本更新很快;若選單名稱不同,抓住三個核心欄位即可:Base URL、API Key、Model。

Cursor

AI IDE / 編輯器;適合日常 coding、review、重構。

查看配置 →

Claude Code

CLI agent;適合 repo 級任務與長流程操作。

查看配置 →

Codex / OpenAI-compatible CLI

支援 OpenAI Base URL 的 CLI 或 agent 工具。

查看配置 →

Cline / Roo Code

VS Code Agent,可設定 Custom Provider。

查看配置 →

OpenCode / OpenClaw / aider

偏 CLI / terminal 工作流的 AI coding 工具。

查看配置 →

Cherry Studio

多模型桌面客戶端;適合測模型與日常對話。

查看配置 →

其他工具

只要能自訂 Provider,基本上都能接。

查看配置 →

常用配置

Cursor

  1. 打開 Settings → Models。
  2. 新增或編輯 OpenAI-compatible / Custom API Provider。
  3. Base URL 填 https://api.aciemind.com/v1
  4. API Key 填 sk-cafe-...
  5. Model 填你要用的模型,例如 gpt-5.4-miniclaude-haiku-4-5MiniMax-M3

Claude Code(建議搭配 EchoBird)

主推流程:用 EchoBird 安裝/啟動 Claude Code,並在模型中心填入 Token Cafe 的 Anthropic 地址。完整步驟見 Token Cafe × EchoBird 串接教學

Anthropic Base URLhttps://api.aciemind.com(不要加 /v1
API Keysk-cafe-...
MessagesPOST https://api.aciemind.com/v1/messages

Codex(建議搭配 EchoBird)

主推流程:用 EchoBird 安裝/啟動 Codex,模型中心填入 Token Cafe 的 OpenAI 地址。詳見 EchoBird 串接教學

OpenAI Base URLhttps://api.aciemind.com/v1
API Keysk-cafe-...
ChatPOST https://api.aciemind.com/v1/chat/completions

Cline / Roo Code

ProviderOpenAI Compatible / Custom OpenAI
Base URLhttps://api.aciemind.com/v1
API Keysk-cafe-...
Modelclaude-haiku-4-5gpt-5.4-minigrok-4.5 或其他可用模型

Continue

Continue 的設定檔格式依版本不同會略有差異;重點是 provider 使用 OpenAI-compatible,並設定 base URL。

{
  "models": [
    {
      "title": "Token Cafe",
      "provider": "openai",
      "model": "gpt-5.4-mini",
      "apiBase": "https://api.aciemind.com/v1",
      "apiKey": "sk-cafe-..."
    }
  ]
}

OpenCode / OpenClaw / aider / 其他 CLI

若 CLI 支援 OpenAI API base,自訂成 Token Cafe 即可。

aider \
  --openai-api-base https://api.aciemind.com/v1 \
  --openai-api-key sk-cafe-... \
  --model gpt-5.4-mini

Cherry Studio / 桌面多模型客戶端

  1. 新增 Provider,類型選 OpenAI-compatible。
  2. Base URL:https://api.aciemind.com/v1
  3. API Key:sk-cafe-...
  4. Models 可手動新增,或嘗試從 /v1/models 拉取。

其他相容工具

如果工具沒有列在上面,但有下列欄位,就能接:

Provider = OpenAI Compatible Base URL = https://api.aciemind.com/v1 API Key = sk-cafe-...

推薦模型選擇

用途建議模型理由
先測連線 / DemoMiniMax-M3低價模型,適合驗證工具設定(依用量記錄,正式付款方案另行公告)。
日常 codinggpt-5.4-mini / claude-haiku-4-5速度與成本較平衡。
重構 / 複雜推理claude-sonnet-5 / grok-4.5適合較長上下文與多步驟任務。
中文與低成本qwen3-next-80b-a3b-instruct / mimo-v2.5中文能力與價格更友善。
多模型測試模型目錄看即時可用狀態、價格與能力標籤。

成本安全與排錯

Agent 上線前,先估每小時燒多少

把工具的預估呼叫頻率、平均 token、模型單價與你能接受的每小時預算填進來。這不是正式帳單,而是幫你在接入前決定 RPM、每日 token 與並發上限,避免 coding agent 一開就爆量。

預算估算載入中…調整左側數字後會自動更新建議。
  • 第一次接工具請先用 MiniMax-M3 或低價模型測試,確認工具不會自動發大量請求。
  • 到帳號中心為每把 API token 設定 RPM、每日限制、模型白名單與最大並發。
  • 大型 coding agent 可能會連續讀檔、改檔、反覆呼叫模型;建議使用較便宜模型跑探索,再切到高階模型做關鍵決策。
  • 若看到 401,檢查 API Key 是否完整;402 表示既有額度不足或付款方案尚未啟用;429 表示請求太密或達到 token 速率上限。
  • 回應 header x-cafe-channel 會顯示實際使用的上游通道,可用來驗證路由與成本。

更多 API 細節請看 接入文件OpenAPI 參考