配置文件导出

把 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 内手动粘贴导入。

导入前的校验清单：

API Key 已选中且未禁用
模型字段为目标应用支持的模型（例如 Claude Code 应选择 Claude 系模型）
调用线路与目标应用所在网络匹配
工具 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 中提出。

配置文件导出 ​

快速开始流程（推荐顺序） ​

字段说明（按页面顺序） ​

3.1 选择 API Key ​

3.2 选择模型 ​

3.3 选择调用线路 ​

3.4 API 接入地址 ​

3.5 选择工具 ​

3.6 CC Switch 一键导入 ​

Base URL 使用规则速查 ​

CC Switch 一键导入说明 ​

5.1 适用场景 ​

5.2 导入目标差异 ​

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

安全与排障 ​

6.1 API Key 安全 ​

6.2 线路选择建议 ​

6.3 常见问题与处理 ​

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

反馈渠道 ​