🚀 版本亮点
cc-switch 是一款为 Claude Code、Codex 和 Gemini CLI 打造的一站式助手工具,本次 v3.12.4
版本带来了重要功能更新,彻底解决了自定义非标API接口的配置难题。
核心优势
✅ 全路径URL模式支持:现在支持直接填写完整的API
endpoint地址,不再局限于标准的baseURL格式
✅ 完美适配各类云服务:特别是火山方舟、百度智能云、腾讯云等需要特殊路径格式的服务商
✅ 零配置切换:勾选一个选项即可切换模式,无需复杂设置
✅ 保持兼容性:原有配置方式完全不受影响,平滑升级
✅ 模型自动拉取:全路径模式下仍然支持一键拉取可用模型列表
🔧 实战配置:火山方舟免费模型接入教程
火山方舟(火山引擎)的免费模型接口格式比较特殊,传统的baseURL配置方式无法直接使用,新版
本的全路径URL模式完美解决了这个问题。
步骤1:获取火山方舟API信息
-
创建你的推理端点,获取完整的API调用地址,类似:
https://ark.cn-beijing.volces.com/api/v3/chat/completions
- 获取你的API Key
步骤2:在cc-switch中配置
-
打开cc-switch,进入「供应商管理」→ 「添加供应商」
-
应用类型选择「OpenCode」
-
接口格式选择「OpenAI Compatible」
-
填写供应商名称(如:火山方舟-免费模型)
-
在「Base URL」中粘贴完整的API地址:
https://ark.cn-beijing.volces.com/api/v3/chat/completions
-
✅ 勾选 「全路径URL模式(完整模型API地址)」 选项 ⭐ 这是关键!
-
填写你的API Key
-
在模型配置中添加你要使用的模型,例如:
-
模型ID:doubao-seed-2-0-code-preview-latest
-
显示名称:豆包Seed代码预览版
- 点击「保存」完成配置
步骤3:测试使用
配置完成后,你可以:
-
直接在cc-switch中切换到该供应商使用
-
一键测速验证接口可用性
-
享受火山方舟免费模型带来的高速体验
🎯 适用场景
这个功能特别适合以下情况:
-
云服务商的自定义端点路径不标准
-
使用第三方API网关时需要特定路径
-
本地部署的模型服务路径特殊
-
各类需要完整URL才能调用的API接口
💡 小贴士
-
全路径模式同时支持OpenAI兼容格式和Anthropic格式
-
配置后可以使用「拉取模型」功能自动获取可用模型列表
-
如果遇到404错误,首先检查是否勾选了全路径模式
-
旧版本用户升级到最新版即可获得该功能,无需重新配置现有供应商
cc-switch - 让AI编程助手的使用更简单!
项目地址:https://gitee.com/jinguangyang/cc-switch/releases/tag/v3.12.4
下载地址:https://gitee.com/jinguangyang/cc-switch/releases/tag/v3.12.4