CC逆引きリファレンス

設定をリセットしたい

15. トラブルシューティング

コマンド / 機能

~/.claude を削除

完全リセット

概要

Claude Code のすべての設定、キャッシュ、履歴を削除してクリーンな状態に戻します。設定が壊れて復旧できない場合の最終手段です。

設定例

# 完全リセット(全ての設定・履歴を削除)
rm -rf ~/.claude

# 部分的なリセット
# 設定のみリセット(履歴は残す)
rm ~/.claude/settings.json

# プロジェクト設定のみリセット
rm -rf .claude/

# リセット後の初期設定
claude
# → 初回起動と同じ設定フローが開始される

# 重要: バックアップを取ってからリセット
cp -r ~/.claude ~/.claude.backup
rm -rf ~/.claude

こんな時に使う

  • 設定が壊れて動作しない時
  • クリーンな状態からやり直したい時

使い方

  1. 1重要な設定がある場合はバックアップを取る
  2. 2rm -rf ~/.claude を実行
  3. 3Claude Code を再起動
  4. 4初回セットアップを再度実行

Tips

  • リセット前に ~/.claude/settings.json をバックアップ推奨
  • プロジェクト設定(.claude/)は別途リセットが必要
  • 認証情報も削除されるので再ログインが必要