入门指南

从注册到第一次成功请求，只需要 3 步：创建 API Key、选择工具、发送测试请求。

先选择你的路径

你想做什么	先看哪一页
在 AI 工具中直接使用	工具接入总览
使用 Codex	Codex配置
使用 Claude Code	Claude配置
在程序或脚本中调用	开发者 API
查看余额、订单和请求记录	账户与用量
遇到请求或配置问题	故障处理
团队接入、私有化或定制合作	合作咨询

3 步开始

第 1 步：创建 API Key

登录控制台，进入 API密钥页面，点击创建密钥、选择使用的模型分组，点击创建后即可。

第 2 步：选择接入方式

使用开发工具：按 Codex、Claude Code、OpenCode、OpenClaw 或 Hermes 页面配置。

不熟悉配置文件：优先使用 CC Switch 工具进行配置。

直接改配置文件：让免费AI帮助修改，或者按各工具的官方文档修改配置。

自己写程序：阅读开发者 API，先用最短请求验证。

第 3 步：发送测试请求

第一次只发送一条短消息，确认认证、模型和网络都正常，再运行长任务、流式输出或工具调用。

开始前准备

一个私库云账号

一个有效的 API Key

账户中有余额，或已开通可用订阅

你准备使用的客户端工具或开发环境

通用接入参数

配置项	填写内容
Base URL	以控制台和工具配置页显示的地址为准，通常以 /v1 结尾
API Key	在控制台创建的 API Key
Model	在当前可用模型列表中选择

不要凭旧截图填写地址和模型名。服务地址、模型和价格可能随账户及平台状态更新。

第一次测试检查清单

API Key 没有多余空格，也没有被禁用。

Base URL 没有重复拼接 /v1。

Model 使用控制台当前显示的名称。

工具或终端已完全重启。

控制台请求记录中能看到测试请求。

能力状态

文档中的能力会标记为：

已支持：当前可以按页面说明使用。

灰度中：仅部分模型、账户或用户可用。

规划中：已纳入开发方向，不建议作为生产依赖。

规划方向会优先围绕 OpenAI、Anthropic 兼容协议，以及主流开发工具的实际接入需求推进。新能力上线前，以控制台显示状态为准。

API Key 安全

不要把 API Key 放进前端网页、公开仓库、截图或聊天记录。

不要提交包含密钥的配置文件。

怀疑泄露时，立即禁用旧 Key 并创建新 Key。

排查问题时只提供脱敏后的错误信息和请求时间。

普通用户阅读“工具配置”即可；只有需要自行写程序或调用 SDK 时，才需要阅读“开发者 API”。

配置流程示意图

完成标志

你已经可以：

创建并安全保存 API Key。

确认 Base URL 和模型名称。

发出第一条短请求并在控制台看到记录。

下一步

直接配置工具：查看工具接入。

自己写程序：查看开发者 API。

查看余额和请求记录：查看账户与用量。

先选择你的路径#

3 步开始#

开始前准备#

通用接入参数#

第一次测试检查清单#

能力状态#

API Key 安全#

配置流程示意图#

完成标志#

下一步#