claude-code-router/docs/i18n/zh-CN/docusaurus-plugin-content-docs/advanced/presets.md

id, title, sidebar_position

id	title	sidebar_position
advanced/presets	预设配置	3

预设配置

使用预定义配置进行快速设置。

什么是预设？

预设是预配置的设置，包括针对特定用例优化的提供商配置、路由规则和转换器。

可用预设

Development（开发）

针对软件开发任务优化：

• 快速响应时间
• 适合代码生成
• 成本效益高

配置特点：

• 使用轻量级模型处理后台任务
• 为代码任务选择专用模型
• 优化的超时设置

Research（研究）

针对研究和分析优化：

• 支持长上下文
• 高质量响应
• 更强大的模型

配置特点：

• 使用具有大上下文窗口的模型
• 为分析任务选择高级模型
• 较长的超时时间

Balanced（平衡）

在速度和质量之间取得平衡：

• 良好的通用性能
• 合理的成本
• 广泛的模型支持

配置特点：

• 混合使用快速和高质量的模型
• 适合大多数日常任务
• 平衡的成本效益

使用预设

使用 CLI 应用预设：

ccr preset apply development

列出可用预设：

ccr preset list

创建自定义预设

您可以通过保存配置并稍后重新加载来创建自定义预设：

# 将当前配置保存为预设
ccr preset save my-preset

# 加载已保存的预设
ccr preset apply my-preset

预设管理

列出所有预设

ccr preset list

输出示例：

可用预设:
  development    - 开发优化配置
  research       - 研究优化配置
  balanced       - 平衡配置
  my-preset      - 自定义预设

应用预设

ccr preset apply <预设名称>

应用预设后，服务器将自动重启以加载新配置。

删除预设

ccr preset delete <预设名称>

预设文件位置

预设保存在：

~/.claude-code-router/presets/

每个预设都是一个 JSON 文件，包含完整的配置。

预设文件示例

{
  "name": "development",
  "description": "针对软件开发优化的配置",
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "$DEEPSEEK_API_KEY",
      "models": ["deepseek-chat", "deepseek-coder"]
    },
    {
      "name": "groq",
      "api_base_url": "https://api.groq.com/openai/v1/chat/completions",
      "api_key": "$GROQ_API_KEY",
      "models": ["llama-3.3-70b-versatile"]
    }
  ],
  "Router": {
    "default": "deepseek,deepseek-chat",
    "background": "groq,llama-3.3-70b-versatile",
    "think": "deepseek,deepseek-chat"
  }
}

导出和导入预设

导出当前配置

ccr config show > my-config.json

导入配置

ccr config edit
# 然后粘贴导入的配置

最佳实践

1. 为不同项目创建预设：为不同的工作流程创建专门的预设
2. 版本控制：将常用预设保存在版本控制中
3. 文档化：为自定义预设添加描述
4. 测试：在应用预设后验证配置

下一步

• CLI 参考 - 完整的 CLI 命令参考
• 配置 - 详细配置指南