AI時代の開発環境・インフラ構築ガイド【初心者向け2026年版】

「AIに直接いじらせるなら管理画面は要らないのでは」という問いに、一般論では答えが出ない。同じ「管理画面」という言葉が性質の違う機能の寄せ集めを指しているからだ。この記事は、実際にこのサイトの管理画面を全廃した経験をもとに、立てるべき問いを「その画面はCLIやAIでは提供できていない何かを提供しているか」に置き換える。全廃してみて分かったのは、消した機能の多くが「使っていなかった」のではなく「構造的に機能していなかった」ということだった。記事のCRUDは、データの正がコード側にあるためデプロイのたびに上書きされ、画面から編集しても次のデプロイで消える設計だった。コメント承認キューは投稿時に承認済みとする実装のため、未承認コメントが生まれず常に空だった。使われない機能は、壊れていることすら気づかれない。一方で消せなかったのはコメント削除だが、これも管理画面である必然性はなく、記事ページ本体に削除ボタンを置くほうが優れていた——問題のコメントを読んでいるその場で消せるからだ。判断は6つの問いに落ちる。誰が操作するか（非技術者や交代のある担当者ならUI、開発者本人ならCLI）、取り消せるか（不可逆ならゲートが要る）、人間の判断が要るか（承認という状態遷移があるか）、権限を分ける必要があるか、何ができるか知っているか（一覧が仕様書を兼ねる）、証跡は残るか。とくに権限と証跡は個人開発では不要に見えて、人が増えた瞬間に最初に必要になる。またコード経由の変更はgitに残るが、AIにDBを直接触らせると標準では何も残らず、会話ログは「何を頼んだか」であって「何が起きたか」ではない。6軸のうち可逆性だけは重みが違う。2025年7月18日、ReplitのAIエージェントがコードフリーズ中にSaaStrの本番データベースを削除し、4,000件の架空ユーザーを生成し、ロールバック不可能と誤って主張して復旧を遅らせた事例（AI Incident Database #1152）が示すのは、AIの危険性というより不可逆な操作が人間のゲートを通らずに到達可能だった設計の問題である。記事はさらに、AI経由へ寄せる前に整えるべき3つの備え（変更が形として残ること、不可逆操作の手前の段差、手順の文書化）と、作る前のチェックリスト、そしてRetoolやForest Adminのような内製ツール製品という第三の選択肢まで扱う。

Claude Code の agent view（claude agents で開く）は、独立したバックグラウンドセッションを次々と起こし、1つの画面で管理するための機能だ。公式ドキュメントはその操作を「ディスパッチ（dispatch）」と呼ぶ——デスクトップアプリのサイドバーにある同名の別機能「ディスパッチ（Dispatch）」とは別物なので注意してほしい。公式ドキュメントは agent view を「1つの画面から多数のClaude Codeセッションをディスパッチし、管理する」機能と説明している（リサーチプレビュー・v2.1.139以降）。この記事は仕組みと安全性に絞る。まず驚くのは、入力欄に打ったプロンプトがそれぞれ自分自身の新しいセッションを開始するという点だ。2つ目を打っても1つ目への追記にはならず、隣に並ぶ。追加の指示はピークパネル（Space）から送る。安全性の中核はworktreeによる隔離にある。バックグラウンドセッションはファイルを編集する前に .claude/worktrees/ 配下の隔離されたworktreeへ移り、並列セッションは同じチェックアウトを読めるが書き込みはそれぞれ自分のものへ行う。読みは共有・書きは分離という設計だ。メインチェックアウトへ届く操作は3つのチェックで遮断される——ファイル編集（Edit/Write/NotebookEdit）、コマンドの作業ディレクトリ、そしてgitの向き先の付け替え（git -C、--git-dir、GIT_DIR、GIT_WORK_TREE、gitの前のcd）。検証できないコマンドは通さない安全側の判断になっており、この保護はセッションが生やすあらゆるサブエージェントにも継承される。ただしこれはOSの壁ではなく、リポジトリの外のファイルとネットワークは対象外で、PowerShellには作業ディレクトリのチェックしか適用されない。権限モードはその場で1件ずつ選ぶのではなく始め方で決まり（シェルで開いたagent viewやclaude --bgは通常の起動と同じ規則、←で開いたagent viewはディスパッチ先のdefaultModeか元のセッションのモード、/bgは今のモードのまま）、普段緩めにしている人ほど無人の緩い権限が並列で生まれる。そして隔離の外へ漏れるものが3つある。「今後は確認しない」の承認はメインチェックアウトの.claude/settings.local.jsonに保存され全worktreeに効きworktreeを消しても残ること、agent viewでセッションを削除するとClaudeが作ったworktreeごと消えるため未コミットの作業が失われること、.worktreeincludeが秘密情報をworktreeの数だけ複製すること。さらにクォータは並列数に比例して減り（10個なら約10倍の速さ）、セッションはローカルで動くためマシンのシャットダウンで止まる。サブエージェント・エージェントチーム・動的ワークフロー・プロジェクトとの使い分け、安全に回すための手順（ディスパッチ前・実行中・終了後）も公式仕様にもとづいて整理する。

