mirror of
https://github.com/stablyai/orca.git
synced 2026-11-16 19:07:41 +00:00
The usage-tracking docs claimed Orca only reads local agent state with no API calls. Orca actually fetches usage from each provider (Claude via api.anthropic.com/api/oauth/usage with the existing Claude Code login). Describe the network fetch, list the Claude fetch triggers, and fix the matching sentences on the Claude Code and Codex pages. Fixes #27150 Co-authored-by: Neil <neil@stably.ai>
32 lines
1.7 KiB
Plaintext
32 lines
1.7 KiB
Plaintext
---
|
|
title: 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).
|
|
1. Log in once from any terminal.
|
|
1. 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](/docs/agents/usage-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](/docs/agents/codex-hot-swap) — 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](/docs/model/agents-sessions#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](/docs/agents/hooks-memory).
|