Kiro CLI 安装和 PATH 配置教程
Kiro CLI 是什么?
Kiro CLI 是一个终端 AI 编程助手,前身是 Amazon Q Developer CLI。你在命令行里和 AI 对话,让它写代码、跑命令、管理基础设施。
支持自定义 Agent、MCP 服务器集成、和 Kiro IDE 共享配置。2.0 版本加入了 Windows 原生支持和 headless CI/CD 模式。
怎么安装 Kiro CLI?
macOS / Linux
curl -fsSL https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/kiro-cli/kiro-cli-linux-x64.zip -o kirocli.zip
unzip kirocli.zip
./kirocli/install.sh
安装脚本会提示是否自动修改 shell 配置。选 Yes 的话会自动添加 PATH。
或者用快捷安装:
curl -fsSL https://kiro.dev/install.sh | bash
Ubuntu (.deb 包)
wget https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/kiro-cli/kiro-cli.deb
sudo dpkg -i kiro-cli.deb
sudo apt-get install -f
验证安装
kiro-cli --version
PATH 找不到 kiro-cli 怎么办?
这是最常见的问题。安装脚本把二进制放在 ~/.local/bin/,但你的 shell 可能没把这个目录加入 PATH。
# 立即生效
export PATH="$HOME/.local/bin:$PATH"
# 持久化到 .bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
zsh 用户:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
确认:
which kiro-cli
# /home/你的用户名/.local/bin/kiro-cli
Kiro CLI 的配置文件在哪?
| 路径 | 用途 |
|---|---|
~/.kiro/ | 全局配置根目录 |
~/.kiro/settings/mcp.json | MCP 服务器配置 |
.kiro/steering/*.md | 项目级 AI 行为规则 |
.kiro/skills/ | 自定义技能 |
MCP 配置示例:
{
"mcpServers": {
"my-tool": {
"command": "npx",
"args": ["my-mcp-server"],
"env": {},
"timeout": 60000
}
}
}
怎么和 Kiro IDE 共享配置?
如果你同时用 Kiro IDE 和 Kiro CLI,配置自动共享:
- MCP 服务器配置:同一个
~/.kiro/settings/mcp.json - Steering Rules:同一个
.kiro/steering/目录 - 项目文档:
.kiro/下的所有内容
配置一次,两个环境都能用。
WSL 安装注意事项
在 WSL 里安装和普通 Linux 一样:
curl -fsSL https://kiro.dev/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
确保在 WSL 的 home 目录执行(/home/你的用户名),不要在 Windows 挂载目录(/mnt/c/...)里装。
常见问题速查
| 问题 | 解决 |
|---|---|
command not found: kiro-cli | 把 ~/.local/bin 加入 PATH |
| 安装脚本报权限错误 | chmod +x ./kirocli/install.sh |
| macOS 上 ~/.local/bin 不存在 | mkdir -p ~/.local/bin 后重新安装 |
| 登录后无法启动 | 检查网络,Kiro 需要连接 AWS 服务 |