古法编程

Appearance

安装 Kiro CLI 时，需要根据 macOS、Windows、Linux AppImage、zip 或 Ubuntu deb 包选择合适方式，并完成浏览器认证。本文整理安装前提、自动更新、代理环境变量、卸载命令、日志位置和 kiro-cli doctor 排障流程，帮助你快速定位常见问题。

Kiro CLI installation：按系统完成安装、升级与排障 ​

Kiro CLI 是面向命令行使用的 agent 工具。安装时要根据操作系统选择不同包格式，并在首次启动后通过浏览器完成认证。对国内开发者来说，还要额外关注代理、企业网络、日志路径和 kiro-cli doctor 排障。

本文按平台整理安装思路。由于具体下载链接可能会随官方发布页面变化，实际下载包请以 Kiro 官方页面为准；本文重点说明每个平台的安装流程、升级方式和常见问题处理。

macOS ​

macOS 可以原生安装 Kiro CLI，并在命令行中启动。

安装完成后，运行 Kiro CLI 时会引导你打开浏览器，并按 Authentication 页面完成登录或授权。

如果你在终端里无法启动，优先检查：

  • 安装路径是否加入 PATH；
  • 当前 shell 是否重新加载配置；
  • 是否需要重新打开 Terminal；
  • 企业网络是否拦截了认证页面。

Windows ​

Windows 11 可以通过 PowerShell 安装 Kiro CLI。建议使用 Windows Terminal 或任意 PowerShell 终端执行安装命令。

首次启动后，Kiro 同样会引导你打开浏览器完成 Authentication。如果浏览器没有自动打开，可以留意终端输出的登录链接。

升级 ​

Kiro CLI 会在后台自动更新。新版本可用时，它会静默下载，并在你退出应用时完成安装。

如果你不希望自动更新，可以关闭：

bash
kiro-cli settings "app.disableAutoupdates" "true"

团队环境中如果需要固定版本，建议统一管理安装包和升级策略，避免成员之间 CLI 行为不一致。

卸载 ​

Windows 可以通过系统设置卸载：

text
Settings > Apps

也可以运行：

bash
kiro-cli uninstall

Linux AppImage ​

Linux 可以使用 AppImage 运行 Kiro CLI。AppImage 是便携格式，适合不想安装到系统目录、或没有 root 权限的场景。

基本流程：

  1. 下载 Linux AppImage 文件；
  2. 添加可执行权限；
  3. 运行 AppImage；
  4. 按终端提示打开浏览器完成 Authentication。

示例命令：

bash
chmod +x kiro-cli.appimage
./kiro-cli.appimage

如果运行失败，先确认文件是否下载完整、当前架构是否匹配、系统是否允许执行 AppImage。

Linux zip 安装 ​

zip 安装方式适合需要集成到 Linux 环境中的场景。安装前需要确认系统能力和 glibc 版本。

安装和更新要求 ​

  • 系统需要能解压 zip 文件；
  • Kiro CLI 需要 glibc 2.34 或更新版本；
  • 大多数 2021 年以后发布的主流 Linux 发行版默认满足要求；
  • 如果 glibc 低于 2.34，应选择文件名中带 -musl.zip 的版本；
  • 支持近期 Fedora、Ubuntu、Amazon Linux 2023 的 64-bit x86_64 和 ARM aarch64 环境。

检查 glibc 版本 ​

bash
ldd --version

如果版本是 2.34 或更高，使用标准版本；如果更低，使用 musl 版本。

选择安装包 ​

根据架构和 glibc 版本选择下载包：

  • Linux x86-64，glibc 2.34+：标准 x86-64 版本；
  • Linux ARM aarch64，glibc 2.34+：标准 ARM 版本；
  • Linux x86-64，glibc < 2.34：musl x86-64 版本；
  • Linux ARM aarch64，glibc < 2.34：musl ARM 版本。

安装命令 ​

bash
unzip kirocli.zip
./kirocli/install.sh

默认情况下，文件会安装到：

text
~/.local/bin

安装后如果 kiro-cli 命令找不到，确认 ~/.local/bin 是否已经加入 PATH。

Ubuntu deb 安装 ​

Ubuntu 可以使用 .deb 包安装。

流程：

  1. 下载 Ubuntu 对应的 Kiro CLI deb 包；
  2. 安装 deb；
  3. 修复可能缺失的依赖；
  4. 启动 Kiro CLI；
  5. 按提示完成 Authentication。

示例：

bash
sudo dpkg -i kiro-cli.deb
sudo apt-get install -f
kiro-cli

sudo apt-get install -f 用来修复 deb 安装时可能出现的依赖问题。

