用戶端與 SDK 設定工具

Claude Code、Codex 與 Cursor API 設定產生器

Q: 為什麼 Claude Code 的 ANTHROPIC_BASE_URL 不加 /v1？

Claude Code 會依照 Anthropic SDK 慣例在內部自動附加 /v1/messages。 若在 ANTHROPIC_BASE_URL 加上 /v1，實際路徑會變成 /v1/v1/messages 並導致 HTTP 404 失敗。

選擇你的 AI 編碼代理或後端 SDK，挑選現行目錄模型 ID，即可複製已驗證的設定檔與最小連通性測試指令。

執行方式免登入 · 100% 瀏覽器本地計算協定範本確認於 2026 年 11 月 11 日

目標用戶端或 SDK目錄模型 ID環境變數名稱串流輸出模式

1. Configuration file or SDK snippet

request.example

// ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://app.llmfly.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CLAUDE_GROUP_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-5-5"
  }
}

2. Minimal connectivity smoke test

request.example

claude -p "Reply with OK." --model claude-sonnet-5-5

工程原理與上線檢查

Claude Code、Codex CLI 與 Cursor 的底層協定差異

即使連線至同一個閘道網域，不同開發工具所使用的底層傳輸格式也並不相同。 Claude Code 採用 Anthropic 原生 Messages 協定，要求將 ANTHROPIC_BASE_URL 設為不帶 /v1 後綴的 https://app.llmfly.ai，並搭配 Claude Code 分組金鑰。

相對地，Codex CLI 與新一代 OpenAI 推理模型（如 gpt-6-astra、gpt-6.1-sol、gpt-6-sol 與 gpt-6.1-terra）依賴 OpenAI 的 /v1/responses 協定，以在多輪執行間保留推理摘要、修補程式與工具呼叫狀態。 Cursor 與一般對話程式庫則連線至 https://app.llmfly.ai/v1 並使用 /v1/chat/completions。

用戶端 / SDK	Base URL	底層呼叫協定	設定檔位置
Claude Code	https://app.llmfly.ai	Anthropic Messages API	~/.claude/settings.json
Codex CLI	https://app.llmfly.ai/v1	OpenAI Responses API (responses)	~/.codex/config.toml
Cursor IDE	https://app.llmfly.ai/v1	OpenAI Chat Completions	Cursor 設定 -> Models
OpenAI Python / TS SDK	https://app.llmfly.ai/v1	Responses 或 Chat Completions	伺服器端環境變數

首次設定如何避免 401、403 與 404 錯誤

超過 90% 的首次連線失敗皆源於三類設定錯誤：重複加上 /v1（導致 /v1/v1/chat/completions 回傳 404）、輸入展示名稱「GPT-6 Astra」而非精確小寫目錄 ID gpt-6-astra，或使用了屬於不同模型分組的 API Key。

請將官方帳號憑證與 LLMFly AI 閘道金鑰分別存放在不同的終端機設定檔或專案目錄中，避免 CLI 工作階段誤刷錯帳戶。
在啟用 MCP 伺服器、程式碼庫索引或背景子代理之前，請先執行步驟 2 所示的非串流最小連通性測試。
請為每台開發機、CI 執行器與測試環境核發獨立的 API Key，以便在洩漏或到期時單獨撤銷。

常見問題

為什麼 Claude Code 的 ANTHROPIC_BASE_URL 不加 /v1？

Claude Code 會依照 Anthropic SDK 慣例在內部自動附加 /v1/messages。若在 ANTHROPIC_BASE_URL 加上 /v1，實際路徑會變成 /v1/v1/messages 並導致 HTTP 404 失敗。

Python 或 TypeScript 應用何時應使用 client.responses.create 而非 chat.completions.create？

呼叫 GPT-6 Astra、GPT-6.1 Sol、GPT-6 Sol 與 GPT-6.1 Terra 時——特別是結合推理強度與函數呼叫或內建 Responses 工具時，請使用 client.responses.create。

同一個 API Key 可以同時用於 Claude Code 與 GPT 模型嗎？

請在 LLMFly AI 控制台確認該金鑰綁定的分組權限。 Claude Code 路由與 OpenAI Codex/GPT 路由在模型廣場分別屬於特定的計費分組。

為你的開發環境建立專屬金鑰

在控制台產生限定範圍的 API Key，一分鐘內驗證首筆 CLI 或 SDK 請求。

取得 API 金鑰