Skip to content

配置文件导出 ​

把 API Key + 模型 + 调用线路打包给 Claude Code、Cursor、Python SDK、CC Switch 等工具的一站式接入助手。

把 API Key + 模型 + 调用线路打包给 Claude Code、Cursor、Python SDK、CC Switch 等工具的一站式接入助手。

「配置文件导出」是一站式接入助手。它把以下四个变量组合成可以直接复制粘贴或一键导入的配置:

  • 你已创建的 API Key(控制台中签发的 sk-... 凭证)
  • 这次接入想默认使用的 模型(如 claude-haiku-4-5-20251001)
  • 适合你网络环境的 调用线路(中国大陆 / 海外全球加速)
  • 你要接入的 目标工具(Claude Code、Cursor、OpenCode、OpenClaw、Hermes、cURL、Python SDK、Anthropic SDK 等)

页面会按以上四项动态生成:

  • 推荐使用的 Base URL(OpenAI 兼容版与 Anthropic / Claude 兼容版)
  • 每个工具对应的 配置片段 或 导入说明
  • CC Switch 一键导入 入口,直接把生成的应用配置写入 CC Switch(支持 Codex、Claude Code、OpenCode、OpenClaw 等目标)

如果你只是想快速试一次接口调用,参见站内文档 快速开始。 如果你要把 kukuai.fyi 接到本地工具或团队 IDE,使用本页面更省事。

快速开始流程(推荐顺序) ​

recommended ordertext

1. 在控制台「API Keys」中创建或选择一个 API Key
2. 打开「配置文件导出」页面
3. 选择 API Key(默认列出你账号下的所有 Key)
4. 选择模型(如 claude-haiku-4-5-20251001 / claude-opus-4-7 / gpt-5.4 等)
5. 选择调用线路(当前公开端点统一使用 kukuai.fyi 的 API 代理)
6. 选择要接入的工具 tab(Claude Code / Cursor / Python SDK …)
7a. 复制 Base URL + 复制工具对应的配置片段,粘贴到目标工具的设置中;
    或
7b. 选择 CC Switch 导入目标,点击「一键导入到 CC Switch」
8. 在目标工具中触发一次请求,确认接入成功

字段说明(按页面顺序) ​

3.1 选择 API Key ​

  • 下拉列出当前账号下所有可用的 API Key(如 ClaudeCode(sk-F9flH0n…))。
  • 列表里只显示 Key 的名称和首尾几位字符,完整 Key 不会在前端裸露; 导出生成的配置文件中会写入完整 Key。

安全提醒:

  • 不要把生成的配置文件、截图或日志直接发到群聊 / 公共代码仓库 / 第三方截图工具。
  • 在做技术分享或写文档时,请把 Key 中段替换为 ***,例如 sk-F9flH0n***ABC1。
  • 如果误泄漏了 Key,请立刻在 控制台 「API Keys」中禁用并重新生成。
  • Key 的权限范围、用量上限、可调用模型范围以控制台显示为准,本文档不写死具体数值。

3.2 选择模型 ​

  • 该字段决定生成的配置文件中工具的「默认模型」。
  • 默认模型可以是任意可用的聊天模型(如 claude-opus-4-7、claude-haiku-4-5-20251001、gpt-5.4、deepseek-v4-pro 等)。
  • 切换模型后必须重新生成或重新导入:旧配置中的模型字段不会自动更新。
  • 工具运行时如果需要切换模型,可以在工具自身的 UI 或运行参数中临时覆盖 (例如 Claude Code 在会话中可指定 model;cURL 请求可在 body 里换 model 字段)。

3.3 选择调用线路 ​

当前 sub-router 对用户侧公开统一代理端点:

线路

推荐场景

示例地址

统一 API 代理

中国大陆、海外服务器、跨境网络和本地开发环境

https://www.kukuai.fyi/api-proxy/china

  • OpenAI 兼容示例默认使用 https://www.kukuai.fyi/api-proxy/china/v1。
  • Anthropic / Claude 风格工具通常使用不带 /v1 的 https://www.kukuai.fyi/api-proxy/china。
  • 旧上游线路由 sub-router 内部管理,用户侧一般不需要直接填写。

3.4 API 接入地址 ​

