Claude Code のクラウドセッションは、GitHub の1つのリポジトリだけを触らせ、本番のサーバーにはそのリポジトリを「取りに行かせる」だけにすれば、本番への入口を増やさずに開発を任せられます。ただし、始めるまでにつまずきやすい点が5つあります。この記事は、筆者(このサイトの運営者)が2026年10月4日に別の開発プロジェクトで使い始めたときの記録を、公式ドキュメントの原文で確かめ直したものです。

クラウドが触る範囲

GitHub の1リポジトリだけ

Claude の GitHub App は「Only select repositories」で、今回のリポジトリだけに入れる。

本番のサーバー

取りに行くだけ

読み取り専用の鍵で本番から取得する。クラウドにも GitHub にも本番の鍵を渡さない。

クラウドの環境

プロジェクトごとに新しく

環境変数はその環境を使う人なら誰でも読める。秘密の値を入れない。

出典:Use Claude Code in the cloud、Configure cloud environments。2026年10月4日確認。仕組み・始め方・料金の全体像は「Claude Codeのクラウドセッションとは」へ。

1. 本番を守る構成——本番は「取りに行くだけ」

GitHub を経由すると本番のサーバーへの入口が増えるのでは、というのが一番の心配でした。筆者は次の構成にしました(公式の推奨ではなく、筆者が選んだ形です)。矢印は、データを取りに行く向きです。

  • クラウドセッションコードを書き、ブランチを push する(本番には入れない)
  • →push
  • GitHub の非公開リポジトリApp を入れたのはこの1つだけ
  • ←取得
  • 本番のサーバー読み取り専用の Deploy key で取りに行き、デプロイは人が実行する
鍵本番に、そのリポジトリ専用の読み取り専用の鍵(Deploy key)を置く。GitHub の公式ドキュメントによると、Deploy key は1つのリポジトリにだけアクセスでき、既定で読み取り専用。
やらないことGitHub Actions に本番の鍵を渡して自動デプロイ、はしない。本番に入れる経路が1本増えるため。
デプロイ人が手で実行する。本番の側のスクリプトが最新のコードを取り込み、ビルドして入れ替える。失敗したら、動いている版はそのまま残る。

筆者は最初、別のリポジトリ用の鍵を使い回そうとして、GitHub に「Key is already in use(その鍵はもう使われている)」と断られました。GitHub のドキュメントによると、鍵が別のアカウントやリポジトリにすでに登録されていると出る表示です。リポジトリごとに鍵を分けるので、1本が漏れても読まれるのはそのリポジトリだけで済みます。

2. GitHub なしで始めると何が送られるか

筆者はふだん、コードを自分のサーバーの git リポジトリで管理しているので、最初は GitHub なしで使うことを考えました。公式ドキュメントによると、リモートの無いリポジトリなどで claude --cloud "作業内容" を実行すると、手元のリポジトリを1つにまとめて(バンドルして)クラウドへ送ります。送られるものは次のとおりです。

履歴すべてのブランチの履歴。昔コミットして消したファイルも、履歴の中に残っていれば送られる。
未コミットの変更git で管理しているファイルの、まだコミットしていない変更。
送られないものgit で管理していないファイル(必要なら git add する)。

macOS・Linux・WSL

秘密らしい名前は残す

.env・*.tfvars・id_rsa・*.pem のような名前のファイルは、未コミットの変更を送らずに手元に残す。

Windows(WSL でない)

名前に関係なく送る

git で管理しているファイルの未コミットの変更は、そのまま送られる。送りたくない変更は、始める前に退避するか元に戻す。

危ないのは、秘密の値を含むファイルを git で管理していて書き換えている場合と、過去に秘密の値をコミットしたことがある場合です。.gitignore で外した .env は、そもそも送られません。

もう1つ、バンドルから作ったセッションが push できるのは、公式ドキュメントによると「GitHub の連携に push の権限があるリポジトリ」だけです。GitHub 以外の自前のリポジトリへ結果を直接戻す方法は、ドキュメントからは読み取れませんでした。筆者は手順書まで書いたところで、素直に GitHub に非公開リポジトリを作りました。