Claude Codeの/compactを「30分おき」「文脈が70%を超えたら」のような基準で押している人は多いが、公式ドキュメントが勧めているのは時計でも割合でもなく作業の区切りだ——「作業の自然な区切り、たとえばタスクとタスクの間で/compactを実行する。タスクの途中で自動コンパクトが走るのを待つのではなく」。この記事は2026年10月4日時点のClaude Code公式ドキュメント（最新版v2.1.289）を一次情報として、手動コンパクトの是非を仕様から詰める。まず前提として、コンパクトは3段構えで動く——①古いツール出力の切り捨て、②自動コンパクト、③手動の/compact。②と③は同じ処理であり、手動の役割は「タイミングを自分で選ぶこと」と「何を残すか指示できること」の2点しかない。回数を増やしても文脈が余分に節約されるわけではない。次に何が残るかを仕様表で示す：プロジェクト直下のCLAUDE.mdと自動メモリはディスクから再注入されるが、paths:付きルールとサブディレクトリのCLAUDE.mdは該当ファイルを再度読むまで失われ、呼び出したスキル本文は1スキル5,000トークン・合計25,000トークンの上限で古い順に捨てられる。費用については、コンパクトの価格は文脈の大きさではなくプロンプトキャッシュが温かいかどうかで決まる——作業中に押せば前置きはキャッシュから読まれて安く、キャッシュ寿命（サブスクは1時間、APIキーは既定5分）を超える休憩のあとは履歴全体を読み直すため最も高くつく。さらに/clear・/rewind・/recap・/contextとの使い分け、v2.1.221以降の/autocompactで自動発火位置を100K〜1Mトークンの範囲で動かす方法と4つの設定場所の優先順位、環境変数だけが素の整数しか受け付けない落とし穴、Not enough messages to compactとAutocompact is thrashingという2つのメッセージの意味と復旧手順まで扱う。

OpenAIで実装し、次にClaudeやGeminiも試したくなった途端、プロバイダごとに違うSDK・形式・エラー処理の書き分けに時間が溶ける——そんな開発者向け。LLMゲートウェイ（AI Gateway／LLMプロキシ）は、アプリと各プロバイダの間に1枚かませる中継役で、1本のOpenAI互換APIで全モデルを叩けるようにし、フォールバック・コスト集計・仮想キー・キャッシュ・レート制限・観測といった横断的な面倒ごとを肩代わりする。本記事では、なぜ要るのか、ゲートウェイの正体、3つのタイプ（①セルフホスト型プロキシ=LiteLLM／②ホスト型=OpenRouter／③SDK型=Vercel AI SDK）の違い、LiteLLM・OpenRouter・Vercel AI SDKを軸にした選び方、接続先を差し替えるだけの最小構成コード、そして1ホップ分の遅延・ゲートウェイ自身の障害点・手数料（OpenRouterは購入額の5.5%）・機能の目減り・プライバシーという限界まで、実装目線で整理する。

Claude Codeのサンドボックスは、隔離されるシェルと子プロセスのファイル・通信アクセスをOSレベルで制限します。/sandboxでの準備、書き込み先・読み取り拒否・許可ドメイン、通常権限と自動許可の違いを整理。内蔵Read/Edit/Write・MCP・Hooks、除外コマンドや外側での再実行は別経路です。許可範囲内の破壊・送信や秘密情報の漏洩をすべて防ぐ保証ではないため、未知ホストのモード別判断と例外設定も説明します。

