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 的新目录。

迁移动作包括：

1. 将 ~/.aws/amazonq 下的 prompts 和 agents 复制到 ~/.kiro，名称保持不变。
2. 将 ~/.aws/amazonq/mcp.json 复制到 ~/.kiro/settings/mcp.json。如果 MCP server 配置冲突，会跳过冲突项。
3. 将 ~/.aws/amazonq/rules 下的 rules 复制到 ~/.kiro/steering。
4. 根据 Amazon Q Developer CLI 设置创建 ~/.kiro/settings/cli.json。
5. 项目内已有 .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 和输出赔偿

需要特别关注三点：

1. 模型训练和服务改进：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。
2. Telemetry：通过 AWS IAM Identity Center 访问的 Kiro Pro、Pro+、Power 用户不会收集 telemetry。企业管理员仍可配置组织内 user activity reports。
3. 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：

• MacOS
• Linux x86-64
• Linux ARM

遇到问题时怎么排查

迁移出错时，建议按顺序检查：

1. 查看 CLI Commands Reference。
2. 查看 Chat documentation。
3. 检查 $TMPDIR/kiro-log 下的日志。
4. 通过 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 判断。