文档 / Agents / Orca 中的 Claude Code

Claude Code 是 Anthropic 的代理式 CLI。Orca 将其作为一等终端代理运行，支持感知账户的会话启动、用量跟踪和账户热切换。

安装设置¶

1. 安装 Claude Code（npm i -g @anthropic-ai/claude-code 或遵循 Anthropic 的文档）。
2. 从任意终端登录一次。
3. Orca 会自动读取 ~/.claude — 无需额外配置。

启动¶

在任意工作树中，打开终端并从代理下拉框中选择 Claude Code。Orca 会以工作树作为工作目录启动它，并附带一个状态行钩子，该钩子会发出 Orca 用于状态圆点的 OSC 标题事件。

用量与速率限制¶

Orca 会读取本地 ~/.claude 的用量状态，并在状态栏中显示当前用量以及速率限制临近程度。参见 用量与速率限制跟踪。

账户热切换¶

Orca 支持多个 Claude 账户，并可一键在它们之间切换，与 Codex 流程一致。即使有正在运行的 Claude 会话，账户切换也能正常工作 — Orca 会通过守卫机制保留进行中的切换，避免触发重叠的认证刷新。参见 热切换 Codex 账户 — Claude 流程在形式上完全相同。

子代理与团队¶

后台子代理和 Agent Teams 队友可以显示为工作树代理列表和 Agent Dashboard 中主代理下的可展开子行。选择子项会聚焦主终端。

钩子与记忆¶

Claude Code 支持按仓库的钩子和记忆文件。Orca 会在 代理钩子与记忆 下展示这些内容。