chemenu/kb/sources/transcripts/Source - Conversation - Auto Mode and Tool Choice Session 2026-08-31.md

type, source_type, author, raw_files, source_language, date, tags, entities, concepts, summary

type	source_type	author	raw_files	source_language	date	tags	entities	concepts	summary
types/source.md	transcript	Claude Code (claude-opus-5)	raw/notes/Conversation Transcript - Auto Mode and Tool Choice Session 2026-08-31.md	en	2026-08-31	claude-code auto-mode permissions tool-choice harness	Claude Code wikitool	Claude Code Auto Mode Diff-Reviewable Agent Edits	Sitzung zum auto-Berechtigungsmodus von Claude Code: die vom Modus injizierte Bash-Praeferenz, ihre Korrektur zugunsten diffbarer Edits, und was zur Dokumentationslage belegt bzw. nicht belegt ist

Source: Conversation - Auto Mode and Tool Choice Session 2026-08-31

Autor: Claude Code (claude-opus-5)
Datum: 2026-08-31
Raw-Dateien: raw/notes/Conversation Transcript - Auto Mode and Tool Choice Session 2026-08-31.md
Typ: Notes

Zusammenfassung

Das Transkript ist eine vom Assistenten am Sitzungsende rekonstruierte Zusammenfassung, kein wörtliches Protokoll. Es ist eines von drei Transkripten derselben Sitzung; die beiden anderen behandeln die Werkzeugkorrekturen zu den Issues #12 und #13 (Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31) und die Issue-Triage (Source - Conversation - Issue Triage Labels and TODO Retirement Session 2026-08-31). Gegenstand ist ausdrücklich nicht der Wiki-Stack, sondern Claude Code als Harness. Die Sitzung erzeugte keinen Commit; ihr Ergebnis war eine dauerhaft gespeicherte Arbeitsregel und ein lokal abgelegter Entwurf für Produkt-Feedback.

Die Quelle trägt Material aus drei Erfassungsschichten, und ihr Kopfblock benennt sie selbst. Diese Unterscheidung ist der wichtigste Teil der Quelle und wird auf allen von ihr gestützten Seiten mitgeführt:

Schicht	Was darunter fällt	Belegwert
Lokal belegt	Ausgabe von claude --help auf Claude Code 2.1.251, Inhalt von ~/.claude/settings.json, Existenz des dangerouslyDisableSandbox-Parameters am Bash-Werkzeug, Torbens wörtliche Aussagen	In der Sitzung selbst bezeugt
Aus zweiter Hand	Alles im Abschnitt "What the subagent found documented": ein claude-code-guide-Subagent hat die Claude-Code-Dokumentation durchsucht und berichtet. Niemand in der Sitzung hat diese Dokumentation selbst gelesen	Vermittler in der Kette, Treue ist Annahme
Ausdrücklich unbelegt	Die Vermutung, die Bash-Präferenz hänge mit der Sandbox zusammen	Zum Zeitpunkt der Äußerung als Spekulation markiert und vom Subagenten nicht bestätigt

Der Anlass war eine Beschwerde über die Arbeitsweise des Assistenten. Torbens Frage wörtlich: "Warum verwendest du seit neuestem immer die Shell um Dateien zu editieren anstelle der file edit Tools? Das macht die Session schwer nachvollziehbar." Ursache war eine vom aktiven Berechtigungsmodus in die Sitzung injizierte Anweisung, die Bash den dedizierten Datei-Werkzeugen vorzieht:

While auto mode is active: Do your work through the Bash tool wherever it can accomplish the job: read files with cat, head, or sed -n, search with grep and find, and make file changes with sed, heredocs, or short scripts, rather than using the dedicated Read, Edit, or Write tools. Fall back to a dedicated tool only when Bash genuinely cannot do the job.

Der Assistent war ihr gefolgt und hatte lint.py, frontmatter_io.py und run_budget.py über heredoc'te python3 - <<'PY'-Blöcke mit s.replace(old, new) umgeschrieben. Die daraus abgeleitete Regel steht auf Diff-Reviewable Agent Edits, die Mechanik des Modus auf Claude Code Auto Mode.

Kernaussagen

