Démarrage rapide

Installation rapide sur macOS

Si vous êtes sur macOS avec Apple Silicon, ignorez cette page et utilisez l’installateur en une ligne :

curl -fsSL https://f5-sales-demo.github.io/devcontainer/scripts/install.sh | bash

Il gère les paquets Homebrew, la configuration d’iTerm2, la mise en place de Podman et télécharge tout ce dont vous avez besoin.

Prérequis

Environnement d’exécution de conteneurs

Vous avez besoin d’un environnement d’exécution de conteneurs sur votre machine. Docker ou Podman fonctionnent tous les deux.

Docker

Plateforme	Installation
macOS	Docker Desktop pour Mac
Windows	Docker Desktop pour Windows (backend WSL2)
Linux	Docker Engine ou Docker Desktop pour Linux

Vérifiez que tout fonctionne :

docker --version
docker compose version

Podman

Plateforme	Installation
macOS	Podman Desktop pour Mac
Windows	Podman Desktop pour Windows
Linux	Podman + Podman Compose

Vérifiez que tout fonctionne :

podman --version
podman-compose version

Linux uniquement

Podman sur Linux exécute les conteneurs directement (sans VM). Assurez-vous que le socket Podman est actif pour que podman-compose puisse se connecter :

systemctl --user enable --now podman.socket

Ressources système

Ressource	Minimum	Recommandé
Disque	5 Go	10 Go+
RAM	8 Go alloués à l’environnement d’exécution de conteneurs	12 Go+
CPU	2 cœurs	4+ cœurs

Docker

Ajustez les limites de ressources dans Docker Desktop → Paramètres → Ressources.

Podman

Sur macOS/Windows, ajustez les limites de ressources dans Podman Desktop → Paramètres → Ressources, ou via la ligne de commande :

podman machine set --cpus 4 --memory 12288
podman machine stop && podman machine start

Sur Linux, les conteneurs partagent directement les ressources de l’hôte — aucune configuration de ressources n’est nécessaire.

1. Mise en place

Créez un dossier et téléchargez le fichier compose :

mkdir devcontainer && cd devcontainer
curl -fsSLO https://raw.githubusercontent.com/f5-sales-demo/devcontainer/main/docker-compose.yml

2. Ajoutez vos identifiants d’authentification (Optionnel)

Créez un fichier .env dans le même dossier pour préconfigurer Claude Code. Choisissez l’une des options suivantes :

Option A : Claude Max (OAuth)

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-your-token-here

Option B : LiteLLM ou proxy compatible Anthropic

Si vous disposez d’une instance LiteLLM ou d’un autre proxy compatible Anthropic, définissez ces deux variables :

LITELLM_BASE_URL=https://your-litellm-endpoint.example.com
LITELLM_API_KEY=your-api-key

Définissez uniquement le domaine — le conteneur dérive automatiquement les suffixes d’URL spécifiques au fournisseur (par exemple /anthropic pour Claude Code).

Remplissage automatique depuis les identifiants locaux

Si vous avez git et gh configurés sur votre machine hôte, vous pouvez remplir automatiquement la plupart des valeurs du .env. Commencez par copier le modèle :

cp .env.example .env

Puis exécutez les commandes correspondant à votre configuration :

# Git identity
echo "GIT_AUTHOR_EMAIL=$(git config user.email)" >> .env
echo "GIT_AUTHOR_NAME=\"$(git config user.name)\"" >> .env

# Timezone
echo "TZ=$(readlink /etc/localtime | sed 's|.*/zoneinfo/||')" >> .env

# GitHub CLI token (requires: gh auth login)
echo "GH_TOKEN=$(gh auth token)" >> .env

# SSH key (if you use SSH for git)
echo "SSH_PRIVATE_KEY=$(base64 < ~/.ssh/id_ed25519)" >> .env

Ensuite, éditez le .env pour ajouter votre jeton OAuth ou vos paramètres de proxy LiteLLM (voir les options ci-dessus).

Assistants IA

Le fichier .env.example contient des marqueurs @auto-detect sur chaque variable pouvant être remplie à partir d’outils locaux. Les assistants IA comme Claude Code peuvent scanner ces marqueurs et exécuter les commandes associées pour construire automatiquement un .env complet.

3. Démarrage

Docker

docker compose up -d

Podman

podman-compose pull && podman-compose up -d

Le premier lancement télécharge l’image pré-construite depuis ghcr.io (~1 min selon votre connexion). Les démarrages suivants utilisent l’image en cache et ne prennent que quelques secondes.

4. Connexion

Docker

docker compose exec dev zsh

Podman

podman-compose exec dev zsh

5. Vérification

# AI tools
claude --version
codex --version
pi --version

# Languages
node --version
python3 --version
go version

# Cloud CLIs
aws --version
az --version
terraform --version

Testez la connexion IA :

claude -p "Say hello"

6. Votre premier projet

cd /workspace
git clone https://github.com/your-org/your-project.git
cd your-project
claude

7. Affichage distant (noVNC)

Le conteneur inclut un affichage virtuel pour observer les agents IA contrôler un navigateur. Ouvrez http://localhost:6080/vnc.html pour vous connecter. Consultez Affichage distant (noVNC) pour plus de détails.

8. Automatisation du navigateur (Chrome DevTools MCP)

Claude Code peut naviguer sur des pages web, prendre des captures d’écran et inspecter le DOM grâce au serveur Chrome DevTools MCP intégré. Aucune configuration nécessaire — il fonctionne automatiquement en mode headless. Consultez Chrome DevTools MCP pour plus de détails.

9. Arrêt et redémarrage

Docker

# Arrêt (préserve les données)
docker compose down

# Redémarrage
docker compose up -d

# Tout détruire et repartir de zéro
docker compose down -v
docker compose up -d

Podman

# Arrêt (préserve les données)
podman-compose down

# Redémarrage (pull garantit la dernière image)
podman-compose pull && podman-compose up -d

# Tout détruire et repartir de zéro
podman-compose down -v
podman-compose pull && podman-compose up -d

Votre code dans /workspace et le répertoire personnel persistent entre les redémarrages. Consultez Configuration — Persistance des données pour plus de détails.

---

Pour les builds locaux et la personnalisation du Dockerfile, consultez Développement local. Pour l’intégration VS Code, consultez VS Code. Pour les options d’affichage distant, consultez Affichage distant (noVNC).