Claude Code configエラー「Could not read」の直し方
「Could not read Claude Code config」の原因は~/.claude.jsonの破損です。実際の出力、自動バックアップからの戻し方、settings.jsonとの違いを示します。
Could not read Claude Code configが出る条件
claude import を実行したときに、次のメッセージが出てコマンドが止まることがあります。
Could not read Claude Code config — run `claude` with no arguments to recover it.原因は1つです。Claude Codeが保存しているのは、OAuthのアカウント情報やプロジェクトごとの状態です。その ~/.claude.json が、正しいJSONとして読めなくなっています。手で編集して構文を崩した、書き込みが途中で止まった、といった状況で起きます。
メッセージの前には、壊れたファイルの場所と構文エラーの内容も表示されます。v2.1.289で、わざと構文を崩したファイルを置いた空のホームディレクトリから claude import codex --dry-run を実行すると、次の出力になりました。
claude import codex --dry-run
# Claude configuration file at ~/.claude.json is corrupted: JSON Parse error: Property name must be a string literal
# The corrupted file has been backed up to: ~/.claude/backups/.claude.json.corrupted.1791115894880
#
# Could not read Claude Code config — run `claude` with no arguments to recover it.この実行で ~/.claude.json は書き換えられず、元の内容のまま残りました。~/.claude/backups/ には、壊れたファイルのコピーが .claude.json.corrupted.<タイムスタンプ> の名前で作られました。同じコマンドをもう一度実行すると、2行目は「The corrupted file has already been backed up.」に変わります。コピーは1回目だけ作られ、繰り返し実行しても増えません。
直し方は自動復旧か手直しか
claude import は設定ファイルを読んだ時点で終了するため、復旧の操作は別に行います。復旧には2つの道があり、~/.claude.json の中身を残したいかどうかで分かれます。
どちらで直すか
自動復旧
claude を引数なしで起動し、ダイアログでリセットを選びます。MCPサーバー設定やプロジェクトごとの許可記録は既定値に戻ります。壊れる前の状態は、後述のバックアップから見比べて戻せます。
手で直す
JSON構文のエラー箇所だけをエディタで直し、手を入れた内容をそのまま残します。
手順1: claudeを引数なしで実行する
claude を通常どおり起動すると、Claude Codeが ~/.claude.json の異常を検出します。設定ページでは、壊れたファイルを ~/.claude/backups/.claude.json.corrupted.<timestamp> にコピーすると説明されています。そのうえで、終了して手で直すか、既定の設定にリセットするかを尋ねます。-p を付けた実行では、ダイアログは出ずにエラーを表示して終了します。復旧が終わったら claude import を再実行します。
claude
# ダイアログの案内に従う
claude import codex --dry-runリセットの前にバックアップを取る動作は、v2.1.199の更新で入りました。それより前のバージョンでは、起動時の復旧ダイアログでリセットを選ぶと、壊れたファイルが元に戻せない形で失われていました。古いバージョンを使い続けている環境では、リセットの前に自分でコピーを取っておきます。
手順2: JSON構文だけを手で直す
MCPサーバー設定など手を入れた覚えのある内容を残したい場合は、~/.claude.json をエディタで開いてJSON構文だけを直します。どこが壊れているかは、python3 -m json.tool が行番号付きで教えてくれます。
python3 -m json.tool ~/.claude.json
# Expecting property name enclosed in double quotes: line 1 column 9 (char 8)上の出力は、末尾にカンマが残った {"a": 1,} というファイルに対するものです。指された行番号が直す箇所で、構文エラーが消えれば claude import はそのまま再実行できます。
書き込みの途中でプロセスが止まり、ファイルが途中で切れている場合は、末尾に閉じ括弧を足しても元のデータ構造と食い違うことがあります。こうした場合は手順1の自動復旧と、次節のバックアップを組み合わせるほうが確実です。
自動バックアップから前の状態に戻す
~/.claude.json は、Claude Codeが書き換えるたびに ~/.claude/backups/ へ以前の版をコピーします。ディレクトリの説明には、新しい5つを残し、解析できなかった版のコピーも別に残ると書かれています。
| 名前 | 中身 |
|---|---|
.claude.json.backup.<timestamp> | 中身書き込む前の版。新しい5つが残る |
.claude.json.corrupted.<timestamp> | 中身解析できなかった版のコピー |
リセットで設定が消えた場合は、この中から壊れる前の版を選んで戻します。
ls -t ~/.claude/backups/
python3 -m json.tool ~/.claude/backups/.claude.json.backup.<timestamp> > /dev/null && echo OK
cp ~/.claude/backups/.claude.json.backup.<timestamp> ~/.claude.json2行目で、戻す候補が正しいJSONかどうかを先に確かめます。<timestamp> は一覧に出た実際の値に置き換えてください。問題に気づいてから時間が空くと、壊れる前の版が新しい版に押し出されていることがあります。
claude purge でプロジェクトの状態を消しても、backups/ の中は対象になりません。古い .claude.json のスナップショットには、消したはずのプロジェクトエントリ(信頼設定、履歴、MCPサーバー設定)が残っている場合があります。このスナップショットも、保持は最大5つで、新しい版に押し出されて自動的に消えます。
CLAUDE_CONFIG_DIRを設定していると場所が変わる
CLAUDE_CONFIG_DIR は、設定ディレクトリ(既定は ~/.claude)を切り替える環境変数です。この変数を設定した環境では、.claude.json は ~/.claude.json ではなく、指定したディレクトリの直下に置かれます。
空のディレクトリを CLAUDE_CONFIG_DIR に指定し、その中の .claude.json を壊しました。そこで claude import codex --dry-run を実行したところ、エラーに出たパスは $CLAUDE_CONFIG_DIR/.claude.json でした。コピーは $CLAUDE_CONFIG_DIR/backups/ に作られました。ホームディレクトリ側には何も作られていません。
サインインの認証情報も同じ指定に従います。LinuxとWindowsの .credentials.json は、CLAUDE_CONFIG_DIR 配下に置かれます。macOSのKeychainのエントリも、ディレクトリごとに別になります。
複数のアカウントを CLAUDE_CONFIG_DIR で使い分けている場合は、先に echo $CLAUDE_CONFIG_DIR で値を確かめます。壊れているのは、既定の ~/.claude.json ではなく、そのシェルが指しているディレクトリ側のファイルです。python3 -m json.tool やバックアップの cp も、同じディレクトリを対象にします。
手で編集して壊れやすいパターン
~/.claude.json を直接編集する機会は少ないものの、MCPサーバーの設定(ヘッダーや環境変数)を書き換えたり、古いエントリを消したりするときに構文を崩しがちです。
末尾カンマの残存: 配列やオブジェクトの最後の要素の後にカンマを残したまま次の要素を削除すると、JSONとして不正になります。JSONはJSON5やJSONCと違い、末尾カンマを許容しません。上で示した実機の出力も、この型でした。
閉じ括弧の数が合わない: ネストしたオブジェクトの一部だけを削除すると、{ と } の対応が崩れます。エディタの対応括弧ハイライトを使うと見つけやすくなります。
Windowsパスのバックスラッシュ未エスケープ: "path": "C:\Users\name" のように書くと、JSONの文字列エスケープに反してパースが失敗します。C:\\Users\\name のように二重にするか、C:/Users/name とスラッシュに統一します。
引用符の閉じ忘れ: 値の途中で改行し、文字列を閉じる " を書き忘れるケースです。エディタの構文ハイライトで、文字列の色が想定より長く続いていないか確かめると見つかります。
編集の前に python3 -m json.tool ~/.claude.json > /dev/null を実行すると、既存の状態が正しいJSONであることを確かめてから作業を始められます。
~/.claude.jsonとsettings.jsonは別ファイル
このエラーは settings.json の話ではありません。名前は似ていますが、役割も、壊れたときの扱いも別です。片方は拡張子の前にドットが付く(.claude.json)ので、エディタの一覧では位置を見比べてください。
| ファイル | 保存する内容 | 壊れたときの扱い |
|---|---|---|
~/.claude.json | 保存する内容OAuthのアカウント情報・MCPサーバー設定(user/local)・プロジェクトごとの信頼設定・/config が書くグローバル設定キー | 壊れたときの扱いclaude import は本記事のエラーで終了。対話セッションは「Configuration error」の復旧ダイアログ |
~/.claude/settings.json など | 保存する内容permissions / hooks / env などの設定キー | 壊れたときの扱いセッション開始時に「Settings Error」のダイアログ。Claudeの助けで直す・終了・壊れた設定なしで続行を選べる |
permissions や hooks を ~/.claude.json に書いても反映されません。公式のトラブルシューティング表でも、設定が無視される原因として「~/.claude.json に書いた」ことが挙がっています。permissions や hooks、env といったキーは settings.json に置きます。
settings.json 側の個々のエントリだけが不正な場合は、「Settings Warning」としてその値だけが飛ばされ、ファイルの残りは有効なままです。claude doctor を実行すると、セッションを起動せずに、不正な設定ファイルや拒否されたエントリを一覧できます。壊れたのが .claude.json なのか settings.json なのかで迷ったときは、この出力を先に見ます。
再発を防ぐ運用
手動編集そのものを減らすのが一番の予防策です。MCPサーバーの追加は claude mcp add --scope user のようにCLIから行い、~/.claude.json を直接開かないようにします。CLI経由なら、手で構文を崩す機会がなくなります。
どうしても手動編集が必要なとき(社内スクリプトで複数マシンに設定を配布する場合など)は、直接上書きせずに一時ファイルへ書き出します。python3 -m json.tool で検証して、問題がなければ mv で置き換えます。書き込みの途中でプロセスが落ちても、壊れるのは一時ファイルだけです。
~/.claude/ を手で掃除するときも、消さずに残すファイルがあります。.credentials.json(ログイン情報)、agent-memory/(サブエージェントのメモリ)、jobs/ と daemon/(バックグラウンドセッションの状態)です。キャッシュとロックファイルは消しても問題ありません。
自前のバックアップを取るなら、保存先はローカルディスクに限ります。~/.claude.json にはOAuthのアカウント情報とMCPサーバーの設定が入っています。Gitリポジトリやクラウド同期フォルダには置かないでください。
よくある質問
claude importが使えない環境でもこのエラーは出るか
claude import は次の環境では使えません。Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundry、Claude Platform on AWSです。フィーチャーフラグの取得を無効にしている場合も使えず、v2.1.213以降のコマンドです。これらの環境では claude import 自体が使えないため、このメッセージには行き着きません。
関連して確認したい設定
~/.claude.json と settings.json の役割分担を押さえておくと、似た症状の切り分けが早くなります。settings.json の全項目はClaude Code settings.json完全ガイドにあります。インストール直後に起きやすいエラーの切り分けはClaude Codeインストールエラーの切り分けチェックリスト、起動時エラー全般の一覧はClaude Codeでよくあるエラー10選にまとめています。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。
関連する記事
Claude Code をもっと見る →Claude Codeとは — できること・料金・始め方と使い方の全体像
Could not import a serverエラー — Desktopインポート失敗の原因と対処
tool call could not be parsedエラーの原因と対処 — Claude Code
claude importが使えない「not yet available in this build」の意味と対処
Claude CodeがColimaのdevcontainerでUnsupported platformを出すとき
Claude Codeのskillで制御文字が混ざると「No shell command」で全部止まる