環境変数

CLAUDE_CODE_PERFORCE_MODE

Perforce を考慮した書き込み保護を有効にするには 1 を設定します。

使い方・用途

  • ファイルが読み取り専用属性（Perforce の未編集状態）の場合に、AI が強制上書きするのを防ぎ、p4 edit の実行を促します。
  • ソース管理との整合性を保ち、意図しないファイル変更によるワークフローの破壊を防止します。
英語原文(公式ドキュメントより)

Set to 1 to enable Perforce-aware write protection. When set, Edit, Write, and NotebookEdit fail with a p4 edit <file> hint if the target file lacks the owner-write bit, which Perforce clears on synced files until p4 edit opens them. This prevents Claude Code from bypassing Perforce change tracking

関連する変更履歴

v2.1.98 (1件)

Added
Permissions
環境変数 CLAUDE_CODE_PERFORCE_MODE を追加しました。これが有効な場合、読み取り専用ファイルへの編集時に警告なしで上書きするのではなく、p4 edit（チェックアウト）のヒントを表示して処理を失敗させます。
英語原文を表示
Added CLAUDE_CODE_PERFORCE_MODE env var: when set, Edit/Write/NotebookEdit fail on read-only files with a p4 edit hint instead of silently overwriting them

変更前

Perforce などのVCS環境下でファイルが読み取り専用属性になっている場合、AIがそれを無視して強制的に上書きしてしまい、ソース管理との整合性が取れなくなるリスクがありました。

変更後

読み取り専用ファイルへの書き込みが制限され、ユーザーに適切な Perforce コマンドの実行を促すようになります。

ユーザーへの恩恵

エンタープライズ開発環境において、意図しないファイル上書きを防ぎ、既存のワークフローに沿った安全なコード編集が可能になります。

関連ドキュメント