Kiro CLI 是 Amazon Q Developer CLI 的后续升级方向，保留 q、q chat、MCP、rules、custom agents 等既有工作流，同时引入 Kiro steering、更多登录方式和新的订阅管理。迁移重点不是重学 CLI，而是理解配置路径和企业治理变化。
Kiro CLI 从 Amazon Q Developer CLI 迁移：保留工作流并升级体验
如果你的团队已经在使用 Amazon Q Developer CLI，迁移到 Kiro CLI 不需要从零开始。Kiro CLI 继承了 Q Developer CLI 的核心能力，包括 agent mode、MCP、rules、custom agents 和 hooks，并提供更统一的 Kiro 开发体验。
对个人开发者来说，迁移后可以继续使用熟悉的 q 和 q chat 入口；对企业管理员来说，更重要的是理解 authentication、subscription、配置目录和数据使用策略的变化。
Kiro CLI 和 Q Developer CLI 的主要差异
| 领域 | Kiro CLI | Amazon Q Developer CLI |
|---|---|---|
| 安装方式 | native install | dmg / zip 安装包 |
| Authentication | GitHub、Gmail、Builder ID、IAM Identity Center | Builder ID、IAM Identity Center |
| 命令入口 | kiro-cli |
q / q chat |
| 规则体系 | Kiro steering | Amazon Q rules |
| Subscriptions | Q Developer 和 Kiro | Q Developer 和 Kiro |
| 功能 | MCP、custom agents、hooks | MCP、custom agents、hooks |
| License | AWS Intellectual Property License | Apache 2.0 |
认证方式的详细说明可查看 Authentication guide。
如何升级
最简单的升级方式是执行：
q update如果你启用了自动更新，也可以通过自动更新切换到 Kiro CLI。迁移完成后，建议逐步把日常入口从 q / q chat 改为：
kiro-cli
kiro-cli chat不过 Kiro CLI 仍保持向后兼容，原有 q 和 q chat 入口可以继续工作。
安装时会发生什么迁移
安装 Kiro CLI 时，会执行一次性迁移。它不会破坏原有 .amazonq 目录，而是复制必要配置到 Kiro 的新目录。
迁移动作包括：
- 将
~/.aws/amazonq下的 prompts 和 agents 复制到~/.kiro，名称保持不变。 - 将
~/.aws/amazonq/mcp.json复制到~/.kiro/settings/mcp.json。如果 MCP server 配置冲突，会跳过冲突项。 - 将
~/.aws/amazonq/rules下的 rules 复制到~/.kiro/steering。 - 根据 Amazon Q Developer CLI 设置创建
~/.kiro/settings/cli.json。 - 项目内已有
.amazonq目录仍会被读取；新保存的 prompt 或 agent 配置会写入.kiro。如果项目同时存在.amazonq和.kiro，优先读取.kiro。
这意味着老项目可以继续运行，新项目则应逐步采用 .kiro 目录。
配置路径对照
| 配置 | 作用范围 | Kiro CLI | Q Developer CLI |
|---|---|---|---|
| MCP servers | User | ~/.kiro/settings/mcp.json |
~/.aws/amazonq/mcp.json |
| MCP servers | Workspace | .kiro/settings/mcp.json |
.amazonq/mcp.json |
| Prompts | User | ~/.kiro/prompts |
~/.aws/amazonq/prompts |
| Prompts | Workspace | .kiro/prompts |
.amazonq/prompts |
| Custom agents | User | ~/.kiro/agents |
~/.aws/amazonq/cli-agents |
| Custom agents | Workspace | .kiro/agents |
.amazonq/cli-agents |
| Rules / Steering | User | ~/.kiro/steering |
~/.aws/amazonq/rules |
| Rules / Steering | Workspace | .kiro/steering |
.amazonq/rules |
| Settings | Global | ~/.kiro/settings/cli.json |
无对应文件 |
迁移期间建议保留原 .amazonq 配置，等团队确认 Kiro CLI 行为稳定后，再统一整理到 .kiro。
工具名称兼容性
Kiro CLI 简化了一些 tool names，但旧名称仍保持兼容，因此已有 custom agents 通常不需要立即改动。
| Amazon Q 名称 | Kiro CLI 名称 |
|---|---|
fs_read |
read |
fs_write |
write |
use_aws |
aws |
execute_bash |
shell |
report_issue |
report |
如果你维护企业级 agent 模板，建议逐步把新模板改成 Kiro CLI 的名称，老模板保留兼容即可。
订阅和企业管理变化
Kiro CLI 可以继续配合 Q Developer Pro subscription 使用，也支持 Kiro 自身的 subscription。Kiro dashboard 会分别显示 Q Developer 和 Kiro 的订阅。
企业管理员可以按以下粒度迁移用户：
- 整个 profile。
- 某个 group。
- 单个 user。
升级发生在 user 级别，因此管理员可以先迁移试点团队，再逐步推广到整个组织。
关于定价，可查看 Kiro pricing。
内容使用、telemetry 和输出赔偿
需要特别关注三点：
- 模型训练和服务改进：Kiro Pro、Pro+、Power 用户如果通过 AWS IAM Identity Center 访问 Kiro，内容不会用于训练。通过 Amazon Q Developer Pro subscription 和 AWS 账号访问 Kiro，也不会用于 service improvement。Free Tier 和个人订阅用户通过 social login 或 AWS Builder ID 访问时，某些内容可能会用于 service improvement。
- Telemetry：通过 AWS IAM Identity Center 访问的 Kiro Pro、Pro+、Power 用户不会收集 telemetry。企业管理员仍可配置组织内 user activity reports。
- Output indemnity：付费 Kiro subscribers 与 Q Developer Pro 用户一样，可获得 output indemnity，具体以 AWS Service Terms 第 50.10 节为准。
这些差异会影响企业采购、法务和合规评审，迁移前应提前确认登录方式和订阅类型。
如果暂时不想迁移
你可以继续使用 Amazon Q Developer CLI，但新功能和修复会优先进入 Kiro CLI。对于仍需回退的团队，可以卸载 Kiro CLI：
kiro-cli uninstall然后重新安装 Amazon Q Developer CLI v1.19.7：
遇到问题时怎么排查
迁移出错时，建议按顺序检查：
- 查看 CLI Commands Reference。
- 查看 Chat documentation。
- 检查
$TMPDIR/kiro-log下的日志。 - 通过 Kiro dashboard 联系支持。
下一步
- 体验 Chat features。
- 配置 Custom Agents。
- 接入 MCP integration。
- 设置 Agent Hooks。
常见问题
迁移到 Kiro CLI 后，原来的 q chat 会失效吗？
不会。Kiro CLI 保持向后兼容，q 和 q chat 仍可继续使用。不过新文档和新能力会以 kiro-cli 为主，建议逐步切换入口。
.amazonq 目录会被 Kiro CLI 修改吗？
不会。安装迁移会复制配置到 .kiro 或 ~/.kiro，不会直接修改已有 .amazonq 目录。
企业用户应该优先迁移什么？
先确认 authentication 和 subscription 策略，再迁移 MCP、agents、rules。尤其要确认是否通过 IAM Identity Center 登录，因为这会影响 privacy、telemetry 和 compliance 判断。