# Utiliser Remote Control avec ccam

> Lancez le Remote Control de Claude Code avec un compte via ccam <name> rc : options valables, pourquoi ccam propose de copier les serveurs MCP, dépannage.

Source: https://ccam.dev/fr/guides/remote-control/ · Updated 2026-10-20

`ccam work rc` démarre le Remote Control de Claude Code avec le compte `work`, pour que vous puissiez piloter des sessions sur cet ordinateur depuis claude.ai/code ou l'application mobile Claude. Il fonctionne comme `claude rc`, à une différence près : si le compte partage des serveurs MCP, ccam demande une fois s'il faut les copier dans le `.claude.json` du compte, car les sessions Remote Control ne lisent les serveurs nulle part ailleurs.

## Démarrer

```sh
ccam work rc                          # Remote Control as the account work
ccam 2 rc                             # the account with number 2 (see ccam list)
ccam work remote-control              # the long name of the same command
ccam work rc --name laptop            # options after rc go to Remote Control
ccam work rc --spawn worktree         # each new session in its own git worktree
ccam --dry-run work rc                # print the command instead of running it
```

Un [raccourci](https://ccam.dev/fr/features/shortcuts.md) fonctionne de la même façon : `ccwork rc` équivaut à `ccam work rc`. Lancez la commande dans le dossier où vous voulez travailler, puis ouvrez claude.ai/code ou l'application Claude, connecté avec le même compte Claude que `work`.

## Options

Deux sortes d'options se rencontrent ici : celles de ccam, qui se placent avant le nom du compte ou se trouvent dans les paramètres de ccam, et celles de Remote Control, qui se placent après `rc` et parviennent telles quelles à Claude Code.

### Options et paramètres de ccam

| Option ou paramètre | Effet | Par défaut |
| --- | --- | --- |
| `--dry-run` (avant le compte) | Affiche l'environnement et la commande, ainsi que l'avis MCP s'il y en a un. Ne pose aucune question et ne copie rien | désactivé |
| `Copy them into .claude.json (a backup is kept)? [y/N]` | Posée quand le compte partage des serveurs MCP et que son `.claude.json` ne contient pas la liste actuelle du groupe. `y` les copie, `N` ou Entrée démarre sans eux | `N` |
| `mcp_strategy = "sync"` dans `~/.config/ccam/config.toml` | Copie les serveurs du groupe dans `.claude.json` avant chaque lancement, Remote Control ou non, si bien qu'aucune question n'est jamais posée | `"flag"` |
| `ccam share work --mcp off` | Cesse de partager les serveurs MCP avec le compte ; Remote Control démarre alors avec les seuls serveurs propres du compte, sans question | activé |

### Options de Remote Control

Tout ce qui suit `rc` appartient à Claude Code. Voici les options de `claude remote-control` dans Claude Code 2.1.304 ; `ccam work rc --help` affiche la liste pour votre version.

| Option | Effet |
| --- | --- |
| `--name <name>` | Nom de la session affiché dans claude.ai/code |
| `--remote-control-session-name-prefix <prefix>` | Préfixe des noms de session générés (par défaut : le nom de la machine) |
| `-c`, `--continue` | Se rattache à la dernière session que Remote Control a enregistrée pour ce dossier, dans un délai d'environ 4 heures |
| `--session-id <id>` | Se rattache à une session précise |
| `--permission-mode <mode>` | Mode d'autorisation des nouvelles sessions : `acceptEdits`, `auto`, `bypassPermissions`, `default`, `dontAsk` ou `plan` |
| `--spawn <mode>` | `same-dir` (par défaut), `worktree` (un git worktree par session) ou `session` (une seule session, quitte à sa fin) |
| `--capacity <N>` | Nombre maximal de sessions simultanées en mode `same-dir` et `worktree` (32 par défaut) |
| `--[no-]create-session-in-dir` | Crée une première session dans le dossier courant au démarrage (activé par défaut) |
| `--[no-]chrome` | Claude in Chrome pour les nouvelles sessions (désactivé par défaut) |
| `-d`, `--debug`, `--debug-file <path>`, `-v`, `--verbose` | Sortie de débogage et détaillée |

Placez `rc` juste après le nom du compte. ccam prend le premier argument qui ne commence pas par `-` comme commande de Claude Code : dans `ccam work rc --name laptop`, il voit `rc`, mais dans `ccam work --model opus rc`, il voit `opus`.

## Ce que fait ccam

Le lancement suit le chemin habituel ([Lancer Claude Code](https://ccam.dev/fr/features/launch.md)), avec un seul changement à l'étape MCP :

1. ccam trouve le compte, vérifie ses liens de partage et résout `claude`, comme pour tout lancement.
2. Il voit que la commande est `rc` ou `remote-control` et omet `--mcp-config`.
3. Si le compte partage des serveurs MCP, il compare le `mcp.json` du groupe avec le `sync-stamp` de `~/.local/state/ccam/mcp/work/`. Si `.claude.json` contient déjà les serveurs actuels, ou si le groupe n'en a aucun, il passe directement à l'étape 6.
4. Sinon, il nomme les serveurs qui manqueraient aux sessions :

   ```console
   $ ccam work rc
   ccam: Remote Control sessions only get MCP servers stored in account work's .claude.json, not the shared MCP servers (ctx, fs).
   Copy them into .claude.json (a backup is kept)? [y/N]
   ```

5. Avec `y`, il enregistre une sauvegarde de `.claude.json`, prend le verrou propre à Claude Code, ajoute les serveurs du groupe à `mcpServers` et conserve les autres serveurs du compte. Avec `N`, sans terminal ou pendant que le compte est en cours d'exécution, il ne modifie rien et le signale :

   ```console
         Starting without them. To copy them before every launch instead, set mcp_strategy = "sync" in ~/.config/ccam/config.toml
   ```

6. Il enregistre la session, fait pointer `CLAUDE_CONFIG_DIR` vers le dossier du compte et se remplace par `claude rc` via `exec`.

Remote Control continue ensuite de tourner comme serveur. Chaque session qu'il démarre pour vous est un processus enfant de ce processus et s'exécute donc en tant que `work` : avec la connexion, les paramètres et l'historique des conversations de `work`, et en comptant dans la limite d'utilisation de `work`. Tant que le serveur tourne, ccam considère le compte comme en cours d'exécution.

La simulation montre la différence. Un lancement normal transmet les serveurs du groupe en argument, Remote Control non :

```console
$ ccam --dry-run work
CLAUDE_CONFIG_DIR=/home/me/.local/share/ccam/profiles/work /home/me/.local/bin/claude --mcp-config=/home/me/.local/share/ccam/groups/default/mcp.json
$ ccam --dry-run work rc
ccam: Remote Control sessions only get MCP servers stored in account work's .claude.json, not the shared MCP servers (ctx, fs).
      Starting without them. To copy them before every launch instead, set mcp_strategy = "sync" in ~/.config/ccam/config.toml
CLAUDE_CONFIG_DIR=/home/me/.local/share/ccam/profiles/work /home/me/.local/bin/claude rc
```

## Pourquoi ça fonctionne ainsi

**Remote Control n'accepte pas `--mcp-config`.** Pour les lancements normaux, ccam transmet les serveurs du groupe à Claude Code sous la forme `--mcp-config=<path>` et n'écrit jamais dans les fichiers de Claude Code. `claude remote-control` refuse cette option avant son nom de commande et n'en accepte aucune après ; avant ccam 0.6.0, `ccam work rc` échouait donc pour tout compte qui partageait des serveurs MCP. ccam omet désormais l'option.

**Ses sessions ne lisent les serveurs que dans `.claude.json`.** Les sessions que démarre Remote Control n'héritent pas des options de la ligne de commande. Le seul endroit où elles trouvent des serveurs MCP utilisateur est le `.claude.json` du compte. Ce fichier contient aussi les informations de connexion du compte et l'état par dossier, si bien que ccam ne peut pas le lier à une copie partagée comme il le fait avec `settings.json`. Y copier les serveurs est le seul moyen de donner la liste partagée aux sessions.

**ccam demande avant d'écrire.** Avec la stratégie de l'option par défaut, ccam s'engage à ne pas toucher à `.claude.json`. Remote Control est le seul cas où il doit y écrire : il demande donc d'abord, garde une sauvegarde et ne touche qu'à `mcpServers`.

**Il n'écrit pas pendant que le compte tourne.** Claude Code réécrit `.claude.json` pendant une session, et une modification faite de l'extérieur serait perdue ou écrasée. C'est pourquoi ccam saute la copie dès qu'une session du compte est en cours, y compris un autre serveur Remote Control.

**Il demande une fois par changement.** Après une copie, `sync-stamp` contient l'heure de modification du `mcp.json` du groupe. ccam ne repose la question que lorsque ce fichier change, par exemple après `ccam mcp add`. Si vous répondez `N`, aucune copie n'existe encore, et la question revient donc à chaque lancement de Remote Control.

**`ccam mcp` tient les copies à jour.** Une entrée de `.claude.json` l'emporte sur `--mcp-config` en cas de conflit de noms : une ancienne copie masquerait donc une définition plus récente, y compris lors des lancements normaux. `ccam mcp add`, `add-json`, `remove` et `import` mettent donc à jour les copies de chaque compte qui n'est pas en cours d'exécution :

```console
$ ccam mcp add ctx --url https://mcp.context7.com/mcp
✓ ctx added in group default — applies from the next launch
✓ Updated the copy in account work's .claude.json (made for Remote Control)
```

**Sans terminal, la réponse est non.** Remote Control est souvent lancé depuis un script, un service ou `nohup`, où personne ne peut répondre. ccam démarre alors sans les serveurs au lieu d'attendre.

## Problèmes et solutions

### Les serveurs MCP partagés manquent dans les sessions Remote Control

La question a reçu la réponse `N`, il n'y avait pas de terminal, ou le compte était en cours d'exécution. Arrêtez Remote Control, fermez les autres sessions du compte et relancez `ccam work rc` dans un terminal ; répondez `y`. Pour ne plus jamais voir la question, définissez `mcp_strategy = "sync"` dans `~/.config/ccam/config.toml`. Les serveurs d'une session ne changent pas tant qu'elle tourne : démarrez donc une nouvelle session après la copie.

### "Account work is running, so its .claude.json is left alone"

Une session de `work` est encore ouverte : un `ccam work` normal, un raccourci ou un autre serveur Remote Control. Quittez-la et relancez `ccam work rc`. Les sessions d'un autre compte ne comptent pas.

### ccam pose la question à chaque fois

Vous n'avez pas encore copié les serveurs. Répondez `y` une fois, ou définissez `mcp_strategy = "sync"`. Si vous ne voulez jamais des serveurs dans Remote Control, cessez de partager MCP avec le compte : `ccam share work --mcp off`.

### `ccam work rc` échoue aussitôt avec une erreur concernant `--mcp-config`

Votre ccam est antérieur à la version 0.6.0 et transmet `--mcp-config` à Remote Control. Lancez `ccam update`. La même erreur avec un ccam à jour signifie qu'une option avec valeur précédait `rc`, comme dans `ccam work --model opus rc`, et que ccam a pris `opus` pour la commande ; placez `rc` juste après le nom du compte.

### Une modification faite avec `ccam mcp` n'atteint pas Remote Control

`ccam mcp add` et `remove` ne mettent à jour les copies que dans les comptes qui ne sont pas en cours d'exécution, et le signalent : `Note: account work is running, so the copy in its .claude.json stays as it was until its next Remote Control launch.` Arrêtez Remote Control puis redémarrez-le ; ccam voit que `mcp.json` a changé et repose la question.

### La copie a remplacé un de mes serveurs

Si le compte avait son propre serveur portant le même nom qu'un serveur du groupe, la copie l'a remplacé. Le `.claude.json` précédent se trouve dans `~/.local/state/ccam/mcp/work/backups/`, qui conserve les cinq plus récents. Pour garder votre version pour tous les comptes, déplacez-la dans le groupe avec `ccam mcp import work <server> --force` avant le prochain lancement de Remote Control.

### Je veux retirer les serveurs copiés

`ccam mcp remove <server>` retire un serveur du groupe et de chaque copie. Pour revenir à l'état d'avant la copie, restaurez la sauvegarde la plus récente de `~/.local/state/ccam/mcp/work/backups/` pendant qu'aucune session du compte ne tourne.

### Remote Control demande s'il faut faire confiance au dossier, ou quitte sans terminal

La confiance accordée aux dossiers est enregistrée par compte dans `.claude.json` : un dossier approuvé en tant que `personal` est donc nouveau pour `work`. Lancez `ccam work` une fois dans ce dossier et acceptez, puis démarrez Remote Control à cet endroit.

### "You must be logged in with a Claude account that has a subscription"

Remote Control exige une connexion avec un abonnement Claude. Vérifiez l'adresse e-mail du compte dans `ccam list`, et reconnectez-vous avec `ccam login work` si nécessaire.

### La session n'apparaît pas sur le téléphone

L'application Claude ou claude.ai/code est connectée avec un autre compte Claude. Comparez-le avec l'adresse e-mail que `ccam list` affiche pour `work`.

### ccam signale qu'un autre Claude Code partage l'historique des conversations dans ce dossier

Un autre compte du même groupe d'historique tourne dans le même dossier. Des sessions qui poursuivent la même conversation depuis les deux comptes peuvent mélanger l'historique. Répondez `y` seulement si elles travaillent sur des conversations différentes, ou démarrez Remote Control dans un autre dossier.

## Voir aussi

- [Lancer Claude Code](https://ccam.dev/fr/features/launch.md)
- [Serveurs MCP partagés](https://ccam.dev/fr/features/mcp.md)
- [Partage entre comptes](https://ccam.dev/fr/features/share.md)
- [Gérer les comptes](https://ccam.dev/fr/features/accounts.md)