代理配置 ​

Kiro CLI v1.8.0 及之后版本支持企业环境常见代理，并会自动读取标准代理环境变量。

设置代理环境变量 ​

bash
# HTTP proxy for non-SSL traffic
export HTTP_PROXY=http://proxy.company.com:8080

# HTTPS proxy for SSL traffic
export HTTPS_PROXY=http://proxy.company.com:8080

# Bypass proxy for specific domains
export NO_PROXY=localhost,127.0.0.1,.company.com

带认证的代理 ​

bash
export HTTP_PROXY=http://username:password@proxy.company.com:8080
export HTTPS_PROXY=http://username:password@proxy.company.com:8080

如果密码中包含特殊字符，可能需要 URL encode。不要把带用户名密码的代理配置提交到仓库。

代理问题排查 ​

遇到代理相关连接问题时，按顺序检查：

  • 代理服务器是否可访问；
  • 用户名和密码是否正确；
  • 公司防火墙是否允许连接 AWS endpoints；
  • SSL certificate validation 是否被企业证书策略影响；
  • 代理是否支持 Kiro CLI 所需协议。

如果你在公司网络里使用，必要时联系 IT 管理员确认白名单和证书策略。

卸载 Kiro CLI ​

macOS 可运行：

bash
kiro-cli uninstall

Ubuntu 可运行：

bash
sudo apt-get remove kiro-cli
sudo apt-get purge kiro-cli

remove 会移除程序包，purge 会进一步清理残留配置文件。是否执行 purge 取决于你是否还想保留本地配置。

使用 doctor 排障 ​

当 Kiro CLI 行为异常时，先运行：

bash
kiro-cli doctor

正常情况下会看到类似输出：

text
$ kiro-cli doctor

Everything looks good!

Kiro CLI still not working? Run kiro-cli issue to let us know!

如果输出不是这样，按提示修复。仍无法解决时，可以使用：

bash
kiro-cli issue

向 Kiro 反馈问题。

日志文件位置 ​

Kiro CLI 会按平台写入日志：

平台路径
macOS$TMPDIR/kiro-log/kiro-chat.log
Linux$XDG_RUNTIME_DIR/kiro-log/kiro-chat.log
Windows%TEMP%\kiro-log\logs\kiro-chat.log

也可以用 KIRO_CHAT_LOG_FILE 覆盖日志路径：

bash
KIRO_CHAT_LOG_FILE=/tmp/my-debug.log kiro-cli chat

Windows PowerShell 示例：

powershell
$env:KIRO_CHAT_LOG_FILE = "C:\temp\my-debug.log"
kiro-cli chat

在提交 bug 或向团队求助时，日志能帮助定位认证、网络、shell integration 和工具调用问题。

常见问题处理 ​

Authentication failures ​

如果认证失败，尝试重新登录：

bash
kiro-cli login

同时检查浏览器是否能打开认证页面、代理是否正确、系统时间是否异常。

Autocomplete not working ​

自动补全不工作时，先运行：

bash
kiro-cli doctor

它会检查 shell integration 是否正确安装，并给出修复建议。

SSH integration issues ​

如果 SSH 场景下集成异常，检查 SSH server 是否允许传递 Kiro 需要的环境变量。企业服务器上经常会限制环境变量，需要管理员配合调整。

环境不受支持 ​

确认当前环境是否属于支持范围，可参考 Supported command line environments。如果系统版本过旧，优先考虑升级系统、使用 musl 版本，或改用容器环境。

推荐排障顺序 ​

  1. 运行 kiro-cli doctor。
  2. 检查网络和代理设置。
  3. 确认认证状态，必要时运行 kiro-cli login。
  4. 确认系统、架构、glibc 版本是否受支持。
  5. 查看对应平台日志。
  6. 尝试重新安装 Kiro CLI。
  7. 仍无法解决时运行 kiro-cli issue 报告问题。

常见问题 ​

Kiro CLI 会自动更新吗？ ​

会。Kiro CLI 会在后台下载新版本，并在退出应用时安装。你可以通过 kiro-cli settings "app.disableAutoupdates" "true" 关闭自动更新。

Linux 应该选标准 zip 还是 musl zip？ ​

先运行 ldd --version。glibc 2.34 或更高使用标准版本；低于 2.34 使用文件名带 -musl.zip 的版本。

代理配置不生效怎么办？ ​

先确认 HTTP_PROXY、HTTPS_PROXY、NO_PROXY 是否在当前 shell 中生效，再检查用户名密码、防火墙、AWS endpoints 访问和 SSL 证书策略。

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 地豆 蜀ICP备2021007188号 | 关于本站 | 隐私政策