Overview Version History Q & A Rating & Review
Autosave Before AI Edits
ターミナルの Claude Code（CLI）がファイルを読み書きする直前に、VS Code で編集中の未保存ファイルを自動保存する拡張機能です。CLI 利用時に、人間の未保存編集と Claude のディスク編集が衝突したり、古い内容が読まれたりするのを防ぎます。VS Code パネルの autosave（"Auto-save files before Claude reads or writes them"）と同じ保護を、ターミナルの CLI 利用者に提供します。
必要なもの
VS Code 1.85 以上
Claude Code（claude コマンド）
macOS または Linux（フックが curl を使用します。Windows は非対応）
インストール
常用する場合（拡張をパッケージ化してインストール）
npm install
npm run compile
npx @vscode/vsce package # autosave-before-ai-edits-0.1.0.vsix が生成される
code --install-extension autosave-before-ai-edits-0.1.0.vsix
試すだけの場合（デバッグ実行）
VS Code でこのフォルダを開き、メニュー 実行 → デバッグの開始 を選びます。新しいウィンドウ（拡張開発ホスト）で拡張が動作します。
使い方
拡張を入れると、VS Code 起動時に自動で有効になり、Claude の設定ファイル ~/.claude/settings.json にフックを登録します。
フックを反映させるため、登録後に新しい claude セッションを開始してください （起動中のセッションには反映されません）。
あとは普段どおり作業するだけです。VS Code で編集中（未保存）のファイルを Claude が読み書きする直前に、そのファイルが自動保存されます。
右下のステータスバーに ✓ AI Autosave
コマンド
コマンドパレット（Cmd+Shift+P）から実行できます。
コマンド
内容
Enable Integration
有効化（フック登録・保存サーバ起動）
Disable Integration
無効化（フック削除）。全 VS Code ウィンドウに影響します
Show Status
現在の状態を表示
Open Logs
ログを開く
設定
設定キー
既定値
内容
autosaveBeforeAiEdits.enabledtrue有効/一時停止
autosaveBeforeAiEdits.saveTools["Read","Edit","MultiEdit","Write"]保存の引き金とするツール。Read を外すと読み取り時は保存しません
autosaveBeforeAiEdits.excludeGlobs[]保存しないパス（ワークスペースルートからの相対）
autosaveBeforeAiEdits.hookTimeoutMs800応答待ちの上限（ミリ秒）。超えたら保存を待たずに進みます
設定は変更すると自動で反映されます。
仕組みと制限
Claude のフックが対象ファイルのパスを拡張に通知し、拡張がそのファイルを保存します。ファイルの内容を外部に送信することはありません 。
Bash ツール経由の書き込み（sed -i、リダイレクトなど）は対象パスを取得できないため保護されません 。保護対象は Read / Edit / MultiEdit / Write です。保存に hookTimeoutMs（既定 800ms）以上かかると、フックは保存を待たずに進みます。このとき Claude が古い内容を読む可能性があります（大きいファイルや遅いディスク、重い format-on-save で起きやすい）。該当時はログに警告を記録します。大きいファイルを扱う場合は hookTimeoutMs を増やしてください。
複数のウィンドウで同じファイルを別々に未保存編集 している場合、保存により一方の変更が失われることがあります。この検出（警告）は未実装です（既知の未対応）。
アンインストール
拡張を削除する前に 、コマンド Disable Integration を実行してください。これで ~/.claude/settings.json のフックが削除されます。先に拡張だけを削除するとフック登録が残るため、その場合は以下を手動で削除します。
~/.claude/settings.json 内の、~/.autosave-before-ai-edits/hook.sh を指す PreToolUse エントリディレクトリ ~/.autosave-before-ai-edits/
開発
npm install
npm run compile
npm test