3. 実際に詰まった5つの点

GitHub に非公開リポジトリを作ってから、実際に始めるまでに詰まった点を、症状・原因・対処の順に並べます。

① リポジトリが一覧に出ない

症状作ったはずのリポジトリが一覧に無い。出てくるのは、以前に試しで作った別のアカウントのテスト用リポジトリだけ。
原因claude.ai につながっている GitHub アカウントが、ふだん使うものと違っていた。以前に別のアカウントで連携したまま忘れていた。
対処claude.ai/customize/connectors で GitHub の連携を切断し、ブラウザで正しいアカウントにログインし直してから連携をやり直した。切断するとクラウドセッションが使う GitHub の認証情報が消える、と公式ドキュメントにある。

② GitHub App をどこまで入れるか

症状連携の途中で、Claude の GitHub App を入れる範囲を聞かれる。「All repositories」を選ぶと、そのアカウントや組織のすべてのリポジトリに入る。
原因筆者のアカウントは取引先の案件の組織にも所属していて、そこまで Claude に触らせたくなかった。
対処インストール先は自社の組織だけにし、「Only select repositories」で今回のリポジトリ1つだけを選んだ。組織によっては、インストールに組織のオーナーの承認が要る。

GitHub から『Claude is requesting updated permissions』というメールが届いたときの見分け方と、承認すべきかの判断は「Claude is requesting updated permissions とは——GitHub のメールは本物か・承認すべきか」にまとめました。

③ App を入れていない組織のリポジトリが一覧に出る

症状範囲を絞ったのに、別の組織のリポジトリがいくつか一覧に出てきた。
原因どれも公開リポジトリだった。公式ドキュメントの表では、GitHub App で連携した場合に使えるのは「すべての公開リポジトリと、App を入れた非公開リポジトリ」。
対処対処は不要。公開リポジトリはもともと誰でも読めるので、新しく漏れるものは無い。非公開リポジトリは App を入れたものしか使えない。

④ 以前のクラウドの「環境」が残っていた

症状クラウドの「環境」(ネットワークの許可範囲・環境変数・セットアップスクリプトを持つ保存された設定)に、別のプロジェクトで作ったものが残っていた。
原因公式ドキュメントによると、環境を使う人なら誰でも、その環境変数とセットアップスクリプトを読める。使い回すと、当時の値が新しいプロジェクトからも見える。
対処プロジェクトごとに新しい環境を作り、環境変数には何も入れなかった。ネットワークは既定の「Trusted」のまま。API の鍵が要るなら、環境変数でなくネットワークシークレット(「Network secrets」)に登録する。Anthropic の中継が指定したホスト宛ての通信にだけ鍵を付け、セッションは鍵の中身を読めない(Pro・Max・Ultra・Team・Enterprise。Anthropic が用意する環境だけで、保存した値は後から見られない。2026年11月7日に公式ドキュメントで確認)。

⑤ 手元のファイルを読ませようとした

症状最初の指示に「手元のフォルダにある手順書を読んで」と書こうとした。
原因クラウドのセッションからは手元の PC のファイルは見えない。公式ドキュメントの比較表でも、クラウドセッションは手元の設定を使わず、使うのは「リポジトリだけ」。
対処プロジェクトのルール・安全のために守ること・本番の約束を、すべて最初のメッセージに書き、仕様書は添付した。くり返し使うルールは、リポジトリの CLAUDE.md に書いてコミットしておくと、毎回書かずに済む。

4. クラウドの権限モードの違い

送る直前、権限モードが「Accept edits」になっていました。名前からすると一番どんどん進みそうですが、公式ドキュメントによると、クラウドの Accept edits は手元の Claude Code でいう通常のモード(Manual)に当たります。クラウドではファイルの編集がどのモードでも先に許可されているので、通常のモードがこの名前で表示されているだけです。

Accept edits

コマンドで止まる

ファイルの編集は自動で通る。npm install・ビルド・git push などのコマンドは、そのたびに承認を待つ。

Plan

まず計画を立てる

変更する前に、何をするかの計画を作って見せる。

Auto

任せて進める

