Lancer Ori avec Claude Code

Ce guide montre comment démarrer Ori connecté à Claude Code. Il suppose que vous avez déjà compilé et lancé Ori une fois (voir le tutoriel de premiers pas) et que vous disposez d'un compte Claude ou d'une clé API opérationnels.

Étapes

Vérifiez que Node.js et npm sont disponibles : le backend lance l'adaptateur ACP du Claude Agent SDK avec npx -y @agentclientprotocol/claude-agent-acp. L'adaptateur embarque sa propre CLI Claude Code (un paquet natif choisi pour votre plateforme) : il fonctionne même si la commande claude de votre machine est plus ancienne.
Vérifiez que Claude Code est authentifié sur cette machine (procédure de connexion de claude, ou une variable d'environnement ANTHROPIC_API_KEY utilisable par l'adaptateur).
Depuis la racine du dépôt, démarrez le serveur :
```
make run
```
Ouvrez http://localhost:8888 et commencez à dialoguer. Tool calls, plans et demandes de permission apparaissent exactement comme avec l'agent de démonstration.

Variantes

Pour travailler sur un répertoire de projet précis, passez explicitement le répertoire de travail de l'agent : ./bin/ori --cwd /chemin/vers/votre/projet.
Pour servir sur un autre port : ./bin/ori --addr :9000.
Le premier npx télécharge le paquet de l'adaptateur ; figez-le en l'installant globalement (npm install -g @agentclientprotocol/claude-agent-acp) et en passant --agent-cmd "claude-agent-acp".

Voir aussi

Référence des options : la commande ori
Brancher autre chose que Claude : utiliser un autre agent ACP

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


# Lancer Ori avec Claude Code

Ce guide montre comment démarrer Ori connecté à Claude Code. Il suppose que vous avez déjà compilé et lancé Ori une fois (voir le [tutoriel de premiers pas](../tutorials/getting-started.md)) et que vous disposez d'un compte Claude ou d'une clé API opérationnels.

## Étapes

1. Vérifiez que Node.js et npm sont disponibles : le backend lance l'adaptateur ACP du Claude Agent SDK avec `npx -y @agentclientprotocol/claude-agent-acp`. L'adaptateur embarque sa propre CLI Claude Code (un paquet natif choisi pour votre plateforme) : il fonctionne même si la commande `claude` de votre machine est plus ancienne.
2. Vérifiez que Claude Code est authentifié sur cette machine (procédure de connexion de `claude`, ou une variable d'environnement `ANTHROPIC_API_KEY` utilisable par l'adaptateur).
3. Depuis la racine du dépôt, démarrez le serveur :

   ```bash
   make run
   ```

4. Ouvrez [http://localhost:8888](http://localhost:8888) et commencez à dialoguer. Tool calls, plans et demandes de permission apparaissent exactement comme avec l'agent de démonstration.

## Variantes

- Pour travailler sur un répertoire de projet précis, passez explicitement le répertoire de travail de l'agent : `./bin/ori --cwd /chemin/vers/votre/projet`.
- Pour servir sur un autre port : `./bin/ori --addr :9000`.
- Le premier `npx` télécharge le paquet de l'adaptateur ; figez-le en l'installant globalement (`npm install -g @agentclientprotocol/claude-agent-acp`) et en passant `--agent-cmd "claude-agent-acp"`.

## Voir aussi

- Référence des options : [la commande ori](../reference/cli.md)
- Brancher autre chose que Claude : [utiliser un autre agent ACP](use-another-agent.md)