认证

浏览器登录（推荐）

tufty login

CLI 打印一个授权链接并尝试打开浏览器，随后每 2 秒检查一次授权是否完成。链接 30 分钟内有效，在任意设备的浏览器里打开都可以，所以 SSH、容器等远程终端也能用。授权完成后，API 密钥自动写入配置文件。

手动保存 API 密钥

1. 登录 tufty.ai，打开 账户设置 → API 密钥。
2. 创建或复制一个密钥（以 sk- 开头）。
3. 保存到本机：

tufty auth set sk-xxxx

查看与清除

tufty auth get          # 当前生效的密钥和来源，默认遮蔽：sk-***1234
tufty auth get --show   # 完整显示密钥
tufty logout            # 从配置文件中删除密钥

tufty auth get 返回的 result.data.source 是 env（来自 TUFTY_API_KEY）或 config（来自配置文件）。如果设置了 TUFTY_API_KEY，tufty logout 之后它仍然生效，需要一并清除。

密钥查找顺序

需要鉴权的命令按以下顺序查找密钥，找到即停：

1. --api-key <key> 参数
2. 环境变量 TUFTY_API_KEY
3. 配置文件 ~/.tufty/config.json（由 tufty login / tufty auth set 写入；目录可用 TUFTY_CONFIG_DIR 修改）
4. 交互式登录：只在交互终端中触发。CI（设置了 CI 环境变量）、智能体和管道中不会触发，而是直接返回 no_api_key

配置文件以仅当前系统用户可读的权限写入。Windows 上的路径是 %USERPROFILE%\.tufty\config.json。

不需要登录的操作

• tufty tools list、tufty tools describe <id>、tufty <tool> -h
• 工具命令加 --dry-run
• tufty upload 一个已经在 static.tufty.ai 上的地址

积分与充值

生成会消耗账户积分，积分不足时命令返回 insufficient_balance。到 账户设置 → 积分 查看余额，或在 价格页 选择套餐。积分怎么算见 积分。