メインコンテンツへスキップ
見出し画像

AIエージェント専用GitHubアカウントの作り方と権限設定

    結論:Claude Code や Codex などのAIエージェントには、自分のメインのGitHubアカウントではなく「エージェント専用アカウント」を使わせ、触れるリポジトリと権限を絞り、マージだけは自分のアカウントで行うのが基本形です。

    個人リポジトリに招待する形だと、権限を細かく絞れるトークン(fine-grained トークン)が使えないという落とし穴があるため、無料のOrganizationにリポジトリを置くと設定しやすくなります。

    GitHubの規約では、無料の専用アカウント(マシンアカウント)は1人1つまでです。

    はじめに:なぜ今この設定なのか

    11月2日(日本時間)、X で「AIエージェントには権限を絞った別のGitHubアカウントを渡し、PRを作らせて、レビューとマージは自分のアカウントで」という英語の投稿が広まりました(11月4日朝時点で表示35万回超)。

    背景には、エージェントがPRを出すのが当たり前になったことがあります。GitHub(Microsoft傘下)が10月29日(日本時間)に公開した Octoverse 2026 によると、2026年9月はPRの40%超(1億1,000万件)がエージェントの下書きから始まりました(3月は17%)。

    この記事では、専用アカウントの作り方と、つまずきやすい権限まわりを整理します。筆者は以下の手順を実際に試してはいません。2026年11月4日朝(日本時間)時点のGitHub公式ドキュメントと規約に基づく内容で、「筆者の提案」と書いた部分は公式の推奨ではありません。

    専用アカウントで何が守れるのか

    メインのアカウントには、全リポジトリへの書き込みや削除、設定変更といった強い権限がまとまっています。エージェントがそのまま使えば、誤操作やプロンプトインジェクション(外部の文章にまぎれた悪意ある指示)の被害も同じ範囲に広がります。OWASPも、AIに必要以上の権限を持たせることを「Excessive Agency」というリスクに挙げ、権限の最小化と人による承認を勧めています。

    専用アカウントにすると、次の3つが得られます。

    • 被害の範囲を限定できる:触れるのは招待したリポジトリだけ

    • 履歴で見分けられる:どのPRやコミットがエージェントのものか一目でわかる

    • 自分が承認役になれる:GitHubでは「PRの作成者は自分のPRを承認できない」ため、エージェントのPRを自分が承認する分担が成り立つ

    手順1:規約に沿ってアカウントを作る

    GitHubの利用規約では、bot が自動で作ったアカウントは禁止ですが、「マシンアカウント」は認められています。条件は次のとおりです。

    • 人間が作成し、規約に同意し、有効なメールアドレスを登録する

    • 自動化の作業だけに使う

    • 動作の責任は作った本人が負う

    • 無料のマシンアカウントは、無料の個人アカウントとは別に 1つまで

    「エージェントごとに無料アカウントを作る」のは規約に合わないので、1つの専用アカウントを複数のエージェントで共用するのが現実的です。

    手順2:リポジトリの置き場所を決める(最大のつまずきポイント)

    個人リポジトリに専用アカウントを「コラボレーター」として招待するのが一番簡単に見えますが、公式ドキュメント上は次の制約があります。

    • 個人リポジトリの権限は「オーナー」と「コラボレーター」の2段階だけ。プライベートリポジトリでは、コラボレーターに読み取り専用は付けられず、書き込み権限になる

    • fine-grained トークンは、コラボレーターとして参加しているリポジトリへの書き込みに使えない(GitHubが「今後解消する」としている既知の制限)

    そのため個人リポジトリでは旧来の「classic トークン」を使うことになります。classic トークンはそのアカウントが触れる全リポジトリに効くので、招待先を最小限にすることが前提です。

    権限をリポジトリ単位で絞りたいなら、無料のOrganizationを作ってリポジトリを移し、専用アカウントをメンバーにする方法が向いています。公式ドキュメントも、細かい権限が必要なら Organization への移管を勧めています。

    手順3:トークンは最小限で作る

    Organization に置いた場合、専用アカウントで fine-grained トークンを作ります。

    • Resource owner:そのOrganizationを選ぶ

    • Repository access:「Only select repositories」で対象だけを選ぶ

    • Permissions:PRを作らせるだけなら、Contents と Pull requests の読み書きが中心。Metadata の読み取りは自動で付く

    • 付けない権限:Administration(設定変更)、Secrets、Workflows(GitHub Actions のワークフローを書き換える権限)など

    • 有効期限:無期限は避ける。GitHubも期限の設定を強く勧めている

    Organization のオーナーは、トークンを承認制にもできます。なお、長く動かす連携には GitHub App を使うよう公式ドキュメントは案内しています。

    手順4:main ブランチを守る

    最後に、エージェントのPRが自分の確認なしに入らないようにします。ブランチ保護ルール(またはルールセット)で、次を設定します。

    • main へのマージにPRを必須にし、承認を1件以上求める

    • 「Do not allow bypassing the above settings」を有効にする(初期設定では管理者は制限の対象外)

    注意:ブランチ保護とルールセットは、無料プランでは公開リポジトリだけで使えます。プライベートで使うには、個人なら GitHub Pro、Organization なら GitHub Team 以上が必要です。無料のプライベートリポジトリでは仕組みで止められないので、エージェントへの指示(AGENTS.md など)とPRの確認を習慣にしてください。

    手順5:手元でアカウントを分ける

    GitHub CLI(gh)は1台で複数のアカウントにログインでき、gh auth status で一覧を確認し、gh auth switch で切り替えられます。

    筆者の提案としては、切り替えに頼るより、エージェントを動かす環境(別のOSユーザーや開発用コンテナ)には専用アカウントのトークンだけを置き、メインの認証情報を置かない形がより安全です。コミットの作成者名も git config で専用アカウントのものにしておくと、履歴で区別しやすくなります。

    指示書の置き方は前回の「AGENTS.mdとCLAUDE.md、AI併用時の置き方」、拡張機能の入れ方は「その拡張は本物か:Cursorの改ざん版Claude Code拡張事件と、AI拡張の入れ方」で整理しています。

    まとめ:今日やること

    • 専用アカウント(マシンアカウント)を1つ作る

    • 権限を絞りたいリポジトリは無料のOrganizationに置き、fine-grained トークンを対象リポジトリだけ・期限付きで作る

    • 公開リポジトリなら、main にブランチ保護(PR必須・承認1件・バイパス禁止)を付ける

    • エージェントのPRは、自分のアカウントでレビューしてからマージする

    仕様や規約は更新されるため、設定前に公式ドキュメントで最新の内容を確認してください。

    参考リンク

     
     
    Claude Code・Codex・GeminiなどのAIエージェントを、開発の実務でどう使うかを書いています。設定手順、ツールの比較、ハマりどころを毎朝更新。エンジニアの仕事と働き方の話もときどき。

    あなたへのおすすめ