安装与认证

安装与升级

node --version
npm install -g @kittaai/cli
kitta --version
npm install -g @kittaai/cli@latest

需要 Node.js 22+。全局安装后找不到 kitta 时，检查 npm 全局可执行目录是否在 PATH 中，并重新打开终端。

交互认证

kitta auth login
kitta auth status --json
kitta auth logout

登录会验证 API Key，并尝试保存到系统钥匙串，不会写入明文凭据文件。无可用钥匙串时使用环境变量。

无交互环境

从运行环境的密钥管理功能注入 KITTA_API_KEY。以下仅演示语法，YOUR_API_KEY 是占位符；不要将真实密钥写入共享脚本或 Shell 历史。

Bash

export KITTA_API_KEY="YOUR_API_KEY"
kitta auth status --json
unset KITTA_API_KEY

PowerShell

$env:KITTA_API_KEY = "YOUR_API_KEY"
kitta auth status --json
Remove-Item Env:KITTA_API_KEY

环境变量优先于钥匙串。logout 不会删除父 Shell 中的环境变量。CLI 不会自动加载 .env。

服务地址与隔离

默认地址为 https://kittaai.com。KITTA_API_URL 或 --api-url 可选择其他部署；这不是账号或额度迁移。凭据和提交记录按 origin 隔离。不要将密钥发送给不信任的地址。

下一步： 快速开始.