Claude Code が GBK ファイルの編集を拒否する理由

Edit と NotebookEdit がファイル全体を UTF-8 で書き戻すからです。Tools reference は拒否の理由を 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. と説明しており、2.1.296 より前はこの置換が行われていました。そのため GBK や Shift-JIS のファイルを一度編集するたびに本文が壊れていました。現在は同じ編集が拒否されます。changelog の原文は 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 で、Error reference は Nothing was written, so the file is as it was. と書いています。画面にどう映るかは編集ソフト次第で、公式が名指ししている文字は U+FFFD です。

汎用コマンドの file で確認します。file(1) では、-i は人間可読な形式の代わりに MIME 形式の文字列を出し、例として text/plain; charset=us-ascii が示されています。--mime-type と --mime-encoding はそれぞれの要素だけを出します。ただし結果は推定として扱ってください。マニュアルはテキストの種別をバイト範囲と続きで判別すると述べ、判定ロジックの一部が encoding.c にハードコードされているとも書いています。確実にするには iconv で変換して本文を見比べてください。2026-10-13 に確認した settings、troubleshooting、common-workflows、checkpointing、terminal-config、overview の各ページには、ファイルの文字コードを表示したり指定したりするコマンドは書かれていません。

先にバックアップ、次に変換、最後に見比べます。iconv(1) の書式は iconv [ options ] [ -f from-encoding ] [ -t to-encoding ] で、-f が入力文字の符号、-t が出力文字の符号です。マニュアルの例は iconv -f ISO-8859-15 -t UTF-8 < input.txt > output.txt なので、GBK ファイルなら -f GBK と置き換えます。マニュアルはまた、変換できない文字で既定では処理が止まり、-c はそれを破棄し、//TRANSLIT は似た字形を当てはめて無理ならはてなマークを出し、//IGNORE は破棄して変換後にエラーを出す、と明記しています。どれも文字を失うので、コピーと見比べてから Claude Code に編集させてください。これらは Unix ツールの標準的な使い方であり、Claude Code の引数ではありません。

同じ規則です。changelog の一文は Windows-1252、Shift-JIS、GBK を並べて書き、Error reference も同じ三つを名指しし、Tools reference は例として Windows-1252 と Shift-JIS を挙げています。判定はファイル全体のバイト列が UTF-8 として通るかどうかで、UTF-8 であるべきファイルに不正なバイトが一つでもあると同じメッセージが出ます。変換では GNU libiconv の符号一覧に SHIFT_JIS、CP932、GBK、CP936、GB18030、BIG5、CP1250 から CP1257 の一族が入っており、その名前を -f に渡します。目標の UTF-8 も同じ一覧にあります。

二つの環境変数です。QCode の Claude Code チュートリアルは export ANTHROPIC_BASE_URL = https://api.qcode.cc/api と、export ANTHROPIC_AUTH_TOKEN = cr_ の形に鍵を入れる例を示し、エンドポイント一覧の表も Claude Code に同じ https://api.qcode.cc/api を当てています。サイト内の ANTHROPIC_BASE_URL 設定ガイドは末尾のスラッシュを付けず、Claude モデルは Anthropic プロトコルのエンドポイントだけで使えると補足しています。2026-10-13 時点で claude-sonnet-5-5、claude-haiku-4-5-20251001、claude-opus-5-5 は QCode で利用できます。課金はトークン単位で、各モデルの単価は /models に載っています。

Alipay と WeChat Pay でチャージできます。QCode の支払い方法のページは、チャージ画面に Alipay、WeChat Pay、Credit / Debit Card（Visa / Mastercard / AMEX）、Apple Pay / Google Pay、Cryptocurrency（多くの通貨とネットワークに対応し、オンチェーン送金後は人手で照合）が並ぶと書いています。QCode は前払い制で、まずチャージし、次にプランを買うと残高から消化されます。ページに明記された金額は、人民元が ¥100 から、米ドルが $1 から $2,000 です。登録後にコンソールで cr_ で始まる鍵を作れば、Claude Code をつなげます。