一人一器
  • 简体中文

    • CC Switch

    CC Switch 是 Claude Code、Codex、Hermes 和 OpenClaw 的 Provider 配置管理器，不是独立执行任务的 Agent。使用 Geekit 时，优先让目标客户端直接连接匹配的协议；只有协议确实不匹配时，才启用 CC Switch 的本地转换。

    核验日期：2026-07-27

    先按 CC Switch 官方仓库的安装说明完成安装或更新，再配置需要接管的目标客户端。

    选择目标客户端

    先确定要由 CC Switch 管理哪一个客户端，再按对应协议添加 Geekit Provider：

    目标客户端协议地址
    Codex CLIOpenAI Responseshttps://geekit.yryq.top/v1
    Claude CodeAnthropic Messageshttps://geekit.yryq.top
    Hermes Agent取决于 api_mode参见 Hermes Agent
    OpenClaw取决于 api参见 OpenClaw

    模型 ID 必须来自 Geekit 的 /v1/models，不要直接照搬客户端内置的模型名称。

    添加 Geekit Provider

    在 CC Switch 的 Provider 管理中创建自定义 Provider，并填写：

    • 名称：Geekit
    • API Key：Geekit 用户令牌
    • Base URL：按上表选择
    • 模型：Geekit 中真实可用的模型 ID

    保存后，将该 Provider 应用到 Codex、Claude Code 或其他目标客户端。切换 Provider 后，关闭已有 CLI 会话并重新启动，避免进程继续使用旧环境变量或旧配置。

    CC Switch 可以统一管理配置，但令牌仍属于敏感信息。不要假设所有版本都会对本地保存的 API Key 做静态加密；设备需要启用磁盘加密、账户锁屏和合理的文件权限。

    什么时候启用本地转换

    以下情况才需要协议转换：

    • 客户端只发送 Anthropic Messages，但 Geekit 中准备使用的模型只适合 Responses。
    • 客户端只发送 Responses，但目标模型只适合 Anthropic Messages。
    • 已确认直接连接失败原因是协议不匹配，而不是地址、令牌或模型 ID 错误。

    启用转换后，CC Switch 会成为本地请求链路的一部分。此时必须：

    1. 保持 CC Switch 持续运行。
    2. 开启总路由和目标应用的接管或路由选项。
    3. 重新启动目标 CLI 会话。
    4. 分别检查 CC Switch 路由记录和 Geekit 调用日志。

    协议原本一致时不要开启转换。直接连接链路更短，也更容易定位流式事件、工具调用和错误响应。

    验证

    先在目标客户端执行一个最小只读任务，然后确认：

    1. CC Switch 显示当前应用正在使用 Geekit Provider。
    2. Geekit 调用日志中出现预期端点，例如 /v1/responses 或 /v1/messages。
    3. 日志中的模型 ID 与 CC Switch 配置一致。
    4. 流式输出和工具调用都能完成。

    如果 /v1/models 自动发现失败，可以手动填写模型 ID；这不代表推理端点不可用。

    恢复原配置

    在 CC Switch 中切回原 Provider，并重新启动对应 CLI。若启用了本地转换，同时关闭总路由和应用接管，确认客户端不再指向 CC Switch 的本地地址。

    官方资料