AIエージェント導入・運用

Claude Codeを小さなCI作業に組み込む。読み取り・変更・実行・レビューを4段階で分ける

公開日 ・更新日

Anthropicの現行ドキュメントは、Claude Codeをコードベースを読み、ファイルを編集し、コマンドを実行し、開発ツールと連携するagentic coding toolと説明しています。ターミナル、IDE拡張、デスクトップアプリ、Webで利用でき、ログをパイプしたり、CIで翻訳や変更レビューを自動化したりする例も示されています。これは作業を自動で本番へ反映する許可ではありません。読み取り、変更、実行、レビューを分けて初めて、導入範囲を説明できます。

読み取り専用の作業から始める

最初は、変更されたファイル名やテストログを渡し、要約と確認すべき箇所だけを返す作業にします。リポジトリの秘密情報、顧客データ、本番接続情報を対象外にし、入力したファイルの一覧を記録します。出力が役に立つかを、見落としと確認時間で測ります。

変更は別ブランチへ閉じ込める

修正を試す段階では、作業ブランチと対象ディレクトリを固定します。依頼文に「変更して」と書くだけでなく、変更可能なファイル、禁止するファイル、実行してよいテストを明示します。差分が想定外なら、その場で停止し、元の状態へ戻せるコミットを残します。

コマンドを許可リストで分ける

CIでコマンドを実行させるときは、読み取り、テスト、生成、外部通信の順に危険度を分けます。最初は外部通信を伴わないテストだけを許可し、デプロイやデータ削除は人の操作へ戻します。Claude Codeの権限とツールアクセスを制御できる仕組みを使っても、許可の一覧と実行ログはチームで確認できるようにします。

レビューを完了条件にする

最後に、差分、テスト結果、残った警告、次に人が確認する項目をプルリクエストへまとめます。AIが修正を作れたことではなく、担当者が差分を読んで承認したことを完了条件にします。定期実行する場合も、失敗時に通知だけで止まるのか、担当者へ引き継ぐのかを先に決めます。

Claude CodeをCIへ組み込むときは、便利なコマンドを増やすより、読み取り・変更・実行・レビューの境界を小さく始めます。ターミナル、IDE、デスクトップ、Webのどこで使う場合でも、対象範囲と権限を記録し、人が戻れる差分を残すことが安全な導入の土台です。

出典（公式）：Anthropic「Claude Code overview」 https://docs.anthropic.com/en/docs/claude-code/overview

Claude Codeを開発フローへ安全に組み込み、権限とレビューまで設計したい方は、COZITOへご相談ください。

出典・参考資料

著者: 松井 勇樹