私库云 - 开发文档
  1. 03. 工具接入
  • 开始使用
    • 入门指南
    • 模型价格
  • 03. 工具接入
    • 工具接入总览
    • CC Switch 配置
    • Codex 配置
    • Claude Code 配置
    • OpenCode 配置
    • OpenClaw 配置
    • Hermes 配置
  • 04. 开发者 API
    • API 调用说明
  • 05. 账户与用量
    • 账户与用量总览
  • 06. 故障处理
    • 问题排查
  • 07. 合作咨询
    • 合作需求提交
  1. 03. 工具接入

工具接入总览

规划中
每个工具都有独立页面。请按编号进入对应文档,完成下载、安装、配置和首次测试。

工具目录#

编号工具适合人群独立文档
03.1CC Switch想用图形界面切换配置的用户03.1 CC Switch
03.2Codex使用终端进行代码任务的用户03.2 Codex
03.3Claude Code使用 Claude 进行终端开发的用户03.3 Claude Code
03.4OpenCode使用开源终端代码工具的用户03.4 OpenCode
03.5OpenClaw使用自动化 AI 工具的用户03.5 OpenClaw
03.6Hermes使用 Hermes Agent 的用户03.6 Hermes

配置流程示意#

这是所有工具通用的接入路径。各工具的字段名称和界面位置可能不同,请以对应工具页面和当前版本为准。

通用配置#

所有工具通常都需要:
配置项填写内容
Base URL直接复制控制台显示的服务地址
API Key在控制台创建的 API Key
Model使用控制台当前可用的模型名
如果 Base URL 已经包含 /v1,不要再次拼接。不同协议的接口路径和认证字段不同,请以对应工具页为准。

推荐接入流程#

下载官方版本 → 完成安装 → 填写 Base URL / API Key / Model → 重启工具 → 发送短消息 → 查看请求记录
第一次测试不要直接运行长任务或开启复杂工具调用。先确认最短请求成功,再逐步增加功能。

如何选择#

不熟悉配置文件:从 03.1 CC Switch 开始。
使用 OpenAI Responses API:阅读 03.2 Codex。
使用 Anthropic Messages API:阅读 03.3 Claude Code。
想使用 OpenAI-compatible Provider:阅读 03.4 OpenCode。
使用 OpenClaw 或 Hermes:进入对应编号页面,按版本界面配置。

通用排错#

401:检查 API Key 和认证头。
403:检查账户、Key 或接口权限。
404:检查 Base URL 和 /v1 是否重复。
429:检查余额、额度、并发和频率限制。
超时:先用短请求测试网络和模型。
配置不生效:完全退出工具和终端后重新打开。

安全要求#

不要把 API Key 放进公开仓库、前端网页、截图或聊天记录。
不要从非官方来源下载工具。
排查问题时只提交脱敏后的错误信息、时间和状态码。
Key 泄露后立即禁用并重新创建。

配置示意图#

私库云首次接入流程示意图

完成标志#

工具已经完成安装,配置中填写了 Base URL、API Key 和当前模型,并且短消息能够返回结果。

下一步#

使用 Codex、Claude Code、OpenCode、OpenClaw 或 Hermes:直接打开下方对应页面。
请求失败:查看 常见问题。
需要程序化调用:查看 开发者 API。
上一页
模型价格
下一页
CC Switch 配置
Built with