Primeiros Passos

Instalação Rápida no macOS

Se você está no macOS com Apple Silicon, pule esta página e use o instalador de uma linha:

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

Ele cuida dos pacotes Homebrew, configuração do iTerm2, configuração do Podman e baixa tudo o que você precisa.

Pré-requisitos

Runtime de Contêiner

Você precisa de um runtime de contêiner na sua máquina. Docker ou Podman funcionam.

Docker

Plataforma	Instalação
macOS	Docker Desktop para Mac
Windows	Docker Desktop para Windows (backend WSL2)
Linux	Docker Engine ou Docker Desktop para Linux

Verifique se está funcionando:

docker --version
docker compose version

Podman

Plataforma	Instalação
macOS	Podman Desktop para Mac
Windows	Podman Desktop para Windows
Linux	Podman + Podman Compose

Verifique se está funcionando:

podman --version
podman-compose version

Apenas Linux

O Podman no Linux executa contêineres diretamente (sem VM). Certifique-se de que o socket do Podman esteja ativo para que o podman-compose possa se conectar:

systemctl --user enable --now podman.socket

Recursos do Sistema

Recurso	Mínimo	Recomendado
Disco	5 GB	10 GB+
RAM	8 GB alocados para o runtime de contêiner	12 GB+
CPU	2 núcleos	4+ núcleos

Docker

Ajuste os limites de recursos em Docker Desktop → Settings → Resources.

Podman

No macOS/Windows, ajuste os limites de recursos em Podman Desktop → Settings → Resources, ou via CLI:

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

No Linux, os contêineres compartilham os recursos do host diretamente — nenhuma configuração de recursos é necessária.

1. Configuração

Crie uma pasta e baixe o arquivo compose:

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

2. Adicione Suas Credenciais de Autenticação (Opcional)

Crie um arquivo .env na mesma pasta para pré-configurar o Claude Code. Escolha uma das seguintes opções:

Opção A: Claude Max (OAuth)

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

Opção B: LiteLLM ou proxy compatível com Anthropic

Se você tem uma instância LiteLLM ou outro proxy compatível com Anthropic, defina estas duas variáveis:

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

Defina apenas o domínio — o contêiner deriva automaticamente os sufixos de URL específicos do provedor (ex.: /anthropic para Claude Code).

Preencher automaticamente a partir de credenciais locais

Se você tem git e gh configurados no seu host, pode preencher a maioria dos valores do .env automaticamente. Comece copiando o template:

cp .env.example .env

Em seguida, execute os comandos que correspondem à sua configuração:

# 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

Depois edite o .env para adicionar seu token OAuth ou configurações de proxy LiteLLM (veja as opções acima).

Assistentes de IA

O arquivo .env.example contém marcadores @auto-detect em todas as variáveis que podem ser preenchidas a partir de ferramentas locais. Assistentes de IA como o Claude Code podem procurar esses marcadores e executar os comandos associados para construir um .env completo automaticamente.

3. Iniciar

Docker

docker compose up -d

Podman

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

A primeira execução baixa a imagem pré-construída do ghcr.io (~1 min dependendo da sua conexão). Inicializações subsequentes usam a imagem em cache e levam segundos.

4. Conectar

Docker

docker compose exec dev zsh

Podman

podman-compose exec dev zsh

5. Verificar

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

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

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

Teste a conexão com a IA:

claude -p "Say hello"

6. Seu Primeiro Projeto

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

7. Display Remoto (noVNC)

O contêiner inclui um display virtual para assistir agentes de IA controlarem um navegador. Abra http://localhost:6080/vnc.html para conectar. Veja Display Remoto (noVNC) para detalhes.

8. Automação de Navegador (Chrome DevTools MCP)

O Claude Code pode navegar em páginas web, capturar screenshots e inspecionar o DOM usando o servidor Chrome DevTools MCP integrado. Nenhuma configuração necessária — funciona automaticamente em modo headless. Veja Chrome DevTools MCP para detalhes.

9. Parando e Reiniciando

Docker

# Parar (preserva os dados)
docker compose down

# Iniciar novamente
docker compose up -d

# Destruir tudo e começar do zero
docker compose down -v
docker compose up -d

Podman

# Parar (preserva os dados)
podman-compose down

# Iniciar novamente (pull garante a imagem mais recente)
podman-compose pull && podman-compose up -d

# Destruir tudo e começar do zero
podman-compose down -v
podman-compose pull && podman-compose up -d

Seu código em /workspace e o diretório home persistem entre reinicializações. Veja Configuração — Persistência de Dados para detalhes.

---

Para builds locais e personalização do Dockerfile, veja Desenvolvimento Local. Para integração com VS Code, veja VS Code. Para opções de display remoto, veja Display Remoto (noVNC).