User Guide

配置切换

快速切换 AI 客户端配置

配置切换

配置切换功能让你可以一键在不同的 AI 客户端配置之间切换。

功能目的

当你需要在不同场景使用不同的 AI 服务时:

  • 开发时使用 Kiro Claude
  • 测试时使用 Gemini CLI
  • 生产时使用自定义 OpenAI

配置切换让你无需手动修改配置,一键完成切换。

预设配置

内置配置档案

档案说明
Claude Code适用于 Claude Code 客户端
Codex适用于 OpenAI Codex
Gemini CLI适用于 Gemini CLI

配置内容

每个档案包含:

  • 默认 Provider
  • 路由规则
  • 模型映射
  • API 端点配置

创建配置档案

新建档案

  1. 进入 配置切换 页面
  2. 点击 新建档案
  3. 输入档案名称
  4. 配置以下内容:
name: "我的配置"
description: "自定义配置档案"
provider: kiro-claude
routes:
  - pattern: "*"
    provider: kiro-claude
settings:
  timeout: 120s
  retry: 3

从当前配置创建

  1. 配置好当前设置
  2. 点击 保存为档案
  3. 输入档案名称
  4. 档案保存成功

切换配置

一键切换

  1. 进入 配置切换 页面
  2. 查看可用档案列表
  3. 点击目标档案的 应用 按钮
  4. 配置立即生效

快捷切换

使用标签页快速切换:

  • Claude Code 标签
  • Codex 标签
  • Gemini CLI 标签

点击标签即可切换到对应配置。

设置活动配置

标记当前配置

当前使用的配置会显示 当前使用中 标记。

切换活动配置

  1. 选择目标档案
  2. 点击 设为活动
  3. 该档案成为当前活动配置

档案管理

编辑档案

  1. 点击档案的 编辑 按钮
  2. 修改配置内容
  3. 点击 保存

删除档案

  1. 点击档案的 删除 按钮
  2. 确认删除操作
内置档案无法删除,但可以修改。

导出档案

单独导出某个档案:

  1. 点击档案的 导出 按钮
  2. 选择保存位置
  3. 档案保存为 .yaml 文件

导入档案

  1. 点击 导入档案
  2. 选择 .yaml 文件
  3. 档案添加到列表

使用场景

场景 1: 开发/测试切换

开发环境: 使用 Kiro Claude(免费额度)
测试环境: 使用 Gemini CLI(快速响应)

场景 2: 模型切换

代码生成: Claude Sonnet(高质量)
快速问答: Gemini Flash(低延迟)

场景 3: 团队协作

团队成员 A: 使用个人 Kiro 账户
团队成员 B: 使用共享 API Key