Claude Code ガイド

Appearance

claude project purge: プロジェクトのClaude Code状態を一括削除する新コマンド ​

原文（日本語に翻訳） ​

claude project purge [path] を追加しました。プロジェクトのすべてのClaude Code状態（トランスクリプト、タスク、ファイル履歴、設定エントリ）を削除します。--dry-run、-y/--yes、-i/--interactive、--all オプションをサポートします。

原文（英語） ​

Added claude project purge [path] to delete all Claude Code state for a project (transcripts, tasks, file history, config entry) — supports --dry-run, -y/--yes, -i/--interactive, and --all

概要 ​

claude project purge は、特定のプロジェクトに紐づいたClaude Codeのすべての状態データ（トランスクリプト、タスク、ファイル変更履歴、設定エントリ）を削除する新しいコマンドです。プロジェクトを完全にリセットしたい場合や、センシティブな会話履歴を削除したい場合に役立ちます。削除前にドライランで確認できるため、安全に操作できます。

基本的な使い方 ​

bash
# 現在のディレクトリのプロジェクト状態を削除
claude project purge

# 指定したパスのプロジェクト状態を削除
claude project purge /path/to/project

# 実際に削除する前に何が削除されるか確認（ドライラン）
claude project purge --dry-run

# 確認プロンプトをスキップして即座に削除
claude project purge --yes

# インタラクティブに削除する項目を選択
claude project purge --interactive

# すべてのプロジェクトの状態を削除
claude project purge --all

実践例 ​

プロジェクト完了後のクリーンアップ ​

bash
# プロジェクトが完了したらトランスクリプトや履歴を削除
cd /path/to/completed-project

# まず何が削除されるか確認
claude project purge --dry-run

# 確認できたら実際に削除
claude project purge --yes

センシティブな情報を含む会話履歴の削除 ​

bash
# パスワードやAPIキーを誤って入力した会話履歴を削除
claude project purge /path/to/sensitive-project

# 削除内容を確認するインタラクティブモード
claude project purge --interactive /path/to/sensitive-project

CI/CD環境でのワークスペースリセット ​

bash
# CIパイプラインでビルドごとにClaude Code状態をリセット
# .github/workflows/cleanup.yml の例
name: Cleanup Claude Code State
on:
  workflow_dispatch:

jobs:
  cleanup:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Purge Claude Code state
        run: claude project purge --yes ${{ github.workspace }}

複数プロジェクトの一括クリーンアップ ​

bash
# すべてのプロジェクトの状態を一括削除（ドライランで確認後）
claude project purge --dry-run --all

# 問題なければ実際に削除
claude project purge --yes --all

注意点 ​

  • 削除した状態データは復元できません。必ず --dry-run で確認してから実行してください
  • --all フラグを使用すると、Claude Codeが追跡するすべてのプロジェクトの状態が削除されます
  • トランスクリプトには会話履歴が含まれます。センシティブな情報が含まれていないか確認してください
  • プロジェクトの設定エントリも削除されるため、カスタム設定は再設定が必要です
  • --interactive モードでは項目を選択して削除できるため、特定のデータのみ削除したい場合に便利です

関連情報 ​