页面会根据所选「调用线路」实时显示推荐 Base URL,并以两张卡片形式给出两种风格:

风格

路径形态

适用场景

OpenAI 兼容 Base URL

https://www.kukuai.fyi/api-proxy/china/v1

OpenAI 风格 SDK / 工具(OpenAI Python SDK、OpenAI Node.js SDK、Cursor、OpenCode、按 OpenAI 协议写的 cURL、Hermes 等)

Anthropic / Claude Base URL

https://www.kukuai.fyi/api-proxy/china

Anthropic 风格 SDK / 工具(Claude Code、OpenClaw、Anthropic Python / TypeScript SDK 等)

  • 两个地址对应同一组上游服务,路由规则不同:OpenAI 风格的 SDK 期望最终 URL 是 …/v1/chat/completions,所以 Base URL 末尾加 /v1; Anthropic 风格 SDK 自己会拼 /v1/messages,所以 Base URL 不带 /v1。
  • 拼错的典型症状:404 Not Found、unknown route /v1/v1/...、unknown route /messages。 出现这些错误时,先确认你用的 SDK 是 OpenAI 还是 Anthropic 风格,并对照上表的路径形态。
  • 点击地址或右上角「复制当前工具地址」按钮可一键复制;当前工具地址会随上方 「调用线路 + 工具 tab」自动联动,避免你手动拼接。

3.5 选择工具 ​

页面以 tab 形式列出常见的接入目标,每个 tab 会生成对应工具能识别的配置:

工具 tab

配置形态

备注

Claude Code

Claude 风格配置(包含 baseURL、apiKey、defaultModel)

Anthropic SDK 风格

Hermes

工具自有配置文件

按 OpenAI 兼容协议接入

OpenClaw

Anthropic 风格配置

配合 Anthropic Base URL 使用

OpenCode

OpenAI 风格配置

配合 OpenAI Base URL 使用

Cursor

Cursor 设置中的「Custom OpenAI Base URL」+ 模型映射

Settings → Models → Custom

cURL

一段可直接 curl 的命令片段

验证连通性最快的方式

Python SDK

OpenAI 或 Anthropic 客户端初始化代码片段

按所选工具自动选择 SDK

Anthropic SDK

Anthropic Python / TypeScript 客户端示例

配合 Anthropic Base URL 使用

切换 tab 时,页面下方的代码块或配置片段会自动重写;右侧「复制」按钮也会随之更新内容。

3.6 CC Switch 一键导入 ​

CC Switch 是统一管理多套上游 API 配置的桌面客户端。本节让你跳过手动复制粘贴:

  • 导入目标:Codex、Claude Code、OpenCode、OpenClaw 等。 导入目标决定 CC Switch 中创建的「应用配置」名称和适用对象。
  • 一键导入到 CC Switch:点击后浏览器会调起本地 CC Switch(通过自定义协议)。 如果你已安装并登录了 CC Switch,配置会直接写入。
  • 复制导入链接:在浏览器无法调起 CC Switch(例如系统未注册自定义协议、或浏览器安全策略阻止)时, 使用此按钮把导入链接复制到剪贴板,再在 CC Switch 内手动粘贴导入。

导入前的校验清单:

  1. API Key 已选中且未禁用
  2. 模型字段为目标应用支持的模型(例如 Claude Code 应选择 Claude 系模型)
  3. 调用线路与目标应用所在网络匹配
  4. 工具 tab 与导入目标一致(例如要导入到 Claude Code,工具 tab 也建议选 Claude Code)

Base URL 使用规则速查 ​

rules of thumbtext

OpenAI 兼容工具 / SDK
  → Base URL:以 /v1 结尾
  → 例:https://www.kukuai.fyi/api-proxy/china/v1

Anthropic / Claude 工具 / SDK
  → Base URL:根地址,不带 /v1
  → 例:https://www.kukuai.fyi/api-proxy/china

任何工具
  → 优先使用页面顶部「当前工具推荐 Base URL」给出的值,已经按线路 + 工具 tab 拼好

如果你既要在 OpenAI 风格工具中接入,又要在 Anthropic 风格工具中接入, 可以使用同一个 API Key,只是 Base URL 路径形态不同。

