---
title: "Bien démarrer | Kalka docs"
description: "Installer Kalka sur macOS, Windows ou Linux, passer l’avertissement du premier lancement et commencer votre premier design."
url: https://kalka.design/fr/docs/getting-started
language: fr
---

Kalka est un éditeur de design où chaque calque du canvas est un vrai élément HTML stylé en CSS. Vous dessinez avec les outils que vous connaissez déjà dans les autres apps de design ; le moteur de navigateur intégré à Kalka met en page et affiche le résultat. Ce que vous voyez, c’est la page elle-même, pas une image de la page.

## Installer

Kalka est gratuit et open source (MIT). Téléchargez la version pour votre système :

| Système | Téléchargement | Fichier |
| --- | --- | --- |
| macOS, Apple silicon | Télécharger | .dmg |
| macOS, Intel | Télécharger | .dmg |
| Windows | Télécharger | installeur .exe |
| Linux | Télécharger | .AppImage |

Toutes les versions sont aussi listées sur la [page des releases GitHub](https://github.com/leyscore/kalka/releases).

- **macOS :** ouvrez le `.dmg` et faites glisser Kalka dans Applications.

- **Windows :** lancez l’installeur.

- **Linux :** rendez le fichier exécutable, puis lancez-le :

```
chmod +x Kalka-*.AppImage
./Kalka-*.AppImage
```

## Le premier lancement

**Les versions bêta ne sont pas encore signées.** Votre système vous avertit la première fois que vous ouvrez Kalka. Cela n’arrive qu’une fois par version, et les étapes ci-dessous vous permettent de passer outre.

- **macOS :** ouvrez Kalka. Quand macOS refuse, allez dans **Réglages Système › Confidentialité et sécurité**, faites défiler jusqu’au message concernant Kalka, cliquez sur **Ouvrir quand même** et confirmez. Si macOS indique plutôt que l’app est endommagée, lancez cette commande dans le Terminal, puis rouvrez Kalka :

```
xattr -dr com.apple.quarantine /Applications/Kalka.app
```

- **Windows :** quand SmartScreen affiche « Windows a protégé votre ordinateur », cliquez sur **Informations complémentaires**, puis sur **Exécuter quand même**.

La page [Dépannage](https://kalka.design/fr/docs/troubleshooting) donne plus de détails si l’avertissement revient.

## Mises à jour

Kalka cherche une nouvelle version quelques secondes après son démarrage. S’il en trouve une, la fenêtre **Mise à jour logicielle** liste les changements et propose **Installer la mise à jour** ; la nouvelle version prend le relais au redémarrage de Kalka. Vous pouvez aussi vérifier vous-même avec **Rechercher des mises à jour…** dans le menu de l’app.

Sur macOS, une copie non signée ne peut pas se remplacer elle-même. La fenêtre de mise à jour propose alors **Télécharger** : récupérez le nouveau `.dmg` et remplacez Kalka dans Applications.

## L’essayer dans le navigateur

**Pas besoin d’installer quoi que ce soit pour découvrir.** Essayez Kalka dans votre navigateur sur [demo.kalka.design](https://demo.kalka.design).

La démo ouvre le fichier d’exemple dans l’éditeur. L’app desktop ajoute ce qu’un navigateur ne sait pas faire : enregistrer des dossiers Kalka, garder des versions avec Git, et le serveur MCP auquel les agents se connectent.

L’éditeur fonctionne dans Chrome et Edge 111 ou plus récent, Firefox 128 ou plus récent, et Safari 16.4 ou plus récent.

## L’écran d’accueil

_L’écran d’accueil de Kalka : le champ du nom, le curseur de Pebble, et les boutons Connecter mon agent et Piloter via MCP_

L’écran d’accueil. Votre curseur prend le nom que vous tapez, à côté de celui de Pebble.
À la première ouverture, Kalka vous demande comment vous appeler. Votre nom reste sur cet ordinateur ; les personnes avec qui vous partagez un fichier le voient à côté de votre curseur. Juste à côté du vôtre se trouve le curseur de **Pebble**, l’agent de Kalka.

Choisissez ensuite comment travailler avec un agent :

- **Connecter mon agent** configure le panneau IA avec l’agent de code déjà installé sur votre ordinateur, comme Claude Code, Codex ou Gemini CLI, ou avec une clé d’API. Voir [Les agents dans Kalka](https://kalka.design/fr/docs/agents).

- **Piloter via MCP** explique comment laisser un agent que vous lancez ailleurs travailler sur le canvas. Voir [MCP et ACP](https://kalka.design/fr/docs/mcp).

- **Passer la configuration** mène directement à l’accueil. Vous pourrez tout faire plus tard dans les Paramètres.

## L’accueil

C’est depuis l’accueil que démarre chaque document.

_L’accueil de Kalka : le message de bienvenue, le champ de demande pour l’agent, les formats proposés, et les onglets Récents et Stockage avec l’exemple Les bases_

L’accueil, avec la demande pour l’agent, les formats de départ et le fichier d’exemple.

- **Décrivez une page** dans le champ du haut et appuyez sur **Générer** : votre agent la dessine en calques. Si aucun agent n’est configuré, Kalka propose d’en configurer un et garde ce que vous avez écrit.

- **Partez d’un format :** Bureau (1440 × 900), Portable (1280 × 800), Tablette (834 × 1194), Mobile (390 × 844), Post social (1080 × 1350), ou Libre pour un canvas vide.

- **Rejoindre une salle…** ouvre un fichier que quelqu’un a partagé avec vous, à partir de son lien ou de son ID.

- **Ouvrir…** ouvre un fichier `.fig`, `.kalka` ou `.pen` ; **Ouvrir un dossier…** ouvre un dossier Kalka (app desktop).

- **Coller du HTML** transforme du HTML copié depuis une page web ou un éditeur de code en calques.

- **Importer un projet Claude Design…** ouvre un export Claude Design. Voir [Importer](https://kalka.design/fr/docs/import).

- **Ouvrir depuis une URL** ouvre un fichier `.fig`, `.pen` ou `.html` à partir d’un lien `https://`.

En dessous, **Récents** liste les fichiers que vous avez ouverts, le dernier en premier pour que vous puissiez le reprendre. **Stockage** liste les fichiers d’un espace de stockage cloud, si vous en avez connecté un.

## Les bases

Le fichier d’exemple **Les bases** se trouve sur l’accueil. C’est une page de courtes leçons faites de vrais calques. Ouvrez-le, puis :

- **Faire la visite** pour un tour rapide de l’éditeur.

- **Chaque calque est du code** ouvre le panneau Code à côté d’un calque, pour voir son HTML et son CSS.

- **Concevoir avec un agent IA** montre comment en connecter un.

Quand vous êtes prêt, lisez [Canvas et calques](https://kalka.design/fr/docs/canvas).
