# Comment faire transcrire de l’audio et de la vidéo par Claude Code ?

> Ajoutez le serveur MCP de KolWrite avec une seule commande, claude mcp add, ou installez la skill kolwrite-transcribe. Claude Code envoie alors votre fichier, lance le job, attend le résultat et écrit la transcription, les sous-titres ou la traduction dans votre projet. La facturation se fait à la seconde, sur vos crédits KolWrite.

Dernière mise à jour: 2026-11-21 · HTML: https://console.kolwrite.com/fr/agents/claude-code

## Ce que vous faites une seule fois

Créez le compte et la clé vous-même sur [console.kolwrite.com](https://console.kolwrite.com/auth?lang=fr) : inscrivez-vous, ajoutez des crédits, ouvrez API Keys et créez une clé. Un agent ne peut pas le faire à votre place.

Placez la clé dans le fichier de profil de votre shell (`~/.zshrc`, `~/.bashrc`) pour que chaque session d’agent que vous lancez puisse la lire, puis ouvrez un nouveau terminal :

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

Les outils lisent la clé uniquement dans cette variable. Ne la collez pas dans un chat et ne la committez pas dans un dépôt.

## Ajouter le serveur MCP

Lancez la commande dans un terminal où `KOLWRITE_API_KEY` est définie. Ajoutez `--scope user` pour l’avoir dans tous vos projets :

```bash
claude mcp add --transport stdio --env KOLWRITE_API_KEY="$KOLWRITE_API_KEY" kolwrite -- npx -y https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz
```

Le serveur donne à l’agent six outils : `transcribe_file`, `transcribe_url`, `upload_file`, `get_job`, `list_models`, `list_languages`. Il s’exécute sur votre ordinateur avec Node.js 18 ou une version plus récente et se télécharge depuis https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 `0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca`).

Vérifiez avec `claude mcp list`, ou avec `/mcp` dans une session.

## Ou installer la skill

La skill est un dossier contenant un SKILL.md et le client en un seul fichier. Claude Code la charge depuis `~/.claude/skills` (tous les projets) ou `.claude/skills` (un projet) et l’utilise quand vous demandez une transcription :

```bash
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip && rm kolwrite-transcribe.zip
```

Le texte de la skill est dans [SKILL.md](https://console.kolwrite.com/skills/kolwrite-transcribe/SKILL.md). Utilisez le serveur MCP ou la skill, pas besoin des deux.

## Que lui demander

Trois demandes à essayer avec Claude Code :

```text
Transcris ~/Downloads/interview.m4a avec KolWrite et enregistre le texte dans interview.txt à côté du fichier.

Génère des sous-titres SRT en anglais pour talk.mp4 avec KolWrite, un sous-titre par phrase.

Qui a dit quoi dans team-call.mp3 ? Transcris-le avec identification des locuteurs sur le modèle oracle, puis liste les actions à mener pour chaque intervenant.
```

Claude Code a besoin du fichier sur votre ordinateur ou d’un lien direct vers un fichier média. Pour une vidéo de plus de 100 MiB environ, il extrait d’abord l’audio avec ffmpeg.

## Combien ça coûte

| Tâche | Modèle | Coût |
| --- | --- | --- |
| Un entretien de 30 minutes, texte brut | `base` | 0,24 US$ |
| Une réunion d’une heure avec identification des locuteurs | `oracle` | 1,56 US$ |
| Une conférence d’une heure en hébreu avec sous-titres en anglais | `oracle` | 1,44 US$ |
| Une heure d’audio bruyant avec des voix qui se chevauchent | `oracle_max` | 3,60 US$ |

La facturation se fait à la seconde d’audio, sur vos crédits, sans minimum. L’identification des locuteurs ajoute 0,10 crédit par heure d’audio. Le serveur MCP et kolwrite.py utilisent `base` tant que vous ou l’agent n’indiquez pas un autre modèle, et `oracle_mini` pour traduire. Tous les tarifs : [/fr/models](https://console.kolwrite.com/fr/models).

## Ce que l’agent ne doit pas faire

- Vous demander la clé dans le chat, l’afficher, ou l’écrire dans un fichier, une commande ou un commit.
- Relancer la même transcription après un timeout ou une erreur réseau. Chaque lancement crée un nouveau job facturé ; il doit plutôt vérifier le job existant ou vous demander.
- Saisir lui-même des horodatages. Pour couper ou citer à un moment précis, il reprend les numéros de segments de la transcription et calcule les temps dans le code à partir des horodatages des mots.
- Envoyer comme média l’adresse d’une vidéo YouTube ou d’une autre page web. Il lui faut le fichier média lui-même.
- Transcrire de longs enregistrements (plus d’une heure) sans vous indiquer d’abord le coût prévu.

## Questions et réponses

### Claude Code a-t-il besoin du serveur MCP, ou peut-il appeler l’API lui-même ?

Il peut appeler l’API REST lui-même avec curl ou Python si vous ajoutez à `CLAUDE.md` la consigne de [agent-instructions.md](https://console.kolwrite.com/agent-instructions.md). Le serveur MCP ou la skill lui évitent de réécrire à chaque fois le code d’envoi et de suivi.

### Où va l’audio ?

Le fichier est envoyé à KolWrite et transcrit dans le cloud, selon les [conditions d’utilisation et la politique de confidentialité de KolWrite](https://www.kolwrite.com/tos_pp.html). Le serveur MCP n’en garde aucune copie.

## Pages associées

- [Codex](https://console.kolwrite.com/fr/agents/codex)
- [Tout agent : kolwrite.py et la skill](https://console.kolwrite.com/fr/agents/any-agent)
- [Monter une vidéo avec des agents IA](https://console.kolwrite.com/fr/guides/video-editing-with-ai)
- [Outil de transcription pour agents IA](https://console.kolwrite.com/fr/guides/transcription-tool-for-ai-agents)
- [Documentation de l’API](https://console.kolwrite.com/fr/public_api_docs)

---
Obtenir une clé API: https://console.kolwrite.com/auth?lang=fr · Documentation de l’API: https://console.kolwrite.com/fr/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