承認を求める代わりに、分類器(安全の判定の仕組み)が操作を確かめて進める。組織が許可し、選んだモデルが対応しているときだけ出る。

放っておいても進んでほしかったので、筆者は Auto に切り替えました。なお、クラウドではすべての確認を飛ばすモード(bypass permissions)は選べず、リポジトリの設定ファイルに書いてあっても無視されます。各モードの詳しい違いは「Claude Code の権限モード」にまとめています。

5. 実際にかかったクレジット——1回の指示で $226

ここまでの設定を済ませ、Max プランの期間限定のクレジット($250)でクラウドセッションを走らせました。最初のメッセージで設計図と指示を渡し、権限モードは Auto。その後は一度も会話していません。途中で使用量の画面を見て減り方に驚き、「止めて」と指示して止めました。止めた時点で、クレジットは残り $24 でした。止めなければ、そのまま $250 を使い切るところでした。

$226

使ったクレジット($250 中・残り $24)

676.7k

止めた時点のコンテキスト(1M 中 68%)

出典:筆者の Claude Code の使用量の画面(2026年10月4日・Max 20x プラン。10月31日から Ultra)。

1回の指示で、クラウドは止めるまでに次の量の作業をしていました(筆者の作業記録より)。

土台Web アプリの製品基盤一式(デザイン・日英の切り替え・問い合わせ・エラー通知・サイトマップ・オフライン対応など)。
機能ブラウザの中で動くツール41個(テキスト・画像・PDF・表計算など)。
テスト単体テスト695件と、画面を動かすテスト142件。すべて通過。
その他Docker のビルドの確認、CI の設定、本番に関わる不具合3件の修正、引き継ぎの文書。

なぜ一気に減るのか

費用は「こちらが話しかけた回数」ではなく、Claude がモデルを呼び出した回数と、そのたびに読む文脈の量で決まります。自律で動くと、ファイルを読む・書く・テストを走らせるたびに呼び出しが起き、会話しなくても数百〜数千回になります。公式ドキュメント(Manage costs effectively)も「費用は文脈の大きさに比例する」と書いています。

呼び出しのたびに、それまでの文脈を読み直します。キャッシュが効いても読み取りは無料ではなく、たとえば Opus 5.5 の読み取りの単価(100万トークンあたり $0.20)なら、50万トークンを1回読むだけで約 $0.10 です。これが1,000回続けば約 $100 になります(筆者が単価から計算した例です)。書いたコードやテストは、出力の単価で別に数えられます。

筆者が公式ドキュメントを探した範囲では、クレジットの使用額に上限を設ける設定は見当たりませんでした(--max-budget-usd は対話しない実行のときだけ、月の使用額の上限は従量課金の usage credits 向け)。止めどころは、指示に書くか、自分で止めるしかありません。また、クレジットを使い切った後のクラウドは、手元と同じくプランの週の枠で動きます。週の枠が残り少ないときに同じ規模を走らせると、手元の Claude Code も含めて上限に当たります。

内訳を見ると:読み直しと、サブエージェント

止めた後、使用量の画面の「詳細な内訳を見る」を開きました(止めた後にまとめを書かせた分まで含む、セッション全体の値です)。

8時間33分

モデルが動いた時間(筆者が操作したのは2分24秒)

99%

Opus の割合(Sonnet は1%)

63%

サブエージェントの分(general-purpose 34%・Agent 29%)

出典:筆者の Claude Code の使用量の画面「このセッション」(2026年10月4日)。表示されたコストは $231.09。

キャッシュの読み取り2億4,250万トークン。それまでの会話の読み直しで、トークンのほとんどを占める。キャッシュの当たりは99%。
キャッシュの書き込み140万トークン。
画面のヒント各サブエージェントは独自のリクエストを実行する。シンプルなサブエージェントには低コストのモデルを検討するか、プロンプトを絞り込む。

筆者が操作したのは2分24秒だけで、残りの8時間あまりは Claude が自分で動いていました。その間ずっと、Opus のメインの会話と、同じく Opus で動くサブエージェントが、長くなった会話を何度も読み直していたことになります。

