Claude Code Router (CCR) Settings
一个用于管理 Claude Code Router 配置的 VS Code 扩展插件，提供图形化界面来配置和管理 CCR 的各项设置。
功能特性
🎯 核心功能
图形化配置界面
- 提供可视化的设置面板，无需手动编辑配置文件
- 实时预览和编辑配置更改
模型路由管理
- 默认模型: 用于常规对话的模型
- 思考模型: 用于复杂推理和分析的模型
- 长上下文模型: 用于处理大量上下文的模型
- 后台任务模型: 用于后台运行的任务
- 网络搜索模型: 用于网络搜索功能的模型
- 图像模型: 用于图像处理的模型
提供商管理
- 支持多个 AI 服务提供商（OpenAI、Anthropic、本地模型等）
- 自动获取可用模型列表
- 手动添加自定义模型
快速切换模型
- 命令面板快速切换各个路由的模型
- 一键批量设置多个路由使用同一模型
- 实时重启 CCR 服务
配置文件管理
- 直接打开 CCR 配置文件
- 直接打开 Claude Code 设置文件
Transformers 插件支持
- 配置和使用 Transformers 插件
- 支持多个插件实例
配置选项
基础配置
| 配置项 |
描述 |
默认值 |
| 启用日志 |
是否启用日志记录 |
true |
| 日志级别 |
日志输出级别 |
warn |
| 服务器地址 |
CCR 服务器地址 |
127.0.0.1 |
| 服务器端口 |
CCR 服务器端口 |
3456 |
| API 密钥 |
API 认证密钥 |
空 |
| API 超时(ms) |
API 请求超时时间 |
600000 |
| 代理 URL |
网络代理地址 |
空 |
| Claude 路径 |
Claude 可执行文件路径 |
空 |
模型路由配置
每个路由可以指定不同的模型，具体包括：
- default: 默认对话模型
- think: 思考推理模型
- longContext: 长上下文模型（支持 100K+ tokens）
- background: 后台任务模型
- webSearch: 网络搜索模型
- image: 图像处理模型
提供商配置
每个提供商包含以下信息：
- 名称: 提供商标识符（如 openai、anthropic）
- API 基础地址: API 接口地址
- API 密钥: 认证密钥
- 模型列表: 支持的模型列表
支持配置多个 Transformers 插件：
- 插件路径: 插件文件路径
- 插件选项: 插件配置参数
使用方法
1. 安装插件
在 VS Code 中搜索 "claude-code-router Settings" 并安装。
2. 打开设置面板
使用命令面板（Ctrl+Shift+P）执行以下命令之一：
ccr: Open Settings Panel - 打开图形化设置面板ccr: Open CCR config.json - 直接打开 CCR 配置文件ccr: Open CC settings.json - 直接打开 Claude Code 设置文件
3. 添加提供商
- 在设置面板中点击"添加新的提供商"
- 输入提供商名称（如 openai）
- 输入 API 基础地址
- 输入 API 密钥
- 输入支持的模型列表，或点击"获取模型"自动获取
4. 配置模型路由
- 在"路由配置"部分，点击每个路由的下拉菜单
- 选择对应的模型（格式：提供商名,模型名）
- 点击"保存配置"并重启 CCR
5. 快速切换模型
使用命令面板执行以下命令：
ccr: Quick Switch Default、Think、Long Context、Background Model - 一键设置四个主要路由ccr: Switch Default Model - 切换默认模型ccr: Switch Think Model - 切换思考模型ccr: Switch Long Context Model - 切换长上下文模型ccr: Switch Background Model - 切换后台任务模型ccr: Switch Web Search Model - 切换网络搜索模型ccr: Switch Image Model - 切换图像模型
6. 重启 CCR
ccr: Restart CCR - 重启 CCR 服务
配置文件路径
插件默认的配置文件路径：
Windows
- CCR 配置文件:
%USERPROFILE%\.claude-code-router\config.json
- Claude Code 设置:
%USERPROFILE%\.claude\settings.json
Linux/Mac
- CCR 配置文件:
/root/.claude-code-router/config.json
- Claude Code 设置:
/root/.claude/settings.json
自定义路径
可以通过 VS Code 设置自定义配置文件路径：
{
"ccr.ccrConfigPath": "自定义 CCR 配置文件路径",
"ccr.ccSettingsPath": "自定义 Claude Code 设置路径"
}
高级功能
模型自动获取
插件可以自动从 API 获取可用的模型列表，确保配置的模型名称正确。
实时配置同步
配置更改后会自动同步到配置文件，并可以立即重启 CCR 应用更改。
错误处理
提供详细的错误提示和日志输出，帮助诊断配置问题。
注意事项
- 确保 Claude Code Router 已正确安装并运行
- 首次使用时，插件会自动创建默认配置文件
- 修改配置后需要重启 CCR 才能生效
- 网络搜索和图像功能需要相应的模型支持
开发信息
- 支持平台: Windows, Linux, macOS
- VSCode 版本要求: ^1.85.0
- 依赖: TypeScript, ESLint, Webpack
贡献
欢迎提交 Issue 和 Pull Request 来改进这个插件。
| |
