Claude Code実践ガイド
Claude CodeのGit・GitHub連携｜コミットからPR・Actionsまで
Gitのコマンドを覚えていなくても、Claude Codeなら「ここまでの変更をコミットして」「プルリクエストにして」という日本語で通ります。このページでは、手元でのGit操作、GitHubとの連携（gh CLI）、そしてGitHub上で@メンションするだけでAIが作業するActions連携までを、実際にこの構成でサイトを運用している筆者が段階順に説明します。
このサイトは Anthropic や Claude の公式サイトではありません。Claudeの基本的な使い方、ChatGPTとの違い、文章作成・長文整理・仕事での活用を初心者向けに整理する非公式ガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではAnthropic公式情報も確認してください。
段階1：手元のGit操作──コマンドを覚えない、という選択
Claude CodeはGitを直接操作できます。実務でよく使う指示は次のようなものです。
- 「ここまでの変更を内容ごとに分けてコミットして」──変更の意味を読んでコミットを分割し、メッセージも書いてくれます
- 「この機能用にブランチを切ってから作業して」
- 「さっきの変更を取り消して」──reset・revert・checkoutの使い分けをAI側が判断します
- 「昨日から何を変えたか要約して」──git logとdiffを読んで日本語で説明
Gitに苦手意識がある人にこそ効きます。「rebaseとmergeどっちだっけ」で手が止まる時間が消え、Gitは「AIに頼む安全装置」として機能し始めます。AIがファイルを壊しても1コマンドで戻せる状態が常にあることが、Claude Codeに大きな作業を任せられる根拠になるからです。まだgitを使っていない人は、それ自体をClaude Codeに設定させるところから始めてください（基本の使い方）。
段階2：GitHub操作──gh CLIを入れると世界が広がる
GitHub公式のコマンドラインツール「gh CLI」を入れてログインしておくと、Claude CodeはGitHub上の操作までできるようになります。
| 指示の例 | 裏で起きること |
|---|---|
| 「この変更をプルリクエストにして」 | ブランチ作成→push→PR作成→説明文の記述まで一気に |
| 「PRのレビューコメントに対応して」 | コメントを読み、該当箇所を修正し、返信まで下書き |
| 「未対応のIssueを一覧して」 | Issueを取得して優先度つきで要約 |
| 「CIが落ちた原因を調べて直して」 | Actionsのログを取得→原因特定→修正→再push |
特に最後の「CIが落ちたら任せる」は、覚えると戻れなくなる使い方です。エラーログを人間が読む必要がなくなり、「CI赤くなったから見といて」が仕事の指示として成立します。
段階3：GitHub Actions連携──@メンションでAIが動く
ここまでは「手元のClaude Codeから GitHubへ」の方向でした。逆方向、つまりGitHub上の操作からAIを動かすのがActions連携です。Claude Code内で /install-github-app を実行してセットアップすると、リポジトリでこんなことができるようになります。
- Issueのコメントで @claude このバグ直して と書くと、AIがそのIssueを読んで修正のPRを作る
- PRのレビューで @claude この指摘に対応して と書くと、修正コミットが積まれる
- PRが開かれるたびに自動でコードレビューを走らせる
手元にターミナルを開いていなくても、スマホのGitHubアプリからでも指示が出せる形です。Codexとの比較で「投げて待つ」型の話をしましたが、Actions連携を組むとClaude Codeでも同じ働かせ方ができます。なお、Actions側の実行にはAPIキー（またはOAuth設定）が必要で、実行分の費用はActionsの分数とAPI利用に載る点は把握しておいてください。
コミットの質を保つ運用のコツ
- コミットの粒度はAIに任せて、押す前に読む──「分けてコミットして」の分割は概ね適切ですが、pushの前に
git log --onelineを自分の目で見る習慣は残してください。読むのは数秒です - チームの規約はCLAUDE.mdに書く──コミットメッセージの形式（プレフィックスや言語）をCLAUDE.mdに書いておけば、毎回その形式で書いてくれます（CLAUDE.mdの育て方）
- AIが作ったことを隠さない──Claude Codeは既定でコミットに共同作成者の署名を残します。チーム開発では「どこまでAIが書いたか」が追える方がレビューも障害対応も健全です
秘密情報の扱い──連携を広げる前に1つだけ
GitHub連携で事故が起きるとしたら、ほぼ「秘密情報のpush」です。AIは.envやAPIキーのファイルを「必要なファイル」として素直にコミットしてしまうことがあります。対策は3層です。
- .gitignoreを最初に整える──.env・鍵ファイル・認証情報の類を必ず入れる。これ自体をClaude Codeに頼んでください（「このプロジェクトの.gitignoreを整備して」）
- CLAUDE.mdに明記する──「認証情報を含むファイルはコミットしない」と書いておく
- push前フックで機械的に止める──ここまでやるなら、秘密情報検出をhooksやpre-commitに仕込んで「破れないルール」にします（hooksの解説）
AIガイド群
FAQ
Git自体を知らなくても使えますか？
使えます。むしろClaude CodeはGit学習の最良の先生で、「今何をしたのか」を毎回日本語で説明させながら使えば、操作と概念が同時に身につきます。
gh CLIは必須ですか？
手元のGit操作だけなら不要です。PR作成やIssue操作などGitHub側の操作を頼みたくなった段階で入れれば十分です。
プライベートリポジトリでも使えますか？
使えます。手元のClaude Codeは自分のGit認証をそのまま使うためです。会社のリポジトリで使う場合は、就業先のAI利用ポリシーの確認が先です（法人利用の整理）。
GitHub以外（GitLab等）でも連携できますか？
手元のGit操作は当然動きます。ホスティング側の操作も、各サービスのCLIツールが入っていればかなりの部分を頼めます。@メンション型の公式連携はGitHubが最も整っています。