環境変数

CLAUDE_CODE_PERFORCE_MODE

1 を設定すると、Perforce を考慮した書き込み保護を有効にする。設定すると、対象ファイルにオーナー書き込みビットがない場合、Edit、Write、NotebookEdit が p4 edit <file> のヒントとともに失敗する。Perforce は p4 edit で開くまで同期済みファイルからこのビットをクリアするため、これにより Claude Code が Perforce の変更追跡を回避することを防げる

使い方・用途

  • Perforce で管理されたリポジトリで Claude Code にファイルを編集させる際、p4 edit で開いていない読み取り専用ファイルへの意図しない上書きを防ぎたい
  • Claude Code に Perforce の変更追跡をバイパスさせず、必ず 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
環境変数 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

変更後

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

関連ドキュメント