• Der benannte Schaden ist die fehlende Diff. Ein python3 - <<'PY'-Block mit s.replace(old, new) zeigt dem Leser zwei String-Literale und keine Änderungsansicht. Was vorher in der Datei stand und was jetzt darin steht, ist nicht sichtbar; das Edit-Werkzeug zeigt genau das. Bei einem einzeiligen sed ist der Unterschied unerheblich, beim Mehrblock-Umbau eines Compiler-Moduls nicht.
• Die Auflösung stützt sich auf den Wortlaut der Anweisung selbst. Deren Qualifikator "wherever it can accomplish the job" trägt die Entscheidung: ein Edit, dessen Diff niemand prüfen kann, erfüllt die Aufgabe nicht. Zusätzlich rangiert die ausdrückliche Anweisung des Nutzers über einer Modus-Voreinstellung. Lesen mit cat/sed -n bleibt zulässig, Schreiben nicht. Die daraus gewordene Arbeitsregel: Edit/Write für Dateiänderungen, Bash für git, pytest, wikitool, grep und find. Sie wurde in das dauerhafte Gedächtnis des Assistenten geschrieben, damit sie die Sitzung überdauert.
• auto ist ein Berechtigungsmodus, kein Performance-Modus - lokal belegt aus claude --help auf Version 2.1.251: einer von sechs Werten für --permission-mode, neben acceptEdits, bypassPermissions, manual, dontAsk und plan.
• Das Bash-Werkzeug dieser Sitzung führt einen dangerouslyDisableSandbox-Parameter, ist also standardmäßig sandboxed; das Scratchpad-Verzeichnis der Sitzung wird als ohne Berechtigungsabfragen nutzbar beschrieben. Lokal belegt.
• Aus zweiter Hand (claude-code-guide-Subagent): auto lässt ein separates Klassifikator-Modell Aktionen vor der Ausführung bewerten, statt nachzufragen. Details, Schaltwege und die dokumentierte Falle mit permissions.defaultMode in einer Projekt-Settings-Datei stehen auf Claude Code Auto Mode.
• Der belastbare Negativbefund: die Bash-Präferenz selbst steht nicht in der öffentlichen Dokumentation - weder ihr Text noch eine Begründung - und es wurde keine Einstellung gefunden, die sie einzeln abschaltet, ohne auto ganz zu verlassen.
• Die Sandbox-Erklärung blieb Vermutung. Dass die Bash-Präferenz existiert, weil sandboxed Shell-Arbeit der Pfad ist, den der Modus ohne Rückfrage genehmigen kann, während Write/Edit das sind, was ein Berechtigungssystem am ehesten absichern will, wurde in der Sitzung ausdrücklich als Spekulation gekennzeichnet und vom Subagenten nicht bestätigt.
• Eine Korrektur im Verlauf: die früher in der Sitzung geäußerte Behauptung, es gebe einen /auto-Slash-Command, war falsch und wurde zurückgenommen.
• Zustand dieser Instanz: ~/.claude/settings.json enthält nur theme, inputNeededNotifEnabled und agentPushNotifEnabled, kein permissions.defaultMode. auto war also die eingebaute Voreinstellung für Plan und Version, keine hier getroffene Wahl.
• Empfehlung der Sitzung: in auto bleiben. Der Ausstieg kostet Berechtigungsabfragen auf allem, für ein Problem, das eine stehende Arbeitsregel bereits löst. Als Alternative wurde permissions.defaultMode: "acceptEdits" in der globalen Settings-Datei genannt - genehmigt Edits, fragt bei Shell-Kommandos nach und ist damit praktisch die Umkehrung der Beschwerde.

Aufgaben

• Der Entwurf für Produkt-Feedback - eine injizierte Anweisung, die das sichtbare Arbeitsverhalten ändert, sollte dokumentiert und einzeln abschaltbar sein - liegt lokal und wartet darauf, dass Torben ihn abschickt oder verwirft.

Nicht übernommen

• Die konkreten heredoc-Umbauten an lint.py, frontmatter_io.py und run_budget.py. Sie gehören inhaltlich zu den Issues #12/#13 und sind auf Source - Conversation - Comma Bug Budget Refund and Lint Report Path Session 2026-08-31 erfasst. Hier zählen sie nur als Beispiel für die Diff-Frage.
• Die Sandbox-Hypothese als Erklärung. Bewusst nicht auf eine Seite übernommen: sie war als Spekulation gekennzeichnet und wurde nicht bestätigt. Übernommen wurde stattdessen der Negativbefund, dass die Dokumentation zur Bash-Präferenz schweigt.
• Die vollständige Aufzählung der sechs --permission-mode-Werte mit ihren Bedeutungen. Nur auto war Gegenstand der Sitzung; für die anderen fünf liegt außer dem Namen nichts vor, und eine Seite, die sie erklärt, würde das erfinden.
• Der Wortlaut des Feedback-Entwurfs. Er ist unabgeschickter Entwurfstext, kein Befund.

Verwandte Entities

• Claude Code
• wikitool

Verwandte Concepts

• Claude Code Auto Mode
• Diff-Reviewable Agent Edits