なお、画面に表示されたコスト($231.09)は、この画面を開いた時点のクレジットの減り($250 → $18=$232)とほぼ同じでした。止めた時点の残りは $24 で、この画面を開いたのはその後なので、残りがさらに減っています。公式ドキュメントによると、この画面のコストはトークンの数に定価をかけた見積もりです。そのため、クレジットは API の定価で引かれていると見てよさそうです(公式の明記はありません)。

サブエージェントのモデルは、指定しないとメインの会話と同じモデルになります(公式ドキュメント「Create custom subagents」)。メインを Opus にしていると、量産の作業まで Opus で走ることになります。

減らすための工夫(効果が大きい順)

  • 1. サブエージェントは Sonnet指示に「サブエージェントは model: sonnet で動かして」と書く。環境変数 CLAUDE_CODE_SUBAGENT_MODEL で既定を変える方法もある(秘密の値ではないので環境に入れてよい)。
  • 2. 会話を短く保つ(/compact か新しいセッション)会話が短いほど1回の操作が安い。同じテーマを続けるなら /compact で要約すれば、セッションを替えずに短くできる(「テストの結果を残して」のように残すものを指定できる)。テーマが変わるとき、長く手を止めた後に再開するときは、新しいセッションにする。進み具合を引き継ぎの文書に書かせておけば、区切っても失われない。
  • 3. 止めどころを最初に伝える「土台ができたら止めて報告」「$50 くらいで一度止めて報告」のように書く(使用額の上限の設定は無いので、指示で区切る)。
  • 4. 統合の作業も任せるテスト・コミット・push までサブエージェントに任せ、長くて高いメインの会話での作業を減らす。
  • 5. 確認を軽くする画面のテストは作ったツールの分だけ、全体のテストは取り込む前に1回。スクリーンショットはツールごとに PC 幅とスマホ幅の1回ずつ。
  • 6. 要らない作業はすぐ止める途中で止めたサブエージェントの成果は残らず、使った分も戻らない。

並列の数は、2〜3体が目安です。クラウドのセッションの見立てでは、並列を減らしても時間が延びるだけで、合計の費用はあまり変わりません。効くのは並列の数より、それぞれの会話を短く、指示を具体的にすることです。

/compact と新しいセッションの使い分けは、公式ドキュメントの説明から次のように考えられます。/compact は要約を作るために会話全体を読み直しますが、キャッシュが残っているうちなら読み直しの多くがキャッシュから読まれるため、会話の大きさから想像するほど高くはなりません(「Prompt caching」)。長く放置してキャッシュが切れた後は、全体をキャッシュなしで読み直すので高くつきます。一方、新しいセッションは費用がかからない代わりに、それまでの流れを持ち越しません(「Manage costs effectively」)。要約は細部を落とすことがあるので、残したいことは先に文書へ書かせておくと安心です。なお、クラウドのセッションでは /compact は使えますが /clear は使えず、新しいセッションはサイドバーから始めます(「Claude Code on the web」)。

次のセッションの最初に貼る文は、たとえば次のようにしています(プロジェクト名は伏せています)。

続きから再開してください。
CLAUDE.md → docs/HANDOFF.md → docs/TODO.md を読んでルールに従うこと。
今回のテーマ: ◯◯
サブエージェントは model: sonnet、並列は 2〜3 体まで。
予算 $◯◯ で一度止めて報告。報告は日本語で。

クラウドセッションの文脈の要約は、環境変数 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE をクラウドの側が自分で設定するため、環境にこの変数を入れても効きません。要約を早めたいときは、公式ドキュメントが案内する CLAUDE_CODE_AUTO_COMPACT_WINDOW か /autocompact を使います。

6. 始める前のチェックリスト

  • GitHub アカウントclaude.ai につながっているのは、使いたいアカウントか。
  • App の範囲「Only select repositories」で、必要なリポジトリだけに入れたか。
  • 履歴過去にコミットした秘密の値が、リポジトリの履歴に残っていないか。
  • 環境このプロジェクト用に新しく作ったか。環境変数に秘密の値を入れていないか。
  • 本番クラウドや GitHub から本番に入れる経路を作っていないか(本番から取りに行く形か)。
  • ルールくり返し使うルールは、リポジトリの CLAUDE.md に入れたか。
  • 権限モード任せるなら Auto、1つずつ確かめるなら Accept edits を選んだか。