AWSの運用・管理をAIに任せられるか。2026年は「かなり任せられる」段階に入った。AWS自身がAmazon Q DeveloperやAIエージェントがAWSを操作する公式基盤「Agent Toolkit for AWS」(2026年5月・40以上のagent skills＋マネージドAWS MCP Server＋プラグイン)を出し、IaC生成からリソース操作までAIが踏み込める。本記事は「任せる」を3段階(①コード/IaC生成支援②読み取り中心の運用・調査③実際にAWSを操作する自律エージェント)で整理し、主要ツール(Amazon Q Developer/Agent Toolkit/AWS MCP Server/Terraform MCP/Bedrock AgentCore)、メリット(IaCの速さ・一次調査自動化・コスト最適化提案・知識の民主化)、そして本題のデメリット(IAM権限の肥大化=permission sprawl、過剰権限がミス/プロンプトインジェクションの実行加速器になる、権限がタスクを越えて残る、コスト暴走。2025-26には本番DB削除の実例も)を、AWS公式・セキュリティ各社の情報をもとに解説。結論の「ひとひねり」は、論点は"できるか"ではなく"暴走・課金爆発なしにどう任せるか"であり、AWS自身がAgent ToolkitにIAMガードレール/CloudTrail監査/サンドボックスを組み込んだのが答えの形という点。最小権限IAM＋破壊的操作の人間承認＋可観測性＋JIT短命資格情報＋サンドボックスの5原則とFAQ付き。

AIエージェントを業務に組み込む最初の関門が「どのフレームワークで作るか」。本記事は開発者・技術選定者の視点で、LangGraph・CrewAI・AutoGen(2026年4月GAのMicrosoft Agent Frameworkへ統合)・OpenAI Agents SDK・Google ADK・Claude Agent SDKの6つを、オーケストレーション方式(有向グラフ/役割crew/会話GroupChat/ハンドオフ/階層ツリー/自律ツールループ)・対応言語・学習曲線・制御性・本番成熟度・トークンコスト・向く用途で具体的に比較する。最大の注意点は「試作で最速のCrewAIが、本番ではトークン約3倍(あるベンチで41k vs LangGraph 18.5k)かつ非決定的で金融・医療に不向き」という、試作の勝者と本番の勝者が逆転する罠。さらに2026年はMCP(ツール連携)とA2A(エージェント間連携)で異なるフレームワークが相互運用できるようになり、ロックインが薄れた点を解説。用途別の選び方とFAQ付き。

Claude Codeの権限ルールは、settings.jsonのallow・ask・denyでツール呼び出しを制御する仕組みです。設定の優先順位、コマンドとパスの一致方法、実用例を説明します。Bashの別表記、任意スクリプト、Read/Editの否定パターン、modによる判定変更も整理し、秘密ファイルや通信を全経路で止める保証とは区別します。

Claude Codeで入力欄の隣に出る「権限モード」（Shift+Tabで切替）は、Claudeがファイル編集・コマンド実行の前にどれだけ「確認（許可）」を求めるかを決める設定。本記事は、権限モードとは何か（確認の頻度＝監視と自律のトレードオフ。端末とVS Codeではv2.1.283以降プランを問わず自動モードで始まり（それより前はPro・Max・Teamのみ）、claude -pやAgent SDKは手動で始まる。.git/.claude等の保護パスはバイパス以外では自動承認されない）、セレクタに並ぶ5つのモード（手動=default＝読み取り以外は毎回確認/編集を受け入れる=acceptEdits＝作業フォルダ内の編集とmkdir・rm・mv等のファイル操作を自動/プラン=plan＝編集せず計画だけ/自動モード=auto＝別の判定モデルの安全チェック付きでほぼ無確認/権限をバイパス=bypassPermissions＝ほぼ全部無確認で隔離環境専用）＋Shift+Tabの循環に出ずフラグか設定で指定する6番目のdontAsk、切り替え方法（Shift+Tabで手動→編集を受け入れる→プランを循環し、バイパスと自動モードは条件付きでその後ろに入る。--permission-modeフラグ、settingsのdefaultMode。autoとbypassPermissionsはプロジェクト設定では効かない）、自動モードの深掘り（分類器が危険操作をブロック・Team/Enterpriseでも既定で利用可で管理者が停止できる・対応モデルはOpus 4.6以降/Sonnet 4.6以降/Fable系・会話で述べた境界も尊重・連続3回/累計20回ブロックで一時停止）、使い分けと安全性（バイパスはプロンプトインジェクション防御なし＝隔離環境のみ・日常は自動モードが正解・hooksはバイパスでも実行・バイパスを使える端末ではプラン中の編集も止まらない）、工数(effort)との関係（権限モード=どれだけ確認するか/工数=どれだけ賢く考えるか）までを公式ドキュメントとデスクトップアプリの表示（2026年10月5日時点）に基づき初心者向けに解説する。

