SilkAPI 使用文档

Appearance

CC-Switch 使用教程 ​

CC-Switch 是一个用于管理 Claude Code、Codex、Gemini CLI 等 AI 命令行工具配置的桌面工具。你可以把 SilkAPI 的接口地址和 API 令牌保存为供应商配置，然后在不同工具、不同供应商和不同模型配置之间快速切换。

本教程适合已经完成 SilkAPI 账号注册、订阅购买和 API 令牌创建的用户。如果你还没有 API 令牌，请先阅读快速开始。

适用场景 ​

使用 CC-Switch 可以减少手动修改配置文件的次数，尤其适合以下场景：

  • 同时使用 Claude Code、Codex、Gemini CLI
  • 需要在官方接口和 SilkAPI 中转接口之间切换
  • 有多个 API 令牌或多个模型分组
  • 希望用图形界面管理 CLI 工具配置

下载安装 ​

访问 CC-Switch 的 GitHub Releases 页面下载适合当前系统的安装包：

CC-Switch Releases

Windows 用户通常选择 .msi 安装包；macOS 用户可以选择 .dmg、.app 或使用 Homebrew；Linux 用户按发行版选择 .deb、.rpm 或 AppImage。

macOS 使用 Homebrew 安装时，可以参考：

bash
brew tap farion1231/ccswitch
brew install --cask cc-switch

安装完成后，打开 CC-Switch 主程序。如果系统提示来自未验证开发者，请在系统设置的安全性选项中允许打开。

准备 SilkAPI 配置 ​

打开 SilkAPI 控制台，准备以下信息：

配置项说明
API Key在 SilkAPI 控制台创建的 API 令牌
Base URLSilkAPI 控制台显示的接口地址
模型名称需要在 CLI 中使用的模型名称

接口地址请以控制台显示为准。如果控制台没有单独说明，可以先按 OpenAI 兼容接口格式填写：

text
https://api.silkapi.com/v1

API Key 属于敏感信息，请不要写入公开文档、截图、代码仓库或聊天记录。

配置 Claude Code ​

  1. 打开 CC-Switch。
  2. 在顶部或侧边的工具分组中选择 Claude 或 Claude Code。
  3. 新增一个供应商配置，名称可以填写 SilkAPI Claude。
  4. 在 API Key 输入框中粘贴 SilkAPI API 令牌。
  5. 在 Base URL 或 Endpoint 中填写 SilkAPI 接口地址。
  6. 保存配置，并点击启用或切换到该配置。

配置完成后，在终端运行：

bash
claude

如果 Claude Code 能正常进入对话并返回内容，说明配置已经生效。

配置 Codex ​

  1. 打开 CC-Switch。
  2. 切换到 Codex 分组。
  3. 新增供应商配置，名称可以填写 SilkAPI Codex。
  4. 填入 SilkAPI API Key。
  5. 填入 SilkAPI Base URL。
  6. 保存后启用该配置。

配置完成后，在终端运行：

bash
codex

如果 Codex 能正常启动并调用模型，说明 CC-Switch 已经把 SilkAPI 配置写入到 Codex 使用的配置位置。

配置 Gemini CLI ​

  1. 打开 CC-Switch。
  2. 切换到 Gemini 分组。
  3. 新增供应商配置，名称可以填写 SilkAPI Gemini。
  4. 填入 SilkAPI API Key 和接口地址。
  5. 保存并启用配置。

配置完成后，在终端运行：

bash
gemini

如果 Gemini CLI 能正常响应，说明配置成功。

使用 CC-Switch CLI ​

如果你更习惯在终端操作，可以使用 CC-Switch CLI 来查看、切换或修复配置。不同版本命令可能略有差异，建议先查看帮助：

bash
cc-switch --help

常见操作包括：

bash
# 查看当前版本
cc-switch --version

# 查看命令帮助
cc-switch --help

如果你在服务器或 SSH 环境中使用，CLI 模式会比桌面界面更方便。

验证配置是否生效 ​

完成任意工具配置后，建议按以下顺序检查：

  1. 确认 CC-Switch 中当前启用的是 SilkAPI 配置。
  2. 确认 API Key 没有多余空格，也没有复制到错误的分组。
  3. 确认 Base URL 与 SilkAPI 控制台显示一致。
  4. 在终端重新打开一个新会话，再启动对应 CLI。
  5. 发送一个简单问题，观察是否能正常返回结果。

常见问题 ​

启用配置后 CLI 仍然走旧接口 ​

关闭当前终端窗口，重新打开一个新终端后再试。部分 CLI 会在启动时读取环境变量或配置文件，已经运行的进程不会自动刷新。

提示 API Key 无效 ​

检查 API Key 是否复制完整，是否包含多余空格，令牌是否被删除、禁用或没有对应模型权限。

提示模型不存在 ​

确认当前 CLI 使用的模型名称在 SilkAPI 中可用。不同工具可能有默认模型名，如果默认模型不在当前订阅或分组内，需要在 CLI 设置里改成可用模型。

macOS 无法打开应用 ​

进入系统设置，打开隐私与安全性，找到被拦截的应用并选择仍要打开。只建议从官方 GitHub Releases 下载 CC-Switch。

安全建议 ​

  • 不要把 API Key 直接贴到公开截图里。
  • 不要把真实令牌提交到 Git 仓库。
  • 不同工具建议创建不同名称的 API 令牌，方便后续排查和停用。
  • 如果怀疑令牌泄露，请立即在 SilkAPI 控制台删除旧令牌并创建新令牌。