まとめ

本番を守ってクラウドセッションを使う形は、クラウドは GitHub の1つのリポジトリだけを触り、本番はそれを読み取り専用の鍵で取りに行き、デプロイは人が実行する、の3点に尽きます。GitHub なしでも始められますが、リポジトリはすべてのブランチの履歴ごと送られ、Windows では管理下のファイルの未コミットの変更も名前に関係なく送られます。

実際に詰まったのは、別の GitHub アカウントにつながっていたこと、App の範囲、残っていた古い環境、手元のファイルが見えないこと、そして「Accept edits」がコマンドのたびに止まることでした。どれも始める前のチェックリストで防げます。

費用の面では、1回の指示で自律に走らせたところ、途中で「止めて」と指示して止めるまでに期間限定のクレジット $226 を使いました。費用は会話の回数でなく、呼び出しの回数と文脈の長さで決まります。内訳では、会話の読み直しと、メインと同じモデルで走ったサブエージェントが大半でした。サブエージェントを Sonnet にし、会話を /compact や新しいセッションで短く保ち、止めどころを指示に書くのが大事です。

FAQ

Q. GitHub を使わずにクラウドセッションを試せますか?

A. 試せます。claude --cloud "作業内容" で手元のリポジトリをまとめて送れます。100MB 未満で、コミットが1つ以上あることが条件です。すべてのブランチの履歴が送られ、結果を GitHub 以外のリポジトリへ直接戻す方法は公式ドキュメントにありません。

Q. 一覧に、App を入れていない組織のリポジトリが出てきます。漏れていますか?

A. 公開リポジトリなら心配ありません。GitHub App で連携すると、クラウドセッションはすべての公開リポジトリを使えるので候補に出ます。非公開リポジトリは、App を入れたものしか使えません。

Q. 環境変数に API キーを入れても大丈夫ですか?

A. おすすめしません。公式ドキュメントは、環境を使う人なら誰でも環境変数を読めるとして、秘密の値を入れないよう警告しています。代わりに、セッションが中身を読めないネットワークシークレット(「Network secrets」)に登録する方法があります。Anthropic の中継が、登録時に指定したホスト宛ての通信にだけ鍵を付けます。Pro・Max・Ultra・Team・Enterprise で使えますが、Anthropic が用意する環境だけが対象で、保存した値は後から見られません(2026年11月7日に公式ドキュメントで確認)。

Q. 「Accept edits」にしたのに、コマンドのたびに止まります。

A. 仕様です。クラウドでは編集がどのモードでも許可されているため、通常のモードが「Accept edits」という名前で出ています。コマンドを承認なしで進めたいなら Auto を選びます(組織が許可し、モデルが対応しているときだけ表示されます)。

Q. 会話していないのに、なぜクレジットが大きく減るのですか?

A. 費用はこちらの発言の回数ではなく、Claude がモデルを呼び出した回数と、そのたびに読む文脈の量で決まるからです。自律で動くと、ファイルの読み書きやテストのたびに呼び出しが起き、文脈も長くなります。筆者の例では、1回の指示から途中で止めるまでに $226 を使いました(5章)。

Q. 期間限定のクレジットは、この使い方にも使えますか?

A. 期間中は使えましたが、このクレジットは米国太平洋時間の11月4日の終わり(日本時間11月5日16時59分)に失効したので、今は使えません。Pro・Max 向けのクレジット(Pro $100・Max $250)はクラウドセッションの利用に自動で使われ、残っている間はプランの利用上限に数えられない仕組みでした。受け取りは米国太平洋時間の10月7日までで、Projects・Routines・Remote Control などには使えませんでした。詳しくは公式のサポート記事と「Claude Codeのクラウドセッションとは」を参照してください。

出典

公式の仕様は2026年10月4日に原文を確認しました(ネットワークシークレットの部分は11月7日に確認)。設定の記録は筆者の1回・1つのプロジェクトでのもので、画面の表示は版や時期によって変わることがあります。