CC-Switch：一站式配置编程智能体

CC-Switch 是第三方配置管理工具，用于管理 Codex、Claude Code 等客户端的服务商配置。它不是接入本站的必需软件。

#下载与准备

从 CC-Switch 项目发布页 下载适合系统的版本。使用系统协议导入时，需要安装包成功注册对应协议；不同版本与安装方式可能有差异。

先备份已有配置和历史记录。历史统一或迁移属于独立功能，不必为了连接 API 开启，也不应假定迁移一定可以恢复丢失记录。

#从控制台导入

1. 在 控制台 的「API 密钥」页创建对应分组密钥。
2. 点击该密钥的「导入到 CCS」，确认浏览器调用的是本机可信的 CC-Switch。
3. 在导入预览中核对 API 地址、密钥、目标客户端、模型和协议。
4. 启用该供应商；如果使用本地代理模式，再按 CC-Switch 界面启动代理。
5. 重启对应客户端，发送短消息，并到本站使用记录核对。

导入链接包含认证信息，不能发到群聊或公开截图。只有明确导入时才允许浏览器唤起本机程序。

#地址怎么填

• Codex 直接使用自定义供应商：base_url = "https://api.sfapi.de/v1"，协议 responses。
• Claude Code：ANTHROPIC_BASE_URL=https://api.sfapi.de，使用对应的 Messages 协议。
• 国内线路将域名换为 api-cn.sfapi.de。
• CC-Switch 的字段或代理模式可能自动处理版本前缀，请检查最终生成配置与请求路径，不要套用统一的“必须去掉 /v1”。

#模型与常见问题

从 模型广场 复制当前分组支持的模型 ID。模型可见不等于支持所有客户端协议或工具调用。

出现 401、404、429、503 或超时时，参考 故障排查。推理强度和上下文压缩保持客户端支持的默认值，按具体错误再调整。