配置文件导出
把 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 等目标）
如果你只是想快速试一次接口调用，参见站内文档 快速开始。 如果你要把 gpt88.cc 接到本地工具或团队 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. 确认 Base URL：标准 API 使用 https://api.gpt88.cc，图片 / 视频使用 https://img.gpt88.cc
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 统一 API 入口
标准 API 与图片 / 视频直连分别使用网站首页展示的 Base URL：
https://api.gpt88.cc（标准 API）
https://img.gpt88.cc（图片 / 视频直连）
- API Key、模型和鉴权方式在所有工具中保持同一套配置。
- 协议差异通过 endpoint 路径、请求头和请求体字段处理。
- 排查连接问题：先确认接口类型对应了正确的 Base URL，再检查 API Key、模型、endpoint 和请求格式。
3.4 API 接入地址
页面按接口类型显示首页中的官方 Base URL，协议风格还会影响 endpoint 和配置字段：
| 风格 | 路径形态 | 适用场景 |
|---|---|---|
| OpenAI 兼容 Base URL | https://api.gpt88.cc | OpenAI 风格 SDK / 工具（OpenAI Python SDK、OpenAI Node.js SDK、Cursor、OpenCode、按 OpenAI 协议写的 cURL、Hermes 等） |
| Anthropic / Claude Base URL | https://api.gpt88.cc | Anthropic 风格 SDK / 工具（Claude Code、OpenClaw、Anthropic Python / TypeScript SDK 等） |
| 图片 / 视频 Base URL | https://img.gpt88.cc | 图片生成、视频生成和 Gemini 原生图片接口，按文档使用 /v1 或 /v1beta endpoint |
- 标准文本与 Claude 协议共用
https://api.gpt88.cc；媒体请求使用https://img.gpt88.cc。 - 拼错的典型症状：404 Not Found、
unknown route /v1/v1/...、unknown route /messages。 出现这些错误时，先确认 endpoint 路径、请求头和请求体字段，不要更换 Base URL。 - 点击地址或右上角「复制当前工具地址」按钮可一键复制；当前工具地址会随上方 「调用线路 + 工具 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
标准 API 工具 / SDK
→ Base URL：https://api.gpt88.cc
→ OpenAI / Claude / 音频等标准 API 按 endpoint 路径、请求头和请求体字段接入
图片 / 视频直连
→ Base URL：https://img.gpt88.cc
→ 图片与视频 endpoint 按对应 API 文档使用 /v1 或 /v1beta 路径
任何工具
→ 不要手动拼接第二个 /v1如果你既要在 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 线路选择建议
- 标准 API 使用
https://api.gpt88.cc，图片 / 视频直连使用https://img.gpt88.cc。 - 如果请求失败或超时，先检查 endpoint、API Key、模型和请求格式， 不要通过更换 Base URL 规避问题。
- 生产环境始终固定使用同一个 Base URL，避免配置漂移。
6.3 常见问题与处理
| 问题 | 可能原因 | 处理 |
|---|---|---|
| 请求返回 401 Unauthorized | API Key 错误、被禁用、复制时少了字符 | 重新从控制台复制 Key，或重新生成；确认 Authorization: Bearer sk-... 头没拼错 |
请求返回 404 Not Found 或 unknown route | Base URL 与接口类型不匹配，或 endpoint 路径和协议格式不匹配 | 先选择与接口类型匹配的 Base URL，再检查 endpoint、请求头和请求体字段 |
| 请求返回 429 | 用量配额或上游限流 | 控制台查看用量；降低并发、加重试退避；具体限速以控制台为准 |
| 网络超时 / Connection reset | 当前线路在你的网络下不稳定 | 固定使用与接口类型匹配的 Base URL，重新确认 API Key、模型、endpoint 和请求格式 |
| 模型调用返回 model not found | 模型 ID 拼错、所选模型未对该 Key 开放 | 重新选择模型导出；在控制台确认 Key 可用模型范围 |
| CC Switch 一键导入无反应 | 系统未注册 CC Switch 自定义协议 / 浏览器拦截 | 改用「复制导入链接」，在 CC Switch 内粘贴 |
| 导入到 CC Switch 后调用失败 | 旧 Key 缓存、模型不兼容目标工具 | 重新导入；检查目标工具与所选模型的兼容性 |
与本文档站现有内容的关系
- 快速开始 偏重「拿到 Key 后写第一行代码」。
- API Reference 列出每个接口的参数和响应。
- 本「配置文件导出」文档侧重「把 Key + 模型 + 线路打包给某个具体工具」。
三者互为补充。开发者第一次接入建议按 配置文件导出 → 快速开始 → API Reference 的顺序看。
反馈渠道
- 若发现本文档与 Agent 控制台实际行为不符，请通过控制台内的反馈入口反馈，并附上 「线路 + 工具 tab + 期望 vs 实际」三项最小信息。
- 文档站本身的纠错、补充建议，欢迎在 Agent 控制台或仓库 issue 中提出。