CC Switch 一键导入说明 ​

5.1 适用场景 ​

  • 你已经在桌面安装了 CC Switch,并经常在多套配置之间切换(例如在 Claude Code、Codex、OpenCode 之间)。
  • 你不想手动维护每个工具的 ~/.config/... 文件。
  • 你希望 API Key、Base URL、默认模型在多个工具之间保持一致。

5.2 导入目标差异 ​

导入目标

CC Switch 中生成的配置类型

Codex

OpenAI 风格 Base URL;OpenAI Compatible 调用

Claude Code

Anthropic 风格 Base URL;Claude CLI 风格调用

OpenCode

OpenAI 风格 Base URL;OpenCode 兼容

OpenClaw

Anthropic 风格 Base URL;OpenClaw 兼容

实际生成的字段以 CC Switch 的最新版本为准;本表只描述大致风格归属。

5.3 一键导入失败时的兜底 ​

  • 浏览器报「无法访问该协议 / Custom protocol blocked」→ 改用「复制导入链接」,在 CC Switch 内手动粘贴。
  • CC Switch 收到后未弹出 → 检查 CC Switch 是否已登录、版本是否过旧;必要时退出重启。
  • 导入后调用失败 → 检查导入的 API Key 是否仍在有效期、模型是否仍可用、线路是否被重置。

安全与排障 ​

6.1 API Key 安全 ​

  • 不要把 Key 放进 Git 仓库;本地用 .env、~/.aws/credentials 等机制隔离。
  • 不要在公开论坛、博客、群聊、视频教程中展示完整 Key。
  • 导出的配置文件本身就含完整 Key,等同于密码:传输用私聊或加密通道,存档用受限目录。
  • 当怀疑 Key 已泄漏:进入 控制台 禁用旧 Key、生成新 Key、回到本页面重新导出配置、在所有用到的工具里更新。

6.2 线路选择建议 ​

  • 默认按你的物理位置选:中国大陆 → 中国调用;其他地区 → 海外全球加速。
  • 如果当前线路出现连续失败、超时或下载缓慢,先切到另一条线路再排查其他原因——线路切换是最便宜的修复尝试。
  • 不要在生产环境频繁切线路;切换会改变 Base URL,使所有已部署服务的请求路径变化。

6.3 常见问题与处理 ​

问题

可能原因

处理

请求返回 401 Unauthorized

API Key 错误、被禁用、复制时少了字符

重新从控制台复制 Key,或重新生成;确认 Authorization: Bearer sk-... 头没拼错

请求返回 404 Not Found 或 unknown route

OpenAI 风格 SDK 用了不带 /v1 的 Base URL,或 Anthropic 风格 SDK 用了带 /v1 的 Base URL

对照本文 §3.4 的「路径形态」表选对版本

请求返回 429

用量配额或上游限流

控制台查看用量;降低并发、加重试退避;具体限速以控制台为准

网络超时 / Connection reset

当前线路在你的网络下不稳定

切换调用线路重新生成配置

模型调用返回 model not found

模型 ID 拼错、所选模型未对该 Key 开放

重新选择模型导出;在控制台确认 Key 可用模型范围

CC Switch 一键导入无反应

系统未注册 CC Switch 自定义协议 / 浏览器拦截

改用「复制导入链接」,在 CC Switch 内粘贴

导入到 CC Switch 后调用失败

旧 Key 缓存、模型不兼容目标工具

重新导入;检查目标工具与所选模型的兼容性

与本文档站现有内容的关系 ​

  • 快速开始 偏重「拿到 Key 后写第一行代码」。
  • API Reference 列出每个接口的参数和响应。
  • 本「配置文件导出」文档侧重「把 Key + 模型 + 线路打包给某个具体工具」。

三者互为补充。开发者第一次接入建议按 配置文件导出 → 快速开始 → API Reference 的顺序看。

反馈渠道 ​

  • 若发现本文档与 控制台 实际行为不符,请通过控制台内的反馈入口反馈,并附上「线路 + 工具 tab + 期望 vs 实际」三项最小信息。
  • 文档站本身的纠错、补充建议,欢迎在 kukuai.fyi 控制台或仓库 issue 中提出。

统一 API 网关 · OpenAI Compatible