Artigos

Os 3 desafios ao iniciar o Claude Code pela primeira vez em contêiner Docker

25 de julho de 2026

O Claude Code para diante de três telas na primeira execução: onboarding, confiança na pasta e confirmação da chave de API. Sem intervenção manual o processo trava, exigindo pré-configuração.

Um agente que imprime um cabeçalho e fica parado continua emitindo bytes, parecendo ativo nos logs. Em um contêiner novo, o Claude Code para três vezes antes de produzir código.

As três etapas de bloqueio

Resolver parcialmente essas etapas mantém o agente travado.

Matriz de testes práticos

Medições em ambiente limpo com claude 2.1.220:

O problema do caminho real

A permissão em ~/.claude.json exige caminhos canônicos resolvidos, sem links simbólicos.

export function trustKeyFor(root: string): string {
  try {
    return realpathSync(root);
  } catch {
    return root;
  }
}

Aprovação da chave

A confirmação da chave tem como padrão 2. No (recommended). A CLI armazena apenas os 20 caracteres finais como token de aprovação.

export function approvalTokenFor(apiKey: string): string {
  return apiKey.slice(-20);
}

Atalhos ineficazes

O parâmetro --permission-mode bypassPermissions não ignora a confirmação de confiança do diretório.

Um tema é apenas estética. Apagar um arquivo é uma decisão crítica.

Liberamos a inicialização do ambiente mas preservamos a segurança em comandos destrutivos.

const trust: ProjectTrust = {
  hasTrustDialogAccepted: true,
  hasCompletedProjectOnboarding: true,
  projectOnboardingSeenCount: 0,
  allowedTools: [],
};

A execução na nuvem é explicada em rodar Claude Code na nuvem, e a gestão de conexão em observar um terminal remoto.

Respostas diretas