Claude Codeはターミナルから操作するAIコーディングツールですが、GitHubと連携することで「コードを書く→コミット→プッシュ→PR作成」までをAIに任せることができます。
この記事では、Claude CodeとGitHubを連携する手順と、実際の活用方法を解説します。
事前準備
連携前に以下が揃っていることを確認してください。
- GitHubアカウントを持っている
- Claude Codeがインストール済み（
npm install -g @anthropic-ai/claude-code） - Gitがインストール済み（
git --versionで確認） - ローカルにリポジトリがクローン済み、またはこれから作成する
Claude Code は Node.js 18以上が必要です。node -v でバージョンを確認してください。
GitHub CLIのインストールと認証
Claude CodeはGitHub操作に GitHub CLI（gh） を活用します。まずインストールと認証を行います。
GitHub CLIのインストール
# macOS（Homebrew）
brew install gh
# Windows（winget）
winget install --id GitHub.cli
# Ubuntu / Debian
sudo apt install ghGitHubへのログイン
gh auth loginコマンドを実行すると対話形式でセットアップが進みます。
- What account do you want to log into? →
GitHub.com - What is your preferred protocol? →
HTTPS（推奨） - How would you like to authenticate? →
Login with a web browser
ブラウザが開くので、表示されたワンタイムコードを入力して認証を完了します。
認証完了後は gh auth status で接続状態を確認できます。Logged in to github.com と表示されれば成功です。
Claude Codeを起動してGitHubを操作する
認証が済んだら、プロジェクトフォルダで Claude Code を起動します。
cd your-project
claudeあとはチャット形式で指示を出すだけです。以下に代表的な操作例を紹介します。
コミット＆プッシュ
# Claude Codeへの指示例
「変更内容をコミットしてmainブランチにプッシュしてください」Claude Code が git diff で変更内容を確認し、適切なコミットメッセージを提案→コミット→プッシュまで実行します。
プルリクエストの作成
# Claude Codeへの指示例
「今の変更でプルリクエストを作成してください。タイトルと説明文も考えてください」内部で gh pr create コマンドを使い、変更内容を読み取ったうえで PR のタイトル・説明文を自動生成します。
Gitの基本操作をClaude Codeに任せる
Claude Codeは自然言語の指示をGitコマンドに変換して実行します。覚えておくと便利な指示パターンを紹介します。
やりたいこと
Claude Codeへの指示例
現在の変更を確認
「変更差分を見せてください」
新しいブランチを作成
「feature/login-formというブランチを作って切り替えてください」
特定のコミットに戻す
「1つ前のコミットに戻してください」
コンフリクトの解消
「マージコンフリクトを解消してください」
PRのレビュー確認
「PR #5 のレビューコメントを確認して修正してください」
リリースノートの作成
「前回タグからの変更をまとめてリリースノートを作ってください」
CLAUDE.mdでプロジェクトの設定を共有する
プロジェクトのルートに CLAUDE.md ファイルを置くと、Claude Codeが毎回読み込むプロジェクト固有の設定を記述できます。チームで使う場合は、このファイルをGitで管理すると全員が同じ設定で利用できます。
# CLAUDE.md の記述例
## プロジェクト概要
ECサイトのバックエンドAPI（Node.js + Express）
## コーディング規約
- インデント: スペース2つ
- コミットメッセージ: Conventional Commits 形式
- PRは必ずdevelopブランチに向けて作成する
## よく使うコマンド
- 開発サーバー起動: npm run dev
- テスト実行: npm test
- ビルド: npm run buildCLAUDE.md はGitHubにコミットしてチームで共有しましょう。新メンバーがClaude Codeを使い始めるときのオンボーディングにも役立ちます。
注意点
Claude Codeは確認なしにコミット・プッシュを実行することがあります。本番ブランチへの直接プッシュには注意し、ブランチ保護ルールをGitHub側で設定しておくと安心です。
- シークレット情報（APIキー、パスワードなど）は
.gitignoreや.envファイルで管理し、絶対にコミットしない - 大きな変更は一度に任せず、小さな単位で確認しながら進めるのがおすすめ
ghコマンドの権限はリポジトリの操作に限定されるよう、OAuthスコープを確認しておく
まとめ
Claude CodeとGitHubの連携に必要な手順をまとめます。
手順
内容
①
GitHub CLI（gh）をインストール
②
gh auth login でGitHub認証
③
プロジェクトフォルダで claude を起動
④
自然言語でコミット・PR・イシュー対応を指示
⑤
CLAUDE.md でプロジェクト設定を共有
一度設定してしまえば、あとは日本語で指示するだけで GitHub の操作が完結します。コードを書く作業と並行してバージョン管理もAIに任せることで、開発のスピードが大きく上がります。ぜひ試してみてください。
