客户端与 SDK 配置工具

Claude Code、Codex 与 Cursor API 配置生成器

选择你正在使用的 AI 编码工具或服务端 SDK,挑好在售目录中的准确模型 ID,即可直接复制配好协议路径的配置文件与最小连通性自检命令。

运行方式免登录 · 纯浏览器本地计算协议模板复核于 2026 年 11 月 11 日
01

生成可直接复制的客户端与 SDK 配置文件

选择你的编码工具或后端 SDK,自动匹配正确的协议地址(/v1/responses、/v1/chat/completions 或 Claude Code 原生环境变量)与准确模型 ID。

1. 配置文件或代码片段

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. 连通性最小自检命令

request.example
claude -p "Reply with OK." --model claude-sonnet-5-5
02

工程原理与上线检查

Claude Code、Codex CLI 与 Cursor 的底层协议差异

即便连接同一个网关域名,不同编码工具使用的底层协议也并不相同:Claude Code 采用 Anthropic 原生 Messages 协议,要求 ANTHROPIC_BASE_URL 填写 https://app.llmfly.ai(末尾不能加 /v1),并搭配 Claude Code 分组下的 API Key。

而 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。

客户端 / SDKBase URL 地址底层调用协议默认配置文件位置
Claude Codehttps://app.llmfly.aiAnthropic Messages API~/.claude/settings.json
Codex CLIhttps://app.llmfly.ai/v1OpenAI Responses API (responses)~/.codex/config.toml
Cursor IDEhttps://app.llmfly.ai/v1OpenAI Chat CompletionsCursor Settings -> Models
OpenAI Python / TS SDKhttps://app.llmfly.ai/v1Responses 或 Chat Completions服务端环境变量

首次接入如何避免 401、403 与 404 报错

超过 90% 的首次接入报错都源于三类细节错误:重复拼接 /v1(导致请求打到 /v1/v1/chat/completions 返回 404)、把页面展示标题(如 "GPT-6 Astra")当成模型参数填写而非准确的小写 ID gpt-6-astra,或者使用了未授权目标模型分组的 API Key。

  • 建议把厂商官方账号凭据与 LLMFly AI 网关 Key 放在不同的终端 Profile 中,避免长任务误刷错账户。
  • 启用 MCP 工具、全仓索引或后台子 Agent 之前,先运行上方第 2 步生成的非流式最小自检命令。
  • 为每台开发机、CI 流水线和预发环境分别创建独立 Key,一旦泄露可单独吊销而不影响线上服务。

常见问题

为什么 Claude Code 的 ANTHROPIC_BASE_URL 末尾不能带 /v1?

Claude Code 内部会按 Anthropic SDK 规范自动拼接 /v1/messages;如果在环境变量末尾再加 /v1,实际请求会变成 /v1/v1/messages 并返回 HTTP 404。

Python 或 TypeScript 什么时候该用 client.responses.create?

调用 gpt-6-astra、gpt-6.1-sol、gpt-6-sol 与 gpt-6.1-terra 时优先使用 client.responses.create,尤其是在同时开启推理档位与函数调用的场景下。

同一个 API Key 可以同时用于 Claude Code 和 GPT 模型吗?

取决于该 Key 在控制台绑定的分组权限。请在 LLMFly AI 模型广场确认当前 Key 所属分组支持的模型列表。

为你的开发环境创建专属 API Key

前往控制台生成按环境隔离的 API Key,一分钟内跑通首条 CLI 或 SDK 请求。

获取 API Key