github-integration

GitHub 連携

Claude Code クラウドおよび GitHub Copilot コーディングエージェントの環境で gh CLI を使えるようにし、エージェントが PR の作成、Issue の管理、GitHub API とのやり取りを行えるようにします。

このスキルを使用するタイミング

次の場合に有効化します。

• クラウド AI エージェントに gh（PR、Issue、リリース、API 呼び出し）を使わせたい
• Claude Code のクラウドセッションに gh をインストールしたい
• GitHub Copilot エージェント用に copilot-setup-steps.yml を追加したい
• クラウドセッションで gh コマンドが認証エラーや「見つからない」エラーで失敗する
• クラウドベースの AI コーディングエージェントで GitHub 連携を有効にしたい

判断ツリー

Which cloud environment?

Claude Code cloud (claude.ai/code)?
  → gh is NOT pre-installed in the default image
  → Install via setup script: apt update && apt install -y gh
  → Set GH_TOKEN as environment variable in environment settings
  → For repo-portable setup, use SessionStart hook instead
  → Use -R owner/repo flag with gh due to sandbox proxy

GitHub Copilot coding agent?
  → Add .github/copilot-setup-steps.yml to the repo
  → gh IS pre-installed; just configure GH_TOKEN
  → Commit and push — agent sessions pick it up automatically

gh commands failing?
  → "command not found" → gh not installed; add to setup script
  → HTTP 401 → GH_TOKEN not set; add to environment variables
  → HTTP 403 → Token lacks required scope; check permissions
  → "could not determine repo" → Use -R owner/repo flag
  → See references/cloud-auth.md for more

Need gh in local dev too?
  → Run: gh auth login (interactive, browser-based)
  → Or set GH_TOKEN env var for headless/CI use

2 つの環境、2 つの方法

Claude Code Cloud（claude.ai/code）

Claude Code Cloud は、Anthropic が管理する VM でセッションを実行します。gh CLI はプリインストールされていません。次の 2 つが必要です。

1. セットアップスクリプト — セッション開始時に gh をインストールします
2. GH_TOKEN 環境変数 — GitHub PAT を使って gh を認証します

クイックスタート：セットアップスクリプト

Claude Code の Web UI で、環境設定 → セットアップスクリプトを開きます。

#!/bin/bash
apt update && apt install -y gh

次に、GitHub Personal Access Token（repo スコープが必要）を使って、環境変数として GH_TOKEN を追加します。

代替方法：SessionStart フック（リポジトリ間で利用可能）

リポジトリの .claude/settings.json に追加します。

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "if [ \"$CLAUDE_CODE_REMOTE\" = \"true\" ]; then apt update && apt install -y gh; fi",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

CLAUDE_CODE_REMOTE のチェックにより、クラウドセッションでのみ実行されます。

重要：-R フラグ

サンドボックスプロキシのため、gh がリポジトリを自動検出できない場合があります。-R owner/repo フラグを使用してください。

gh pr create -R codervisor/myrepo --title "..." --body "..."
gh issue list -R codervisor/myrepo

GitHub Copilot コーディングエージェント

Copilot コーディングエージェントは .github/copilot-setup-steps.yml を使用します。gh CLI はプリインストールされているため、認証するだけで使えます。

.github/copilot-setup-steps.yml に次のファイルを追加します。

name: "Copilot Setup Steps"

on: repository_dispatch

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Authenticate gh CLI
        run: gh auth status
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

依存関係のインストールを含む完全なテンプレートについては、templates/copilot-setup-steps.yml を参照してください。

セットアップスクリプト、SessionStart フック、copilot-setup-steps の比較

	セットアップスクリプト	SessionStart フック	copilot-setup-steps.yml
プラットフォーム	Claude Code クラウドのみ	Claude Code（ローカル＋クラウド）	GitHub Copilot エージェントのみ
設定場所	環境設定 UI	リポジトリ内の .claude/settings.json	.github/copilot-setup-steps.yml
実行タイミング	Claude の起動前	Claude の起動後	Copilot エージェントの起動前
再開時の実行	いいえ（新しいセッションのみ）	はい（毎セッション）	はい
ネットワーク	レジストリへのアクセスが必要	レジストリへのアクセスが必要	GitHub Actions ネットワークを全面利用可能

エージェント向けの一般的な gh コマンド

# PRs (use -R in Claude Code cloud)
gh pr create -R owner/repo --title "..." --body "..."
gh pr list -R owner/repo
gh pr view -R owner/repo
gh pr merge -R owner/repo --squash --delete-branch

# Issues
gh issue list -R owner/repo
gh issue view 42 -R owner/repo
gh issue create -R owner/repo --title "..." --body "..."

# API (for anything not covered by subcommands)
gh api repos/owner/repo/actions/runs

注意点

症状	原因	解決方法
gh: command not found	インストールされていない（Claude Code クラウド）	セットアップスクリプトに apt install -y gh を追加する
HTTP 401 / 認証エラー	GH_TOKEN が設定されていない	設定 UI で環境変数に追加する
push 時の HTTP 403	トークンに repo スコープがない	repo スコープを付けて PAT を再生成する
could not determine repo	サンドボックスプロキシが git のリモートを隠している	-R owner/repo フラグを使用する
gh pr create が失敗する	アップストリームブランチがない	先に git push -u origin <branch> で push する
セットアップスクリプトが失敗する	ネットワークにアクセスできない	ネットワークを「Limited」（デフォルト）または「Full」に設定する

参考資料

• references/cloud-auth.md — トークン認証、スコープ、プロキシの詳細、トラブルシューティング
• references/copilot-setup-steps.md — Copilot セットアップワークフローをカスタマイズするための完全ガイド

セットアップと有効化

npx skills add -g onsager-ai/dev-skills --skill github-integration -a claude-code -y

次の場合に自動的に有効化されます。ユーザーが「gh in cloud」、「github integration」、「setup script」、「copilot setup steps」に言及した場合、またはクラウド環境で gh の認証に失敗した場合。