DOCUMENTAÇÃO

Instalação

Prepare seu Mac, conecte o agente que você já usa e abra seu primeiro worktree no Squad Studio.

Requisitos

  • Mac com Apple Silicon.
  • Git disponível no Terminal. Confira com git --version. Se precisar, consulte o guia do Git para macOS.
  • Ao menos um motor de código instalado e configurado, como Claude Code, Codex ou OpenCode.
  • GitHub CLI instalado e autenticado se você quiser usar Clonar do GitHub… no app.

Instalar no Mac

  1. Quando a nova versão estiver disponível, baixe e abra o arquivo .dmg.
  2. Arraste o Squad Studio para a pasta Aplicativos.
  3. Abra o app. A tela de primeiro uso verifica o Git, os motores instalados e o estado do login quando o motor disponibiliza essa informação.

Configurar um motor

Abra Configurações → Motores para ver quais ferramentas o Squad Studio encontrou. Você pode começar com um único motor.

Claude Code
Instale o CLI, execute claude no Terminal e conclua o login. Guia do Claude Code
Codex
Instale o Codex CLI, execute codex no Terminal e siga as instruções de autenticação. Guia do Codex CLI
OpenCode
Instale o CLI e use Copiar ao lado do comando de login no Squad Studio. Execute o comando copiado no Terminal para autenticar o perfil usado pelo app. Para usar modelos do OpenRouter, selecione esse provedor no login do OpenCode e informe sua chave de API. Guia do OpenCode

Volte a Configurações → Motores e clique em Verificar de novo.

Seu primeiro worktree

  1. Em Workspaces, clique em Adicionar repositório… e selecione a pasta de um repositório Git local.
  2. Clique no + ao lado do repositório. Escolha a branch base e dê um nome ao novo worktree.
  3. Selecione o worktree, clique no + das abas de sessão, escolha o motor e envie sua primeira mensagem.
  4. Abra o painel Alterações para revisar o diff dos arquivos editados.

Problemas comuns

O motor aparece como “Não encontrado”
Abra uma nova janela do Terminal e execute command -v seguido do nome do CLI, como command -v codex. Se nenhum caminho aparecer, confira a instalação e o PATH do seu shell. Depois, rode a verificação no app.
O motor aparece como “Falta login”
Conclua o login do CLI. Para OpenCode, use o comando copiado do Squad Studio para autenticar o perfil correto.
O app não lista meus repositórios do GitHub
Execute gh auth status no Terminal. Se precisar entrar, use gh auth login e tente clonar novamente pelo app. Guia de autenticação do GitHub CLI