普段からghでGitHubを操作していて、クラウドのClaude Codeを使い始めたい人向け
普段からghでGitHubを操作している人が、ブラウザの設定画面を開かずにクラウドのClaude Codeへつなぎたい場面で叩く。具体的には、claude を起動した中で /web-setup と打つと、gh のログイン情報がClaudeアカウントに同期され、以後 claude --remote "…" でクラウド作業を投げられるようになる。/schedule で定期実行を組む前準備としても使う。
クラウドのClaude Codeにファイル一式を任せたいとき、最初の関門が「GitHubアカウントとつなぐ」工程です。普通はブラウザでclaude.ai/codeを開いて、Claude GitHub App を入れて、権限を許可して…という画面ぽちぽちが要ります。/web-setup は、その画面操作をまるごと飛ばして、手元の gh がすでに持っているログイン情報をそのままClaudeアカウントに渡すコマンドです。
つまり、ブラウザを一度も開かずに、黒い画面の中だけでクラウド連携を済ませてしまう。普段から gh を使っている人にとっては、これが一番速い入口です。
噛み砕くと
新しい職場の初日に、入館証を作る場面を思い浮かべてください。普通は受付で書類を書いて写真を撮って…と手続きが要ります。でも、すでに同じ系列ビルの入館証を持っているなら、それを見せれば「この人は確認済み」とすぐ通してもらえる。
/web-setup がやるのは、まさにこの「すでに持ってる入館証を見せる」動きです。gh がGitHubに対して持っているログイン情報（=入館証）を、クラウドのClaudeに「これで本人確認してね」と手渡す。だから受付（ブラウザの設定画面）に並ばずに済むわけです。
ここがこのコマンドのすべて、と言ってもいい。
大事な前提：これは黒い画面に直接打つコマンドではない
一番多いつまずきが、ここです。/web-setup は黒い画面に素で打つコマンドではありません。まず claude と打ってClaude Codeを起動し、その中の入力欄で /web-setup と打ちます。
黒い画面に直接打つと、公式の表現で Unknown command（そんなコマンド知りません）と返ってきます。最初これで詰まる人がかなりいます。
あと前提がもう2つ。gh がインストール済みでログイン済みであること。そしてClaude Codeにclaude.aiアカウントでサインインしていることです。gh が入っていなかったり未ログインだと、エラーにはならず代わりにブラウザの設定画面が開きます。
「料理ブログ」を例に、実際の手順を見る
料理ブログサイトの開発を、自分のパソコンを占有せずクラウドに任せたい。そういう前提で、ブラウザを一度も開かずに連携を済ませる流れを追います。プロジェクトは cooking-blog という名前でGitHub上にある状態とします。
ステップ1: ghでGitHubにログインしておく
まず黒い画面で、gh がGitHubにログイン済みか確認します。まだなら次を打ちます。
$ gh auth login対話で「GitHub.com / ブラウザで認証 / …」と聞かれるので、画面の案内どおり進めればOK。これで gh がログイン情報を握ってくれます。
ステップ2: Claude Codeを起動する
同じ黒い画面で claude と打ちます。
$ claudeこれでClaude Codeが立ち上がり、入力欄が出ます。ここからは「黒い画面」ではなく「Claude Codeの中」での操作になります。ここの切り替わりが地味に大事です。
ステップ3: サインインを確認する
Claude Codeの入力欄で、必要なら /login を打ってclaude.aiアカウントでサインインします。
/loginすでにサインイン済みなら、この手順はまるごと飛ばして大丈夫です。
ステップ4: /web-setup を打つ
いよいよ本命。Claude Codeの入力欄で打ちます。
/web-setupこれで gh が握っているログイン情報が、自分のClaudeアカウントに同期されます。ここで初心者がやりがちな勘違いを1つ。これを黒い画面に直接打つと Unknown command になります。必ず claude を起動した「中」で打ってください。
ステップ5: クラウド環境が自動で用意される
まだクラウド環境を1つも持っていない場合、/web-setup が既定の環境を1つ作ってくれます。公式によれば、その既定環境は「Trusted のネット接続範囲」で「セットアップスクリプト無し」の状態です。
ステップ6: 連携できたら、ターミナルからクラウドに投げられる
/web-setup が終わると、自分の黒い画面から --remote を付けてクラウド作業を投げられるようになります。料理ブログの例ならこんな具合です。
$ claude --remote "レシピ一覧ページに絞り込み機能を足して"あとはブラウザを開かなくても、クラウド側で作業が進みます。決まった時刻に走らせたいなら /schedule につなぐ流れもあります。
つまり /web-setup は何をしてくれるのか
- やってくれる: 手元の
ghのログイン情報をClaudeアカウントへ同期し、ブラウザを開かずにクラウドのGitHub連携を済ませる。環境が無ければ既定環境も1つ作る - やってくれない: Auto-fix（PRの自動見張り）はこれだけでは使えない。Auto-fixはClaude GitHub Appが別途必要で、後から該当プロジェクトにAppを入れる必要がある
- 意味が薄い場面: そもそも
ghを使っていない人。ghが無いと/web-setupはブラウザの設定画面に切り替わるので、最初からブラウザで連携するのと変わらない
使いどころ3シナリオ（具体題材で再現）
シナリオ1: 料理ブログの重い作業をクラウドに丸投げしたいとき
「全レシピページに構造化データを足す」みたいな、時間はかかるが手は離せる作業。自分のパソコンを占有したくない。普段から gh を使っているなら、/web-setup で一度つないでおけば、以後 claude --remote "..." で投げて放っておけます。ブラウザ設定の往復が消えるのが効きます。
シナリオ2: 家計簿アプリを毎晩クラウドで自動メンテしたいとき
「毎晩テストを回して、落ちてたら直す」を /schedule で組みたい。/schedule はGitHub連携が無いと、その場で /web-setup を案内してきます。先に /web-setup を通しておけば、定期実行の設定がそのまま進みます。gh ユーザーなら入口はこれ一択でいいと思います。
シナリオ3: 複数の作業を並行でクラウドに走らせたいとき
料理ブログの「絞り込み機能」「画像の遅延読み込み」「壊れたリンク修正」を同時に進めたい。--remote は1本ごとに別のクラウド作業を立てるので、3本投げれば3つ並行で動きます。その前提となるGitHub連携を、/web-setup で黒い画面のまま一発で済ませておく、という使い方です。
初心者が踏みやすい落とし穴
- 黒い画面に直接打って Unknown command。必ず
claudeを起動した「中」で/web-setupと打つ。これが一番多いミスです。 - これだけでAuto-fixも使えると思い込む。Auto-fix（PRの自動見張り）はClaude GitHub Appが必須で、
/web-setupだけでは有効になりません。後からAppを該当プロジェクトに入れる必要があります。 - 「つないだプロジェクトだけ」にアクセスが限られると思い込む。実際は、つないだGitHubアカウントが見えるすべてのプロジェクトにクラウド作業が届きます。範囲を絞りたいならGitHub側で見える範囲を絞ります。
- ghが無い環境で打つとエラーになると思い込む。エラーにはならず、代わりにブラウザの設定画面が開きます。気づかず「効いてない」と勘違いしやすい。
- ZDR組織で使おうとする。Zero Data Retention（保存しない設定）が有効な組織では、
/web-setupもクラウド作業も使えません。 - 古いバージョンや別ログインで Unknown command。中で打ってもエラーが出るなら、Claude Codeがv2.1.80より古いか、claude.aiのサブスクではなく別方式でログインしている場合があります。
claude updateのあと/loginでclaude.aiアカウントに入り直します。 - 「環境が作れない」エラーを放置する。
Could not create a cloud environmentが出たら自動作成に失敗しています。Claude Codeの中で/web-setupを打ち直して手動で作るか、claude.ai/codeから作ります。 - 管理者がオフにしている可能性。Team・Enterpriseでは管理者が「Quick web setup」のスイッチで
/web-setupを無効化できます。会社環境で使えないときはここを疑います。
書き方
/web-setupやってみるとこうなる
入力
/web-setup出力例
（claude を起動した中で打つと）ghのログイン情報がClaudeアカウントに同期される。クラウド環境が無ければ、Trustedのネット接続範囲・準備処理なしの既定環境が1つ作られる。完了後は黒い画面から claude --remote "レシピ一覧に絞り込み機能を足して" のようにクラウド作業を投げられる。黒い画面に直接打つと Unknown command と返る。このページに出てきた言葉
- gh
- GitHubを黒い画面（文字でコマンドを打つ画面）から操作する公式ツール。<code>gh auth login</code> で一度ログインすると、以後その本人確認情報を握っていてくれる
- クラウドのClaude Code
- 自分のパソコンではなくAnthropic側のサーバーでClaudeに作業させる仕組み。正式名はClaude Code on the web、claude.ai/codeで動く
- Claude GitHub App
- ClaudeにGitHubのプロジェクトへの出入りを許可する連携アプリ。ブラウザでつなぐ場合に入れる。Auto-fix（PRの自動見張り）はこれが必須
- --remote
- 黒い画面で <code>claude</code> の後ろに付ける指定。今いるプロジェクトを材料に、新しいクラウド作業を1つ立ち上げる
- Trusted
- クラウド環境のネット接続範囲の既定値。npmやPyPIなど主要な配布元への接続は許し、それ以外は塞ぐ安全寄りの設定
- ZDR組織
- Zero Data Retention（やり取りを保存しない設定）が有効な組織。この場合 <code>/web-setup</code> もクラウド作業も使えない
関連項目
公式ドキュメント
https://code.claude.com/docs/en/web-quickstart#connect-from-your-terminal