mirror of
https://github.com/stablyai/orca.git
synced 2026-10-01 16:02:03 +00:00
Neil
6aba202d5e
Publish the standalone docs site under docs/site and deploy it on stable desktop releases.
32 lines
1.6 KiB
Plaintext
32 lines
1.6 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 reads your local `~/.claude` usage state 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).
|