forked from bots-garden/ori
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 1 | # How to run Ori with Claude Code |
| 2 | ||
| 3 | This guide shows how to start Ori connected to Claude Code. It assumes you have already built and run Ori once (see the [getting started tutorial](../tutorials/getting-started.md)) and that you have a working Claude account or API key. | |
| 4 | ||
| 5 | ## Steps | |
| 6 | ||
| ✨ Switch the ACP adapter to @agentclientprotocol/claude-agent-acp (template 0.0.2) | 7 | 1. Make sure Node.js and npm are available: the backend spawns the Claude Agent SDK's ACP adapter with `npx -y @agentclientprotocol/claude-agent-acp`. The adapter ships its own Claude Code CLI (a native package chosen for your platform), so it works even if the `claude` command on your machine is older. |
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 8 | 2. Make sure Claude Code is authenticated on this machine (`claude` login flow, or an `ANTHROPIC_API_KEY` environment variable the adapter can use). |
| 9 | 3. From the repository root, start the server: | |
| 10 | ||
| 11 | ```bash | |
| 12 | make run | |
| 13 | ``` | |
| 14 | ||
| 15 | 4. Open [http://localhost:8888](http://localhost:8888) and start prompting. Tool calls, plans and permission requests appear exactly as with the demo agent. | |
| 16 | ||
| 17 | ## Variants | |
| 18 | ||
| 19 | - To work on a specific project directory, pass the agent's working directory explicitly: `./bin/ori --cwd /path/to/your/project`. | |
| 20 | - To serve on another port: `./bin/ori --addr :9000`. | |
| ✨ Switch the ACP adapter to @agentclientprotocol/claude-agent-acp (template 0.0.2) | 21 | - The first `npx` run downloads the adapter package; pin it by installing it globally (`npm install -g @agentclientprotocol/claude-agent-acp`) and passing `--agent-cmd "claude-agent-acp"`. |
| ✨ Workspace panel, selectors, previews, desktop app, sandbox template, resizable file tree, light/dark theme | 22 | |
| 23 | ## See also | |
| 24 | ||
| 25 | - Flags reference: [the ori command](../reference/cli.md) | |
| 26 | - Connecting something else than Claude: [use another ACP agent](use-another-agent.md) |