Claude Code lehnt GBK-Dateien ab
Stand 2026-10-13 schreiben Edit und NotebookEdit in Claude Code die komplette Datei als UTF-8 zurück; bis Version 2.1.296 wurde jedes Byte, das sie nicht dekodieren konnten, durch das Ersetzungszeichen U+FFFD ersetzt – dadurch wurden chinesische und japanische Texte in GBK-, Shift-JIS- oder Windows-1252-Dateien unlesbar. Seit 2.1.296 (im offiziellen Changelog mit dem Datum October 9, 2026) werden solche Änderungen mit der Meldung File is not valid UTF-8 abgelehnt, ohne dass etwas geschrieben wird. Eine sichere Reihenfolge: Kodierung mit dem allgemeinen Befehl file feststellen, Datei sichern und mit iconv nach UTF-8 umwandeln, dann wieder in Claude Code bearbeiten. Auf den sechs für diesen Artikel am 2026-10-13 geprüften Doku-Seiten settings, troubleshooting, common-workflows, checkpointing, terminal-config und overview ist keine Einstellung beschrieben, mit der Sie die Kodierung einer Datei vorgeben.
Aktualisiert 2026-10-14
Abo-Kontingent aufgebraucht oder ständig 429? Wechseln Sie zu einer API mit Bezahlung pro Token und arbeiten Sie mit einem Key weiter.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Vier Punkte, die Sie zuerst klären sollten
Ab welcher Version abgelehnt wird
Im offiziellen Changelog steht dieser Satz unter 2.1.296, das Versionsdatum ist October 9, 2026; in der CHANGELOG.md auf GitHub steht dieselbe Passage wörtlich, dort tragen die Versionsüberschriften aber kein Datum.
Was ältere Versionen schrieben
Die offizielle Fehlerreferenz sagt: Before v2.1.296, Edit and NotebookEdit applied such an edit and saved every byte they couldn't decode as U+FFFD. Für ältere Versionen heißt es dort: Claude Code aktualisieren.
Was eine Ablehnung kostet
Wörtlich aus den Docs: Claude Code refused the change. Nothing was written, so the file is as it was. Bei einer Ablehnung bleibt die Datei bytegenau unverändert.
Der allgemeine Weg zum Prüfen
Das Manual file(1) beschreibt -i als Ausgabe von MIME-Type-Zeichenketten (im Beispiel text/plain; charset=us-ascii) und --mime-encoding als Ausgabe nur dieses Elements. Das sind Unix-Werkzeuge, keine Claude-Code-Optionen.
Warum Dateien zerstört wurden und jetzt abgelehnt wird
Stand 2026-10-13 beantworten die offiziellen Seiten beide Teile. Die Tools-Referenz nennt den Grund für die Ablehnung: The tools refuse because they save the whole file back as UTF-8, which would replace every byte they can't decode with the replacement character U+FFFD. Der Changelog hält fest, dass Edit und NotebookEdit vor 2.1.296 jedes Nicht-ASCII-Zeichen in Dateien ersetzten, die kein gültiges UTF-8 sind, und die Fehlerreferenz ergänzt, dass sie jeden nicht dekodierbaren Byte als U+FFFD speicherten – ein einzelner Edit-Vorgang genügte also, um den GBK-Text mit U+FFFD-Zeichen zu füllen. Jetzt lehnen Edit und NotebookEdit ab und fassen die Datei nicht an, und die Meldung nennt drei Legacy-Kodierungen: Windows-1252, Shift-JIS und GBK. Wichtig ist auch der Umfang: Laut Fehlerreferenz gilt die Prüfung den Bytes der gesamten Datei, deshalb erscheint dieselbe Meldung auch bei einer Datei, die UTF-8 sein soll und nur eine ungültige Bytefolge enthält.
Der Changelog-Satz im Wortlaut
Der Eintrag zu Claude Code 2.1.296 lautet: Fixed Edit and NotebookEdit replacing every non-ASCII character in files that are not valid UTF-8 (Windows-1252, Shift-JIS, GBK); such edits are now refused. Er steht wortgleich auf der Changelog-Seite von code.claude.com und in der CHANGELOG.md auf GitHub, und die Seite gibt an, dass sie aus dieser Datei erzeugt wird; das Datum October 9, 2026 trägt nur die Docs-Seite. Zwei frühere Einträge betreffen ebenfalls Kodierungen: 2.1.214 (July 18, 2026) stoppte, dass > und >> unter PowerShell 5.1 UTF-16LE-Dateien schrieben, die andere Werkzeuge nicht als UTF-8 lesen konnten, und 2.1.267 (September 9, 2026) ließ den Artifact-Publish Zeile und Spalte nennen, wenn die Datei kein gültiges UTF-8 ist oder U+FFFD enthält.
Drei datierte Einträge aus den offiziellen Seiten
Claude Code 2.1.214: behebt, dass > und >> unter Windows PowerShell 5.1 UTF-16LE-Dateien schrieben, die andere Werkzeuge nicht als UTF-8 lesen konnten, sowie UnicodeDecodeError in Python-Skripten beim Lesen von Nicht-UTF-8 auf der Standardeingabe. Die Tools-Referenz nennt für dieses Windows-Verhalten v2.1.214 oder später als Voraussetzung.
Claude Code 2.1.267: Scheitert das Veröffentlichen eines Artifacts an einer Datei, die kein gültiges UTF-8 ist oder U+FFFD enthält, nennt die Fehlermeldung jetzt Zeile und Spalte. Die Fehlerreferenz ergänzt, dass Claude Code vor v2.1.267 solche Dateien ungeprüft hochlud und der Server das Veröffentlichen ablehnte.
Claude Code 2.1.296: Edit und NotebookEdit ersetzen keine Nicht-ASCII-Zeichen mehr in Dateien, die kein gültiges UTF-8 sind (Windows-1252, Shift-JIS, GBK), und lehnen solche Änderungen stattdessen ab.
Bestätigt und nicht bestätigt
Bestätigt (wörtlich auf den offiziellen Seiten)
Folgendes steht so wortgetreu auf den offiziellen Seiten, die dieser Artikel am 2026-10-13 geprüft hat: der Changelog-Satz zu 2.1.296 und sein Datum October 9, 2026; der Satz der Tools-Referenz Claude can't use NotebookEdit on a file that isn't valid UTF-8. The same goes for Edit, unless the file starts with a little-endian UTF-16 byte-order mark. – NotebookEdit kann also eine Datei, die kein gültiges UTF-8 ist, nicht bearbeiten, für Edit gilt dasselbe, und die Ausnahme für eine little-endian UTF-16 Byte Order Mark ist dort nur bei Edit genannt; dass eine Ablehnung die Datei unverändert lässt und dass der Grund im Rückschreiben der gesamten Datei als UTF-8 liegt; der Meldungstext der Fehlerreferenz mit ihren beiden Wegen (Änderung per Shell-Befehl, der die Datei in ihrer eigenen Kodierung liest und schreibt, oder Umwandlung nach UTF-8 und danach erneutes Bearbeiten); dass vor v2.1.296 nicht dekodierbare Bytes als U+FFFD gespeichert wurden; und dass Write eine solche Datei weiterhin komplett ersetzen kann, den Inhalt dann aber als UTF-8 speichert und damit die ursprüngliche Kodierung verliert. Bei den allgemeinen Werkzeugen: -i und --mime-encoding in file(1); -f und --from-code, -t und --to-code, -l, -c, //TRANSLIT und //IGNORE in iconv(1); sowie die Kodierungsliste von GNU libiconv mit SHIFT_JIS, GBK und der CP1252-Familie.
Nicht bestätigt und nicht dokumentiert
Drei Punkte sind auf den acht offiziellen Claude-Code-Seiten nicht beschrieben, die dieser Artikel am 2026-10-13 geprüft hat (settings, troubleshooting, common-workflows, checkpointing, terminal-config, overview, errors und tools reference); verlassen Sie sich nicht darauf. Erstens fehlt dort jede Angabe, wie Sie die Kodierung einer Datei vorgeben: Nur die Seiten errors und tools reference beschreiben das Dekodieren von Dateien, auf den übrigen sechs steht keine Einstellung für die Kodierung. Zweitens gibt es dort kein Parameter und keine Einstellung, mit der Edit eine Datei als GBK zurückschreibt. Drittens bieten die Docs kein Werkzeug an, das bereits zu U+FFFD gemachten Text automatisch wiederherstellt – im Abschnitt zum Artifact-Publish sagt die Fehlerreferenz nur, Sie sollten die Datei erneut als UTF-8 speichern und jedes Zeichen ersetzen, das ein früherer Edit, Einfügen oder eine Umwandlung verloren hat. file(1) weist selbst darauf hin, dass Teile der Kodierungslogik in encoding.c festgeschrieben sind; die ausgegebene Kodierung ist ein Hinweis, kein Beweis.
Zwei offizielle Wege und zwei Arten von Wirrwarr
Kodierung behalten oder nach UTF-8 umwandeln
Die Fehlerreferenz nennt zwei Wege. Bleibt die Datei in ihrer jetzigen Kodierung, lassen Sie Claude die Änderung per Shell-Befehl vornehmen, der die Datei in dieser Kodierung liest und schreibt. Wollen Sie den Edit-Tool weiter nutzen, wandeln Sie die Datei nach UTF-8 um oder korrigieren Sie die ungültigen Bytes in einer Datei, die UTF-8 sein soll, und bitten Claude dann erneut um den Edit. Edit und NotebookEdit funktionieren erst nach der Umwandlung; für den ersten Weg beschreibt die Fehlerreferenz das Vorgehen, nennt aber keinen Befehl, der allgemeine Weg ist eine Form wie iconv -f GBK -t UTF-8.
Beschädigte Datei oder beschädigte Anzeige
Die Troubleshooting-Seite führt Kästen, Schlieren und falsche Glyphen in den integrierten Terminals von VS Code, Cursor und Devin Desktop auf den GPU-Renderer des Terminals zurück und empfiehlt, in Claude Code /terminal-setup auszuführen, um terminal.integrated.gpuAcceleration auf off zu setzen, oder dies in den Editor-Einstellungen zu ändern und das Fenster neu zu laden; die Bytes bleiben dabei unverändert. Bei einem echten Kodierungsproblem sehen Sie File is not valid UTF-8, und seit 2.1.296 wird nichts geschrieben. Stehen schon U+FFFD-Zeichen im Text, ist das das Zeichen, das Versionen vor 2.1.296 schrieben.
Gehen Sie sie in dieser Reihenfolge an
① Kodierung mit allgemeinen Befehlen feststellen. file(1) dokumentiert -i (MIME-Type-Zeichenketten, im Beispiel text/plain; charset=us-ascii) und --mime-encoding für nur dieses Element, und iconv -l listet die dem System bekannten Kodierungsnamen; das sind Unix-Werkzeuge, keine Claude-Code-Optionen. ② Sichern und umwandeln. Kopieren Sie zuerst die Originaldatei, rufen Sie dann iconv mit beiden Seiten auf: Im Manual steht iconv [ options ] [ -f from-encoding ] [ -t to-encoding ], als Beispiel iconv -f ISO-8859-15 -t UTF-8 < input.txt > output.txt. Das Manual sagt außerdem, dass nicht konvertierbare Zeichen den Lauf standardmäßig abbrechen, -c sie verwirft, //TRANSLIT ähnliche Zeichen verwendet und ein Fragezeichen setzt, wenn das nicht gelingt, und dass //IGNORE sie verwirft und nach der Umwandlung einen Fehler meldet; alle diese Varianten verlieren Zeichen, also prüfen Sie das Ergebnis und behalten Sie die Kopie. ③ Dann wieder in Claude Code bearbeiten. Aktualisieren Sie Claude Code auf 2.1.296 oder neuer (für ältere Versionen sagen die Docs nur: update Claude Code). Muss die Datei in ihrer Kodierung bleiben, folgen Sie der offiziellen Meldung und lassen Sie Claude einen Shell-Befehl nutzen, der diese Kodierung liest und schreibt; nach der Umwandlung nach UTF-8 arbeitet Edit wieder, während ein vollständiges Ersetzen mit Write die Datei als UTF-8 speichert und die ursprüngliche Kodierung verwirft.
Auf QCode
Die Prüfung der Kodierung läuft im Claude Code auf Ihrem Rechner und hängt nicht am gewählten Endpunkt. Für die Anbindung genügen zwei Werte: ANTHROPIC_BASE_URL auf https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN mit Ihrem cr_-Schlüssel aus der Konsole; auf der qcode.cc-Seite zur ANTHROPIC_BASE_URL-Einrichtung steht zusätzlich, dass der Wert ohne abschließenden Schrägstrich geschrieben wird und dass Claude-Modelle nur über den Anthropic-Endpunkt gehen. Stand 2026-10-13 sind claude-sonnet-5-5, claude-haiku-4-5-20251001 und claude-opus-5-5 auf QCode verfügbar. Abgerechnet wird pro Token; die Preise je Modell stehen auf /models.
Häufig gestellte Fragen
Warum hat Claude Code meine GBK-Datei ruiniert, und warum lehnt es die Änderung jetzt ab?
Weil Edit und NotebookEdit die gesamte Datei als UTF-8 zurückschreiben. Die Tools-Referenz nennt den Grund wörtlich: The tools refuse because they save the whole file back as UTF-8, which would replace every byte they can't decode with the replacement character U+FFFD. Genau das passierte vor 2.1.296, deshalb füllte ein einziger Edit-Vorgang chinesischen oder japanischen Text mit Ersetzungszeichen. Seit 2.1.296 werden solche Änderungen abgelehnt: Fixed Edit and NotebookEdit replacing every non-ASCII character in files that are not valid UTF-8 (Windows-1252, Shift-JIS, GBK); such edits are now refused – und die Fehlerreferenz ergänzt: Nothing was written, so the file is as it was. Wie die Zeichen auf Ihrem Bildschirm aussehen, entscheidet der Editor; die Dokumentation nennt U+FFFD.
Wie stelle ich fest, welche Kodierung eine Datei wirklich hat?
Mit dem allgemeinen Befehl file. Das Manual file(1) sagt, -i gibt MIME-Type-Zeichenketten statt der üblichen lesbaren Ausgabe aus (das Beispiel lautet text/plain; charset=us-ascii), und --mime-type und --mime-encoding geben nur das jeweilige Element aus. Nehmen Sie das als Hinweis: file klassifiziert Text über Bytebereiche und -folgen, und das Manual merkt an, dass Teile der Kodierungslogik in encoding.c festgeschrieben sind — wandeln Sie also mit iconv um und lesen Sie den Text gegen. Auf den am 2026-10-13 geprüften Seiten settings, troubleshooting, common-workflows, checkpointing, terminal-config und overview ist kein Claude-Code-Befehl beschrieben, der die Kodierung einer Datei anzeigt oder vorgibt.
Wie wandle ich nach UTF-8 um, und brauche ich vorher ein Backup?
Erst Backup, dann Umwandlung, zuletzt Vergleich. Die Aufrufform aus iconv(1) ist iconv [ options ] [ -f from-encoding ] [ -t to-encoding ]: -f steht für die Eingabekodierung, -t für die Ausgabekodierung, und das Beispiel im Manual lautet iconv -f ISO-8859-15 -t UTF-8 < input.txt > output.txt; bei einer GBK-Datei setzen Sie -f GBK. Das Manual warnt zudem: Ohne -c bricht iconv bei einem nicht konvertierbaren Zeichen ab, -c verwirft es, //TRANSLIT nähert es mit ähnlichen Zeichen an und setzt ein Fragezeichen, wenn das nicht gelingt, und //IGNORE verwirft es und meldet nach der Umwandlung einen Fehler. Alle diese Varianten verlieren Zeichen, also vergleichen Sie mit der Kopie. Das ist die übliche Unix-Tool-Nutzung, nicht Claude Code.
Gilt das auch für japanisches Shift-JIS und westliches Windows-1252?
Dasselbe Regelwerk. Der Satz zu 2.1.296 nennt Windows-1252, Shift-JIS und GBK in einem Atemzug; die Fehlerreferenz nennt dieselben drei, und die Tools-Referenz führt Windows-1252 und Shift-JIS als Beispiele an. Geprüft wird, ob die Bytes der ganzen Datei als UTF-8 dekodierbar sind — deshalb löst auch eine Datei, die UTF-8 sein soll, dieselbe Meldung aus, wenn eine einzige ungültige Bytefolge darin steckt. Die Namen für die Umwandlung nehmen Sie aus der Kodierungsliste von GNU libiconv: dort stehen SHIFT_JIS, CP932, GBK, CP936, GB18030, BIG5 und die Familie CP1250 bis CP1257, Ziel ist UTF-8.
Wie binde ich Claude Code über QCode an, und wo stehen die Preise?
Zwei Variablen. Das QCode-Claude-Code-Handbuch zeigt export ANTHROPIC_BASE_URL = https://api.qcode.cc/api und export ANTHROPIC_AUTH_TOKEN = cr_ gefolgt von Ihrem Schlüssel, und die Endpunkt-Tabelle der QCode-Dokumentation trägt für Claude Code denselben Wert https://api.qcode.cc/api ein; auf der qcode.cc-Seite zur ANTHROPIC_BASE_URL-Einrichtung steht zusätzlich, dass der Basiswert keinen abschließenden Schrägstrich hat und Claude-Modelle nur zum Anthropic-Endpunkt gehen. Stand 2026-10-13 sind claude-sonnet-5-5, claude-haiku-4-5-20251001 und claude-opus-5-5 auf QCode verfügbar. Abgerechnet wird pro Token; die Preise je Modell stehen auf /models.
Wie bezahle und starte ich aus China?
Mit Alipay oder WeChat Pay. Die QCode-Zahlungsseite listet auf der Auflade-Seite Alipay, WeChat Pay, Credit / Debit Card (Visa / Mastercard / AMEX), Apple Pay / Google Pay und Cryptocurrency (viele Coins und Netzwerke, Gutschrift nach manueller Gegenprüfung der On-chain-Überweisung). QCode arbeitet mit Vorauszahlung: erst aufladen, dann ein Paket kaufen, das vom Guthaben abgeht. Dort stehen auch die gedruckten Grenzen: Aufladungen in CNY ab ¥100, in USD zwischen $1 und $2,000. Nach der Registrierung legen Sie in der Konsole einen cr_-Schlüssel an und richten Claude Code darauf ein.
Quellen
Das Claude-Code-Changelog (die Changelog-Seite auf code.claude.com und die CHANGELOG.md auf GitHub) sowie die offiziellen Doku-Seiten Error reference, Tools reference, Troubleshooting, Settings, Terminal configuration, Overview, Common workflows und Checkpointing, alle am 2026-10-13 geprüft; für die allgemeinen Werkzeuge die Manualpages file(1) und iconv(1) auf man7.org und die GNU-libiconv-Dokumentation, gleichfalls vom 2026-10-13; für QCode die docs.qcode.cc-Seiten zu Endpunkten und API-Pfaden, das Claude-Code-Handbuch und die Zahlungsarten sowie die drei Artikel auf der Seite zur Nutzung von Claude Code in China, zur Installation mit einem Befehl und zur ANTHROPIC_BASE_URL-Einrichtung, alle am 2026-10-13 geprüft.
Ein cr_-Schlüssel, Claude Code verbunden
Setzen Sie ANTHROPIC_BASE_URL auf https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN wie im QCode-Handbuch beschrieben und nutzen Sie claude-sonnet-5-5 und weitere Claude-Modelle; abgerechnet wird pro Token, die Preise je Modell stehen auf /models.
Weiterführende Lektüre
Claude Code in China (Okt. 2026): Alipay und WeChat Pay
Claude Code aus China anschließen, inklusive Aufladen mit Alipay oder WeChat Pay.
Claude Code installieren 2026: Windows, macOS, Linux
Die offiziellen Installationsbefehle und das QCode-Skript mit einem Befehl.
ANTHROPIC_BASE_URL in Claude Code: 2 Variablen
Was die zwei Variablen bewirken und wie Sie sie für einen eigenen Endpunkt schreiben.
Die Zitate und Schritte auf dieser Seite wurden am 2026-10-13 mit dem Claude-Code-Changelog und -Dokumentation, den Manualpages file(1) und iconv(1), der GNU-libiconv-Dokumentation und den QCode-Docs abgeglichen; offizielle Seiten ändern sich ohne Ankündigung, maßgeblich sind die offiziellen Seiten. file und iconv sind allgemeine Unix-Werkzeuge: Diese Seite zeigt deren dokumentierte Verwendung, nicht Claude-Code-Optionen. Für die Modellverfügbarkeit ist /models maßgeblich.