User Guide
配置切换
快速切换 AI 客户端配置
配置切换
配置切换功能让你可以一键在不同的 AI 客户端配置之间切换。
功能目的
当你需要在不同场景使用不同的 AI 服务时：
- 开发时使用 Kiro Claude
- 测试时使用 Gemini CLI
- 生产时使用自定义 OpenAI
配置切换让你无需手动修改配置，一键完成切换。
预设配置
内置配置档案
| 档案 | 说明 |
|---|---|
| Claude Code | 适用于 Claude Code 客户端 |
| Codex | 适用于 OpenAI Codex |
| Gemini CLI | 适用于 Gemini CLI |
配置内容
每个档案包含：
- 默认 Provider
- 路由规则
- 模型映射
- API 端点配置
创建配置档案
新建档案
- 进入 配置切换 页面
- 点击 新建档案
- 输入档案名称
- 配置以下内容：
name: "我的配置"
description: "自定义配置档案"
provider: kiro-claude
routes:
- pattern: "*"
provider: kiro-claude
settings:
timeout: 120s
retry: 3
从当前配置创建
- 配置好当前设置
- 点击 保存为档案
- 输入档案名称
- 档案保存成功
切换配置
一键切换
- 进入 配置切换 页面
- 查看可用档案列表
- 点击目标档案的 应用 按钮
- 配置立即生效
快捷切换
使用标签页快速切换：
- Claude Code 标签
- Codex 标签
- Gemini CLI 标签
点击标签即可切换到对应配置。
设置活动配置
标记当前配置
当前使用的配置会显示 当前使用中 标记。
切换活动配置
- 选择目标档案
- 点击 设为活动
- 该档案成为当前活动配置
档案管理
编辑档案
- 点击档案的 编辑 按钮
- 修改配置内容
- 点击 保存
删除档案
- 点击档案的 删除 按钮
- 确认删除操作
导出档案
单独导出某个档案：
- 点击档案的 导出 按钮
- 选择保存位置
- 档案保存为
.yaml文件
导入档案
- 点击 导入档案
- 选择
.yaml文件 - 档案添加到列表
使用场景
场景 1: 开发/测试切换
开发环境: 使用 Kiro Claude（免费额度）
测试环境: 使用 Gemini CLI（快速响应）
场景 2: 模型切换
代码生成: Claude Sonnet（高质量）
快速问答: Gemini Flash（低延迟）
场景 3: 团队协作
团队成员 A: 使用个人 Kiro 账户
团队成员 B: 使用共享 API Key