配置文件导出
把 API Key、模型和调用线路打包给 Claude Code、Cursor、Python SDK、CC Switch 等工具的一站式接入助手。
这个页面是用来做什么的
「配置文件导出」是一站式接入助手。 它把以下四个变量组合成可以直接复制粘贴或一键导入的配置：
- 已创建的 API Key；
- 默认使用的模型；
- 适合网络环境的调用线路；
- 要接入的目标工具。
页面会按以上四项动态生成：
- 推荐使用的 Base URL（OpenAI 兼容版与 Anthropic / Claude 兼容版）
- 每个工具对应的 配置片段 或 导入说明
- CC Switch 一键导入 入口，直接把生成的应用配置写入 CC Switch（支持 Codex、Claude Code、OpenCode、OpenClaw 等目标）
如果你只是想快速试一次接口调用，参见站内文档 快速开始。 如果你要把 gpt88.cc 接到本地工具或团队 IDE，使用本页面更省事。
快速开始流程（推荐顺序）
- 在控制台 API Keys 中创建或选择一个 API Key
- 打开配置文件导出页面
- 选择 API Key、模型和 Base URL
- 选择目标工具 tab
- 复制配置，或一键导入 CC Switch
- 在目标工具中发送一次请求确认接入成功
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 选择模型
- 该字段决定生成配置中的默认模型。
- 默认模型可以是任意可用的聊天模型。
- 切换模型后必须重新生成或重新导入，旧配置不会自动更新。
- 运行时也可以在工具 UI 或请求参数中临时覆盖 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 / 工具 |
| Anthropic / Claude Base URL | https://api.gpt88.cc | Anthropic 风格 SDK / 工具 |
| 图片 / 视频 Base URL | https://img.gpt88.cc | 图片生成、视频生成和 Gemini 原生图片接口 |
- 标准文本与 Claude 协议共用 https://api.gpt88.cc；媒体请求使用 https://img.gpt88.cc。
- 拼错 Base URL 或路径可能出现 404、unknown route /v1/v1 或 unknown route /messages；先检查 endpoint、请求头和请求体字段。
- 点击地址或复制按钮即可复制，工具地址会随调用线路和工具 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 内手动粘贴。
导入前的校验清单：
- API Key 已选中且未禁用
- 模型字段为目标应用支持的模型
- 调用线路与目标应用所在网络匹配
- 工具 tab 与导入目标一致
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 收到后未弹出 → 检查是否已登录、版本是否过旧；必要时退出重启。
- 导入后调用失败 → 检查 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、headers 和 body |
| 429 | 用量配额或上游限流 | 查看控制台用量，降低并发并增加退避重试 |
| 网络超时 / Connection reset | 当前线路不稳定 | 固定匹配接口类型的 Base URL，重新检查 Key、模型和请求格式 |
| model not found | 模型 ID 错误或 Key 未开放该模型 | 重新选择模型，并确认控制台中的可用模型范围 |
| CC Switch 无反应 | 自定义协议未注册或浏览器拦截 | 复制导入链接，在 CC Switch 内粘贴 |
与本文档站现有内容的关系
- 快速开始：拿到 Key 后编写第一行代码。
- API Reference：查看每个接口的参数和响应。
- 本文档：把 Key、模型和线路打包给具体工具。
三者互为补充，第一次接入建议按 配置文件导出 → 快速开始 → API Reference 的顺序阅读。
反馈渠道
- 若文档与 Agent 控制台行为不符，请通过控制台反馈入口提交，并附上线路、工具 tab、期望与实际结果。
- 文档站的纠错和补充建议，可在 Agent 控制台或仓库 issue 中提出。