apply_patch ツール

構造化パッチ形式を使用してファイルの変更を適用します。単一の edit 呼び出しでは壊れやすい、複数ファイルまたは複数ハンクの編集に最適です。

このツールは、1 つ以上のファイル操作をラップした単一の input 文字列を受け取ります。

*** Begin Patch*** Add File: path/to/file.txt+行 1+行 2*** Update File: src/app.ts@@ 任意の変更コンテキスト-古い行+新しい行*** Delete File: obsolete.txt*** End Patch

パラメーター

• input（必須）: *** Begin Patch と *** End Patch を含むパッチの全内容。

注意事項

• パッチのパスでは、相対パス（ワークスペースディレクトリ基準）と絶対パスを使用できます。
• tools.exec.applyPatch.workspaceOnly のデフォルトは true（ワークスペース内）です。apply_patch でワークスペースディレクトリ外への書き込みや削除を意図的に行う場合にのみ、false に設定してください。
• ファイル名を変更するには、*** Update File: ハンク内で *** Move to: を使用します。
• *** End of File は、必要な場合に EOF のみに対する挿入を示します。
• すべてのモデルでデフォルトで有効です。無効にするには tools.exec.applyPatch.enabled: false を設定します。または、tools.exec.applyPatch.allowModels を使用して特定のモデルに限定します （gpt-5.4 のような未加工の ID、または openai/gpt-5.4 のような完全な ID を指定できます）。
• 設定は tools.exec.applyPatch.* にあります。

例

{  "tool": "apply_patch",  "input": "*** Begin Patch\n*** Update File: src/index.ts\n@@\n-const foo = 1\n+const foo = 2\n*** End Patch"}

関連項目