Claude Code
Kettu 怎么经 Claude Agent SDK 运行你自己的 Claude Code、怎么登录，以及显示它的模型、套餐限额和提示缓存。
Kettu 经 Claude Agent SDK（@anthropic-ai/claude-agent-sdk）驱动 Claude Code。第一次用 Claude Code 时，Kettu 用你的 npm 把 SDK 装进自己的数据目录，不装 SDK 自带的那份 Claude Code。之后 SDK 运行的是你自己的 claude，所以只有这次安装需要 Node.js。
你的 claude 指 PATH 上的那个；环境里设了 CLAUDE_CODE_EXECUTABLE 时，用它指定的程序。它用自己的目录，和你在终端里运行的 claude 共用，所以登录、设置、CLAUDE.md、MCP 服务器和权限规则都和原来一样。
安装 Claude Code
找不到 claude 时，打开设置 › Harness › Claude Code，点安装…，选一种 Anthropic 文档里的装法：官方安装脚本（推荐）、Homebrew、WinGet（Windows），或者 npm。Kettu 先显示命令，再替你运行。
登录
打开设置 › Agent › Claude Code，点在终端中登录。Kettu 在自己的终端里运行 Claude Code 自己的登录命令：
| 方式 | 命令 |
|---|---|
| Claude Subscription | claude auth login --claudeai |
| Anthropic Console，按 API 用量计费 | claude auth login --console |
想改用 key，在 API key 那一行点设置…，填服务地址（Anthropic 官方留空，第三方网关填它给的地址）、API key，模型可以不填。key 交给 Claude Code，存进这个 Agent 配置目录里的 settings.json，Kettu 不留副本。想再加一个账号，比如订阅之外再用公司的 key，在设置 › Agent 里点添加 Agent，它会有自己的配置目录。
会话里
输入框里能调的，是 Claude Code 为这个会话报上来的选项：
- Mode：Manual、Accept edits、Plan、Auto；Claude Code 允许时还有 Bypass permissions。
- Model，旧版本收在更多模型里。
- Effort，即这个模型支持的推理强度；支持的模型还有 Fast mode。
Claude Code 的斜杠命令也在输入框里。选始终允许时，规则存到你选的地方：用户设置、.claude/settings.json、.claude/settings.local.json，或者仅本会话。
套餐限额
Claude Code 会报出你套餐的限额，比如 5 小时和每周的。Agent 菜单里 Claude Code 旁边显示最紧的那一项；设置 › Agent › Claude Code 的套餐用量里列出每一项和重置时间；用完时输入框会提示。
提示缓存
Kettu 从 Claude Code 自己的会话记录里读出，上一次请求留下的是 5 分钟还是 1 小时的缓存。两轮之间，会话顶栏显示缓存和剩余时间；点开能看到缓存过期后，下一条消息要按全价重新读取多少 token。在侧边栏，缓存最后一分钟（1 小时缓存是最后五分钟）里，这个会话的标记换成一个圆环。
Claude Code 版本太旧时
每个版本的 SDK 只能运行它对应的 Claude Code 版本或更新的版本。你的 claude 太旧时，Claude Code 会从 Agent 菜单里消失，设置 › Harness › Claude Code 会提示它比 Kettu 要的旧。
在那里点更新到加版本号。Kettu 按你装它的方式更新，比如官方脚本装的运行 claude update，Homebrew 装的运行 brew upgrade --cask claude-code；命令也会显示出来，你可以自己运行。SDK 会一并换成对应的版本。SDK 的更新只在同一个 0.x 小版本之内；要更新的 Claude Code 才能用的 SDK 更新，会等你更新了 Claude Code 再装。