Claude Code in Orca

Claude Code is Anthropic's agentic CLI. Orca runs it as a first-class terminal agent, with account-aware session start, usage tracking, and account hot-swapping.

Setup

  1. Install Claude Code (npm i -g @anthropic-ai/claude-code or follow Anthropic's docs).
  2. Log in once from any terminal.
  3. Orca picks up ~/.claude automatically — no extra config needed.

Launching

In any worktree, open a terminal and pick Claude Code from the agent combobox. Orca launches it with the worktree as the working directory and a status-line hook that emits OSC title events Orca uses for state dots.

Usage & rate limits

Orca fetches your Claude usage from Anthropic with your existing Claude Code login and shows current usage plus rate-limit proximity in the status bar. See Usage & rate-limit tracking.

Account hot-swap

Orca supports multiple Claude accounts and can swap between them in one click, matching the Codex flow. Switching accounts works even with live Claude sessions running — Orca holds the in-progress switch behind a guard so you don't trigger overlapping auth refreshes. See Hot-swap Codex accounts — the Claude flow is identical in shape.

Subagents and teams

Background subagents and Agent Teams teammates can show as expandable child rows under the lead agent in the worktree agent list and Agent Dashboard. Selecting a child focuses the lead terminal.

Hooks & memory

Claude Code supports per-repo hooks and memory files. Orca surfaces these under Agent hooks & memory.