> ## Documentation Index
> Fetch the complete documentation index at: https://getpullrequest.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Use Claude Code as an ACP coding agent with GPR.

Catalog id: `claude`\
Display name: Claude Agent\
Requires: `claude` on `PATH`\
ACP bridge binary: `claude-code-acp` next to the `gpr` binary (usually `~/.local/bin/claude-code-acp`)

## Setup

1. Install the Claude Code CLI so `claude` resolves in your shell.
2. Authenticate. GPR’s catalog note: uses `ANTHROPIC_API_KEY` (API billing).
3. Install the ACP adapter binary as `claude-code-acp` in the same directory as `gpr`.
4. Verify:

```bash theme={null}
gpr discover
```

Claude should show status `ready`.

5. Select **Claude** on the workspace in the app.

## Launch shape

The daemon runs the adapter (`claude-code-acp`), which speaks ACP on stdio and drives the Claude CLI.

## Common failures

| Symptom                       | Check                                                                                                                                                   |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `not installed`               | `which claude`                                                                                                                                          |
| `needs adapter`               | `ls "$(dirname "$(which gpr)")/claude-code-acp"`                                                                                                        |
| Auth errors in session        | API key / Claude login on that machine                                                                                                                  |
| Works in terminal, not in GPR | Daemon PATH and env. The service does not load `.zshrc`. Use [agents.json](/docs/reference/agents-json) for API keys or custom base URLs, then `gpr restart` |

```bash theme={null}
gpr restart
gpr logs -f
```