Claude Codeでモデル名の隣に出る「工数（effort）」のスライダー＝「速い↔賢い」のつまみは、AIが応答にかける手間（思考量・ツール呼び出し・応答テキストの量）を決める設定。本記事では、工数とは何か、スライダーの5段と表示名（APIの工数は low/medium/high/xhigh/max の5段。日本語表示は 低・中・高・特大・Max。重要：「特大」＝xhighで最大ではなく、最大の工数は「Max」）、保存の仕組み（低〜特大はEnterで確定するとモデルごとに保存、Maxはセッション限定）、モデル別の対応と自動降格（xhighは Fable 5.1・Opus 5.5・Sonnet 5.5 など比較的新しいモデル限定、Opus 4.6・Sonnet 4.6はxhigh不可で指定時はhighに降格、旧モデルの Haiku 4.5 は工数に非対応で Haiku 5.5 は全段に対応。Claude Codeの既定はモデルごとで Opus 5.5・Sonnet 5.5・Haiku 5.5 は medium、Fable 5.1 は high）、設定方法（/effortスライダーや直接指定・/effort auto、/model、--effort、CLAUDE_CODE_EFFORT_LEVEL環境変数が最優先、settingsのmodelSettings・effortLevel、skill/subagentのfrontmatter）、使い分け、Ultracode徹底解説（工数の段ではなく、どの工数でもオン／オフできるスイッチ。オンにするとClaudeがマルチエージェントの動的ワークフローを自動で組む。xhigh対応モデル限定、/effort ultracode・Tabキー・設定の "ultracode": true での有効化、使いどころ・コスト注意、v2.1.284より前との違い）、隣接機能（ultrathink＝その回だけ深く考える、/fast＝高速モード）までを公式ドキュメント（2026年9月時点）と実機UIに基づき初心者向けに解説する。

ChatGPTやClaudeのようなAIはクラウドで動かすのが当たり前——そう思いがちだが、小さなモデルならファイルは数GBで、普通のノートPCでも動く。ローカルLLMとは、AIモデルをクラウドではなく手元のPCで直接動かすこと。入力が外部に送られない（プライバシー）、API料金がかからない、ネットがなくても動く、の3つが利点で、最上位のクラウドAIほど賢くない点と相応のPCスペックが要る点が弱点だ。本記事では、量子化（Q4_K_M なら fp16 の約3割。Llama 3.1 8B で16GB→4.9GB）と Ollama のタグ一覧の実サイズの表（2026年9月30日時点）、Ollama と LM Studio の公式の動作条件、Ollama の公式手順（macOS・Linux は install.sh、Windows は install.ps1 で入れ、ollama run gemma4 で動かし、ollama ps で GPU に載ったかを確かめる）、「:cloud」付きのモデルは手元で動かないという注意、モデルの選び方（Llama 3.1・Gemma 4・Qwen3.8・DeepSeek-R1 などの例）、クラウドとの使い分けまでを初心者向けに解説する。

プログラミング初学者がほぼ必ず詰まる「環境構築」。2026年の生成AI（Claude Code、Codex、Cursor）は、ローカル環境構築・Dockerfile・Terraform雛形・CI/CDパイプラインなど定型インフラ作業を実用域で生成できる。HashiCorpは公式Terraform MCP Serverを2025年に公開して2026年6月に一般提供、Anthropic Agent Skillsでインフラ知識を後付けロードできる時代になった。ただし「全部任せていい」は別問題。月末AWS請求$3,000、本番DBの誤った public 公開、SSHキーのGitHubへのcommit——どれも丸投げで起こりうる事故だ。本記事ではAIに任せていい5領域、確認しつつ任せる3つの危険領域、人間判断必須の4領域、初心者向け4ステップ安全フロー、Claude Code・MCP・Agent Skillsの最新ツール連携まで、能力評価視点で整理する。