Kiro 装不上、登不进、额度对不上？三类常见问题的排查顺序
排查工具类问题，最怕的是一上来就去搜错误码。搜到的帖子往往是别人两年前的环境，跟着做一遍，问题没解决，反倒把配置改乱了。
这篇不走那条路。Kiro 官方文档目前公开的信息，集中在安装要求、登录方式、更新机制和代理支持这几块；至于具体会弹什么提示、返回什么代号，官方没有成体系地列出来，我也没有可核实的清单，所以下面不会出现任何「如果提示 XXX 就怎样」的句式——那种写法看着专业，实际是编的。
我们改成按症状分层：装不上、登不进、升级后出问题、额度对不上。每一类给出可以照着做的排查顺序，顺序本身就是价值——先做哪一步能最快把问题范围砍一半，比记住十个零散技巧有用得多。
开工前的捷径：先用 Web 版做一次隔离测试
Kiro 有五种形态，其中 Web 版任何现代浏览器都能开，无需本地安装。这一条在排查里的价值被严重低估了。
任何一个「Kiro 不工作」的问题，本质上只有三种可能：本地环境不对、账号/权限不对、网络不对。而 Web 版恰好把「本地环境」这一项完全绕开了。
所以第一步永远是：打开 Web 版，用你平时那个账号登录，随便跑一个小请求。
- Web 版能登录、能干活 → 账号没问题、网络大体通，问题基本锁死在本地那台机器上（系统版本、安装包、本地代理、本地权限）。
- Web 版也登不进去 → 跟你的 IDE 装没装、装在哪没关系，去查账号和网络。
- Web 版登进去了但请求跑不动 → 往额度和账号策略方向查。
这一步花不到三分钟，能把后面的排查工作量砍掉一大半。很多人卡住的原因是反复重装 IDE，而问题根本不在 IDE 上。
症状一：装不上，或者装完打不开
绝大多数「装不上」不是安装包坏了，是系统压根不在支持列表里。Kiro 五种形态的系统要求并不一致，这是最容易踩的坑——你在同一台电脑上，IDE 装得好好的，CLI 就是跑不起来，这不奇怪，两者要求不一样。
先对着这张表核一遍：
| 形态 | 系统要求 | 最容易卡住的点 |
|---|---|---|
| IDE | macOS（Intel / Apple Silicon）、Windows 10/11 64 位、Linux（Ubuntu 24+、Debian 13+ 等） | 32 位 Windows 不支持；老 Linux 发行版版本不够 |
| CLI | macOS、Windows 11（PowerShell）、Linux（glibc 2.34+） | Windows 10 不在列；老 Linux 的 glibc 版本不够 |
| Web | 任何现代浏览器，无需本地安装 | 基本不会卡（所以适合拿来做隔离测试） |
| Mobile | iOS，经 Apple TestFlight | 需要走 TestFlight，不是常规商店安装 |
| Crew | macOS / Linux / Windows，需 Python 3.9+ | 系统自带 Python 版本太老 |
这张表里有两个门槛值得单独说：
一是 CLI 在 Linux 上的 glibc 2.34+。 这是全篇最容易被忽略、也最容易被误诊的一条。glibc 是 Linux 的底层 C 运行库，版本由发行版决定，不是你 apt install 一下就能升的东西——强行换 glibc 有把整个系统搞挂的风险。企业里大量服务器和开发机跑的是几年前的长期支持版本，glibc 停在 2.34 以下很常见。这种情况下 CLI 装不起来是结构性的，不是配置问题：换新一点的发行版、上容器、或者改用 Web 版，比在原系统上折腾划算得多。
顺带提醒：IDE 那一栏写的是 Ubuntu 24+、Debian 13+，这两个数字本身就说明 Kiro 对 Linux 老版本的兼容意愿不高。如果你的机器还停在更早的版本，先别怀疑自己手法有问题。
二是 Crew 的 Python 3.9+。 这里的坑在于「系统里有 Python」不等于「Kiro 用的是那个 Python」。很多机器同时存在系统自带的老版本、包管理器装的新版本、虚拟环境里的另一个版本。装 Crew 之前先确认实际会被调用的那个解释器版本，而不是你以为的那个。
如果系统要求全部满足、装也装上了、就是打不开，接下来的顺序是：完整卸载后重装（而不是覆盖安装）→ 换一个用户账户试（排除用户配置目录的问题）→ 用 Web 版确认账号侧正常。到这一步还不行，就该带着「哪一步做了什么、结果如何」去找官方支持，而不是继续自己猜。
症状二：登录失败——先看这条「浏览器登录会绕过代理」
这一节是整篇里最有信息量的部分，因为它解释了一个非常反直觉的现象：公司网络下能正常上网、能打开网页，但 Kiro 就是登不进去。
Kiro 支持通过 HTTP_PROXY 一类的环境变量走代理。但官方文档明确指出一件事：浏览器登录会绕过代理设置。
把这句话展开就很好理解了。登录流程会把你甩到浏览器里完成身份验证，而浏览器这一段走的是浏览器自己的网络路径，不吃你给 Kiro 配的那套环境变量。于是就出现了一半通、一半不通的分裂状态——工具本体的请求走代理走得好好的，登录那一跳却直接撞墙。这类问题最折磨人，因为所有「表面证据」都指向网络正常。
按这个顺序查：
第一步，确认基础网络可达。 别急着改配置，先确认这台机器在当前网络下能正常访问外部服务。如果连这一层都不通，后面都是白搭。
第二步，确认代理的覆盖范围。 这是核心。分别问自己两个问题：我给 Kiro 配的代理环境变量，浏览器吃不吃？我的浏览器当前用的是系统代理、扩展代理，还是根本没走代理？两者不一致，就是这个症状的成因。处理方向是让登录那一跳也走上同一条通路——要么让浏览器也按同样的规则走代理，要么反过来在需要的环节上放行。具体怎么配取决于你们公司的网络管理方式，这个我给不了统一答案，得问你们的 IT。
第三步，换一种登录方式交叉验证。 Kiro 提供四种登录：Google、GitHub、AWS Builder ID、组织身份认证。这四种互为对照组，是很好的诊断工具——它们背后的身份提供方不同，触达的服务端点也不同。如果 Google 登录卡住而 GitHub 能进，说明问题不在 Kiro 本身，而在那条特定链路上（可能是该身份提供方被网络策略拦了）。如果四种全卡在同一个环节，那更像是本机网络或代理的问题，而不是某个账号的问题。
这个交叉验证的思路，比反复重试同一种方式有用得多。换个方式试一次，能得到的信息量，比同一个方式重试十次都大。
第四步，组织身份认证要单独对待。 如果你用的是公司统一的身份认证入口，那么「登不进去」很可能压根不是技术问题，而是权限问题：席位没分配、账号不在允许名单里、或者管理员设置的策略挡住了。这一类你自己排查不出来，也不该自己排查——直接找管理员确认两件事：我的席位分配好了没，有没有策略限制。省下的时间比什么都值钱。
症状三：升级之后，原来好好的功能出问题了
Kiro 支持自动更新，同时支持降级到早期版本。第二条是很多人不知道的止损手段。
自动更新是把双刃剑：它省事，但也意味着你可能在毫无准备的情况下换了个版本。典型场景是——昨天下班前还好好的，今天早上打开就有个地方不对劲，而你什么都没改。这种时候第一反应不该是”我是不是哪里配错了”，而是先想一下：是不是版本变了。
处理顺序建议这样：
- 先降级，恢复生产力。 你的首要任务是今天能干活，不是当场把 bug 定位清楚。降回上一个能用的版本，工作先接上。
- 降级后确认症状是否消失。 消失了，基本可以确认是版本引入的变化；没消失，说明你找错方向了，回头去查配置、网络或者账号。
- 再决定要不要往回追。 确认是新版本的问题之后，你可以从容地反馈给官方，或者等下一个版本再升。
- 在此期间留意自动更新。 既然是自动更新把你带到新版本的，那么降级之后如果不管，很可能过几天又被带回去。降级只是缓冲，不是终局。
顺便说一句判断标准：如果你降了一个版本症状还在，别接着一路往回降。连降两三个版本还没变化，说明问题多半不在版本上，继续降只是浪费时间还引入新的不确定性。
症状四：额度对不上——先承认哪些事是查不到的
这一节我得先说清楚一件事，免得你在错误的方向上耗时间。
**Kiro 官方目前没有公开单次操作扣多少 credit，也没有公开 credits 的刷新周期。**这不是我没查，是它的 billing 文档页返回 404。也就是说，你「感觉扣多了」这件事，目前没有官方规格可以拿来对照核算。任何声称”某某操作固定扣几个 credit”的说法，来源都值得怀疑。
能确认的只有价格结构：
| 档位 | 月价 | 含 credits | 折算单价 | 超额单价 |
|---|---|---|---|---|
| KIRO FREE | $0 | 50 | — | 页面未写明 |
| KIRO PRO | $20 | 1,000 | $0.02 | $0.04/credit |
| KIRO PRO+ | $40 | 2,000 | $0.02 | $0.04/credit |
| KIRO PRO MAX | $100 | 5,000 | $0.02 | $0.04/credit |
| KIRO POWER | $200 | 10,000 | $0.02 | $0.04/credit |
折算单价那一列是我算的，四个付费档全部是 $20÷1000 = $0.02、$40÷2000 = $0.02、$100÷5000 = $0.02、$200÷10000 = $0.02，完全一致。而超额是 $0.04/credit，正好是套餐内单价的 2 倍。
这个 2 倍关系直接给出一条实用结论：如果你每个月稳定超额，升档几乎总是比继续付超额便宜。 举个可以自己复核的例子——你在 PRO（$20 含 1000）的基础上又超额用了 1000 credits，超额部分要付 1000 × $0.04 = $40，当月总支出 $60；而直接上 PRO+ 是 $40 拿到 2000 credits，同样的用量，省 $20。差价就是从那个 2 倍来的。反过来说，如果只是偶尔某个月冲一下，按超额付反而更灵活，不用为了一次高峰把月费长期抬上去。
至于「额度到底怎么被吃掉的」，在官方补文档之前，只能自测。方法很笨但有效：
- 记基线。 在开始干活前把当前余额记下来，写清日期和时间。
- 做一段可描述的工作。 比如「今天下午三小时，用同一个项目、同一类任务」，别中途混入其他实验。
- 再记一次余额，相减。 得到的是「这类工作在这段时间的实际消耗」。
- 重复几天，看波动。 单次采样没有意义，连续几天才能看出你自己的消耗节奏。
这么做得到的不是官方规格，是你自己的经验值——但恰恰是这个经验值能直接指导你选档：知道自己一天大概烧多少，才知道该买哪一档。比死等官方文档实在。
另外记住一点：超额是按 $0.04/credit 单独计费的，会在账单上单列，不会悄悄混进月费里。所以对账的时候，把月费和超额分开看，你能立刻知道自己是”套餐内用完了”还是”套餐外又买了”。这两种状态的应对完全不同——前者等下个周期，后者该考虑升档了。
顺带一提，如果你有学生身份，在讨论买哪一档之前先看看 Kiro 的学生免费方案，条件符合的话能省下不少。另外，「额度用完之后工具怎么表现」这件事各家做法差别很大，Kiro 是走超额付费，而 Cursor 走的是快慢两档降级——代价一个落在钱上、一个落在时间上。搞清楚你手里这个工具是哪种模式，遇到额度问题时的心态和对策会完全不同。
最后
把这四类症状的排查顺序压缩成一句话：
- 装不上 → 先查系统要求表，尤其 Linux 的 glibc 2.34+ 和 Crew 的 Python 3.9+，这两个是硬门槛，不是手法问题。
- 登不进 → 优先怀疑「浏览器登录绕过代理」，然后用四种登录方式互相交叉验证；组织认证的直接找管理员。
- 升级后异常 → 先降级恢复生产力，再慢慢排查，别在上班时间跟新版本较劲。
- 额度对不上 → 官方没公开扣费规则和刷新周期，别去核对不存在的规格；改用记余额相减的自测法，同时记住超额单价是套餐内的 2 倍。
还有那条贯穿始终的捷径：任何时候卡住，先用免安装的 Web 版跑一遍，用它把「环境问题」和「账号问题」切开。这一步的性价比高于本文其他所有建议。
最后说点实在的：本文能给的是排查顺序和已确认的事实，给不了的是具体提示文案的对照表——因为那部分官方没有公开，我不打算凭印象编一个出来误导你。碰到确实无法定位的情况，把你做过的步骤和各步的结果整理清楚再去找支持，比丢一句”用不了”要快得多。