跳转到内容

Kiro CLI 安装和 PATH 配置教程

· 7 分钟阅读

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.jsonMCP 服务器配置
.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 服务

相关链接

FAQ

kiro-cli 装在哪里?
默认安装到 ~/.local/bin/kiro-cli。macOS 也可能在 ~/.cargo/bin/kiro-cli(通过 cargo 安装时)。
Kiro CLI 和之前的 Amazon Q CLI 是什么关系?
Kiro CLI 就是 Amazon Q Developer CLI 改名而来。功能一样,品牌换了。原有配置自动兼容。
WSL 里能用 Kiro CLI 吗?
能。目前没有 Windows 原生版之前需要通过 WSL 安装。2.0 版本已支持 Windows 原生安装。
Kiro CLI 免费吗?
有免费层(Builder ID 登录),也有 Pro 层。免费层够日常开发用。

相关文章