Artikel

Die 3 Hürden beim Erststart von Claude Code im Docker-Container

25. Juli 2026

Ein frischer Claude-Code-Agent stoppt nacheinander beim Onboarding, der Verzeichnis-Vertrauensfrage und der API-Key-Bestätigung. In automatisierten Umgebungen müssen diese Werte vorab in ~/.claude.json geschrieben werden.

Ein Agent, der ein Banner ausgibt und wartet, erzeugt Bytes, die im Log wie Erfolg aussehen. In einem neuen Container stoppt Claude Code dreimal vor jeder eigentlichen Arbeit.

Die drei Hürden in zeitlicher Abfolge

Unvollständige Vorkonfigurationen lassen den Agenten an der nächsten Hürde stranden.

Messmatrix aus der Praxis

Gemessen mit claude 2.1.220 in einer frischen HOME-Umgebung:

Die Falle mit relativen Pfaden

Pfadangaben in ~/.claude.json müssen zwingend kanonisch aufgelöst sein (ohne Symlinks).

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

Die Bestätigung des Schlüssels

Die Key-Abfrage wählt standardmäßig 2. No (recommended). Das CLI speichert die letzten 20 Zeichen als Genehmigungs-Token.

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

Unwirksame Abkürzungen

Der Parameter --permission-mode bypassPermissions umgeht den Vertrauensdialog nicht.

Ein Theme ist Kosmetik. Das Löschen von Dateien ist eine kritische Entscheidung.

Wir automatisieren die Einrichtung, belassen sensible Werkzeugfreigaben jedoch unter menschlicher Kontrolle.

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

Die Cloud-Ausführung wird in Claude Code in der Cloud ausführen beschrieben, die Verbindungskontrolle in ein Terminal beobachten.

Direkte Antworten