Per Iniziare

Installazione rapida su macOS

Se utilizzi macOS con Apple Silicon, salta questa pagina e usa l’installer in una riga:

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

Gestisce i pacchetti Homebrew, la configurazione di iTerm2, il setup di Podman e scarica tutto il necessario.

Prerequisiti

Runtime per Container

Hai bisogno di un runtime per container sulla tua macchina. Docker o Podman funzionano entrambi.

Docker

Piattaforma	Installazione
macOS	Docker Desktop per Mac
Windows	Docker Desktop per Windows (backend WSL2)
Linux	Docker Engine o Docker Desktop per Linux

Verifica che funzioni:

docker --version
docker compose version

Podman

Piattaforma	Installazione
macOS	Podman Desktop per Mac
Windows	Podman Desktop per Windows
Linux	Podman + Podman Compose

Verifica che funzioni:

podman --version
podman-compose version

Solo Linux

Podman su Linux esegue i container direttamente (senza VM). Assicurati che il socket Podman sia attivo affinché podman-compose possa connettersi:

systemctl --user enable --now podman.socket

Risorse di Sistema

Risorsa	Minimo	Consigliato
Disco	5 GB	10 GB+
RAM	8 GB allocati al runtime del container	12 GB+
CPU	2 core	4+ core

Docker

Modifica i limiti delle risorse in Docker Desktop → Impostazioni → Risorse.

Podman

Su macOS/Windows, modifica i limiti delle risorse in Podman Desktop → Impostazioni → Risorse, oppure tramite CLI:

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

Su Linux, i container condividono direttamente le risorse dell’host — non è necessaria alcuna configurazione delle risorse.

1. Configurazione

Crea una cartella e scarica il file compose:

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

2. Aggiungi le Tue Credenziali di Autenticazione (Opzionale)

Crea un file .env nella stessa cartella per pre-configurare Claude Code. Scegli una delle seguenti opzioni:

Opzione A: Claude Max (OAuth)

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

Opzione B: LiteLLM o proxy compatibile con Anthropic

Se disponi di un’istanza LiteLLM o di un altro proxy compatibile con Anthropic, imposta queste due variabili:

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

Imposta solo il dominio — il container deriva automaticamente i suffissi URL specifici del provider (ad es. /anthropic per Claude Code).

Popolare automaticamente dalle credenziali locali

Se hai git e gh configurati sul tuo host, puoi popolare automaticamente la maggior parte dei valori del .env. Inizia copiando il template:

cp .env.example .env

Poi esegui i comandi corrispondenti alla tua configurazione:

# 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

Poi modifica il .env per aggiungere il tuo token OAuth o le impostazioni del proxy LiteLLM (vedi le opzioni sopra).

Assistenti AI

Il file .env.example contiene marcatori @auto-detect su ogni variabile che può essere popolata dagli strumenti locali. Gli assistenti AI come Claude Code possono cercare questi marcatori ed eseguire i comandi associati per costruire automaticamente un .env completo.

3. Avvio

Docker

docker compose up -d

Podman

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

La prima esecuzione scarica l’immagine pre-compilata da ghcr.io (~1 min a seconda della connessione). Gli avvii successivi utilizzano l’immagine in cache e richiedono pochi secondi.

4. Connessione

Docker

docker compose exec dev zsh

Podman

podman-compose exec dev zsh

5. Verifica

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

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

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

Testa la connessione AI:

claude -p "Say hello"

6. Il Tuo Primo Progetto

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

7. Display Remoto (noVNC)

Il container include un display virtuale per osservare gli agenti AI controllare un browser. Apri http://localhost:6080/vnc.html per connetterti. Consulta Display Remoto (noVNC) per i dettagli.

8. Automazione del Browser (Chrome DevTools MCP)

Claude Code può navigare pagine web, catturare screenshot e ispezionare il DOM utilizzando il server Chrome DevTools MCP integrato. Non è necessaria alcuna configurazione — funziona automaticamente in modalità headless. Consulta Chrome DevTools MCP per i dettagli.

9. Arresto e Riavvio

Docker

# Arresto (preserva i dati)
docker compose down

# Riavvio
docker compose up -d

# Eliminare tutto e ricominciare da zero
docker compose down -v
docker compose up -d

Podman

# Arresto (preserva i dati)
podman-compose down

# Riavvio (pull assicura l'immagine più recente)
podman-compose pull && podman-compose up -d

# Eliminare tutto e ricominciare da zero
podman-compose down -v
podman-compose pull && podman-compose up -d

Il tuo codice in /workspace e la directory home persistono tra i riavvii. Consulta Configurazione — Persistenza dei Dati per i dettagli.

---

Per build locali e personalizzazione del Dockerfile, consulta Sviluppo Locale. Per l’integrazione con VS Code, consulta VS Code. Per le opzioni di display remoto, consulta Display Remoto (noVNC).