Kiro CLI 使用 KIRO_API_KEY 认证失败：endpoint 区域错误

问题

按照官方 headless 认证文档设置 KIRO_API_KEY 环境变量后，运行 kiro-cli chat --no-interactive "..." 报认证失败或连接超时。

export KIRO_API_KEY=your-api-key
kiro-cli chat --no-interactive "Test"
# → 认证失败 / connection error

根本原因

Kiro CLI 默认连接 us-east-1 区域的 endpoint。如果你的账号绑定的区域不是 us-east-1（例如欧洲用户通常是 eu-central-1），认证请求会因为区域不匹配而失败。

诊断方式（使用 -vvv 查看实际请求地址）：

kiro-cli chat --no-interactive "Test" -vvv | grep "endpoint"

观察输出中的 endpoint URL，确认是否指向了错误的区域。

解决方案

通过 KIRO_ENDPOINT_URL 环境变量覆盖默认 endpoint，指定正确的区域：

# 欧洲账号（eu-central-1）
export KIRO_ENDPOINT_URL="https://q.eu-central-1.amazonaws.com"
export KIRO_API_KEY=your-api-key
kiro-cli chat --no-interactive "Test"

常见区域 endpoint：

区域	endpoint
us-east-1（默认）	https://q.us-east-1.amazonaws.com
eu-central-1	https://q.eu-central-1.amazonaws.com
ap-northeast-1	https://q.ap-northeast-1.amazonaws.com

你也可以先不设 KIRO_API_KEY，通过 kiro-cli chat -vvv 登录一次，从日志中找到你账号实际使用的 endpoint URL。

社区补充：dispatch failure 报错

如果遇到类似错误：

dispatch failure: error sending request for url (https://q.us-east-1.amazonaws.com/)

在排除区域配置问题后，此错误通常是 AWS 服务端瞬时故障（短暂不可用），非客户端问题。

处理方式：

1. 等待 5~10 分钟后重试
2. 检查 kiro.dev 首页是否有服务状态公告
3. 如果持续超过 1 小时，开 GitHub Issue 附上 -vvv 日志

来源：GitHub Issue #7896、GitHub Issue #7156