Claudeの使い方・活用術ガイド

Claude Codeで複数AIに手分けさせる仕組みには、似て非なるSubagents（サブエージェント）とAgent Teams（エージェントチーム）の2つがあり、役割と協調のしかたが根本的に違う。本記事では両者を正確に整理する。Subagentsは標準機能で、メインのエージェントが特定タスクを独自のコンテキストウィンドウ・システムプロンプト・ツール権限を持つ助手に自動委譲し、要約だけを受け取る階層型・使い捨て（会話履歴は見ない、/agentsで管理、.claude/agents/のYAML定義、Explore/Plan等の標準サブエージェント、最大5階層までネスト可）。一方Agent Teamsは実験的なオプトイン機能で既定では無効——CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1が必要で、複数の独立セッション（チームリードと仲間）が共有タスクリストとメールボックスで対等に直接連携するピア型・永続（v2.1.178はTeamCreateの準備ステップを撤廃し各セッションが暗黙のチームを持つよう簡略化しただけで、既定有効化ではない）。決定的な違い（階層vsピア、要約vs直接通信、標準vs実験的フラグ必須、5階層ネストはSubagentsの仕様でTeamsは入れ子不可）、どちらを使うべきか（結果だけ欲しい/文脈を汚したくないならSubagents、作業者が相互共有・調整すべき並列作業ならAgent Teams、逐次・同一ファイル・素早い修正なら単一セッション）、使い方チートシート、Agent Teamsの注意点（高トークンコスト・推奨3〜5人・worktree非隔離でファイル競合・/resume等の制限・分割ペインはtmux/iTerm2）までを、公式ドキュメントに基づいて整理する。

Claude Designは、作りたいものを会話で説明するとClaudeがUIデザインやプロトタイプ、スライド、ワンページャーを生成し、チャット・インラインコメント・直接編集・スライダーで仕上げられるAnthropic Labsのデザインツール（2026年4月17日研究プレビュー公開、最初の1週間で100万人超が利用）。2026年6月17日の大型刷新で、デザイナーと開発者の往復を一気に縮めた。本記事では、Claude Designとは何か（4月の公開時点ではOpus 4.7で動くとされたが6月告知ではモデル再言及なしのため断定しない）、6月刷新の中身（GitHubリポジトリ/デザインファイル/素材からのデザインシステム取り込みと自社コンポーネントでの構築・出力照合、/design-syncによるClaude Codeとの双方向同期、ドラッグ/リサイズ/整列のキャンバス直接編集と多数の安定性修正、チャット/Cowork/Claude Codeとの使用量上限共有によるトークン浪費問題の改善、管理者が標準システムを承認しロックするエンタープライズのブランド管理、Adobe/Canva/Miro/Vercel/Wix等やPDF/PowerPointへのエクスポート連携拡充）、/design-syncの双方向（Code→：デザインシステムをリポジトリに取り込み実コンポーネントで実装／→Design：作ったコードをキャンバスに戻して編集／Design→Code：仕上がったデザインをClaude Codeに渡しスクショから作り直さず引き継ぐ、/designでターミナルから作成・編集・同期も）、利用条件（Pro/Max/Team/Enterpriseのベータで追加料金なし・Enterpriseは既定オフ・キャンバスはweb/desktopのみ・/design-syncはCLI）、なぜ重要か（スクショから作り直す断絶を埋め、デザイナー×開発者を一本でつなぐ）までを、公式情報に基づき不確実点を明示しつつ整理する。

2026年6月18日にAnthropicが発表したClaude Code Artifacts（ベータ）は、ターミナルのコーディングセッションを、チームで共有できるライブなWebページに変える新機能だ。git diffやログをテキストで延々流す代わりに、注釈付きPRウォークスルー・自己更新するダッシュボード・インシデントのタイムライン・自動でチェックが入るリリースチェックリスト・アーキテクチャ図などを、claude.aiの非公開URLを持つ1枚のページとして公開できる。本記事では、Artifactsとは何か（セッション全体やMCPコネクタ経由のデータから構築し、作業の進行に合わせて開いた画面もその場で更新される）、2024年のclaude.aiのキャンバス型Artifactsとの違い（セッション由来・自己更新・組織内限定・公開不可）、用途、使い方（/artifactのような専用コマンドは無く自然言語で依頼、Claudeが.htmlを書き出して公開許可を求めURL表示、Ctrl+]で再表示、更新で同URLの新バージョン、Shareで組織内共有）、制約（アプリではなく作業のキャプチャ＝バックエンド無し・厳格なCSPで外部リクエスト不可・単一ページ・.html/.htm/.mdのみ・16MiB以下・トークン多め）、利用条件（Team/Enterprise限定ベータ、/loginサインイン必須でAPIキー不可、Anthropic APIのみでBedrock等非対応、CMEK/HIPAA/ZDRで無効、管理者制御と監査ログ）までを、公式ドキュメントに基づいて整理する。

Claude Codeで「Not logged in · Please run /login」「Invalid API key」「This organization has been disabled」「OAuth token has expired」などが出てログインを求められる——これらは多くが401/403＝認証（あなたが誰か）の問題だ。本記事では、認証トラブルで最頻出の真因（環境変数ANTHROPIC_API_KEYがサブスクPro/Maxログインを優先順位で黙って上書きし、予期せぬ従量課金・organization disabled・Invalid API keyを生むこと、キーは.zshrc/.bashrc/.profileやdirenv/dotenv・IDEターミナルの.env・前職の残骸・CIから来ること）、検出（/statusで有効な資格情報を確認・env | grep ANTHROPIC）と修正（unset ANTHROPIC_API_KEY＋シェル設定から削除）、その他の原因（トークン失効・無効化、システム時計のずれ、macOSキーチェーンのロック、Consoleロール不足の403、WSL/SSH/コンテナでのOAuthリダイレクト失敗＝コード貼り付けで回避、組織ポリシーはローカル上書き不可）、認証情報の保存場所（macOS Keychain/Linux ~/.claude/.credentials.json/Windows %USERPROFILE%）、切り分けワークフロー（/status→env grep→unset→/logout→/login→時計・キーチェーン・Consoleロール）、紛らわしいエラー（usage limit=プラン枠/429=レート/529・500=サーバー/Credit balance=残高）との区別までを、公式情報に基づいて整理する。

Claude Codeをインストールしたのにターミナルで「zsh: command not found: claude」「bash: claude: command not found」「is not recognized as an internal or external command(Windows)」が出る——これは多くの場合インストール先のフォルダがPATHに入っていないだけで、インストール自体は成功している。本記事では、シェルがPATH上のフォルダを順に探す仕組み、インストール方法と置き場所(ネイティブインストーラ推奨=~/.local/bin・Windowsは%USERPROFILE%\.local\bin/npmはNode18+で同じネイティブバイナリ/Homebrew/WinGet、VS Code拡張だけではclaudeはPATHに入らない)、主な原因と対処(PATHに~/.local/binを追加して端末再起動、npm権限エラーEACCESはsudoせずネイティブへ、Nodeが古い、複数インストールの衝突はwhich -a/where.exeで確認しネイティブ1本に、optional依存スキップでネイティブバイナリ不明)、Windows特有の罠(irmをCMDで等のシェル取り違え・端末再起動・古いClaude DesktopのWindowsApps Claude.exe衝突・Git BashのCLAUDE_CODE_GIT_BASH_PATH)、自動更新と更新系(claude update/claude install/claude doctorで成否確認/DISABLE_AUTOUPDATER・DISABLE_UPDATES)、切り分けワークフロー(claude doctor→which -a→PATH追加→余計な版を削除→ネイティブ入れ直し)までを、公式情報に基づいて整理する。

会社のPCやVPN越しでClaude Codeが「Unable to connect to API」「Unable to connect to API (ECONNREFUSED)」「SSL certificate verification failed」「fetch failed」で繋がらない——これらはリクエストがAnthropicのサーバ(api.anthropic.com)まで届いていないネットワーク系エラーで、認証(401/403)・サーバ過負荷(529/500)・レート制限(429)とは別物だ。本記事では、企業ネットワークで詰まる3層(プロキシ未設定・TLS検査による証明書差し替え・ファイアウォールのドメイン遮断)とDNS/VPN/Docker、プロキシ設定(HTTPS_PROXY/HTTP_PROXY/NO_PROXY、認証付きプロキシ、SOCKS非対応、NTLM/KerberosはLLMゲートウェイ＋ANTHROPIC_BASE_URL、MCPサーバは各envに明示)、TLSと社内CA証明書(近年は同梱CA＋OSトラストストアの両方を信頼しOSストアにあれば設定不要、無ければNODE_EXTRA_CA_CERTSにPEMを指定、mTLSはCLAUDE_CODE_CLIENT_CERT/KEY、インストール時はcurl --cacert)、絶対にやってはいけないNODE_TLS_REJECT_UNAUTHORIZED=0(全通信が中間者攻撃に晒される)、ファイアウォールの許可ドメイン(api.anthropic.com/claude.ai/platform.claude.com/downloads.claude.ai/raw.githubusercontent.com、statsig/sentryは任意)、切り分けワークフロー(curl -I https://api.anthropic.comで到達確認→/doctorとプロキシ確認→証明書/プロキシ設定→直接接続で確定→DNS/VPN/Docker)、認証・サーバ・レートとの区別までを、公式情報に基づいて整理する。

Claude Codeで突然「API Error: 529 {"type":"overloaded_error","message":"Overloaded"}」や「500 Internal server error」が出て止まった——これらはサーバー側の一時的な事象で、あなたのリクエストや設定のミスでも使用量の枠切れでもない。本記事では、529 Overloaded（Anthropic側のAPIが一時的に過負荷＝全ユーザー共通の混雑）と500（サーバー内部の予期しないエラー、関連で504 timeout_error。502/503は上流インフラ由来が多い）の意味、いずれもあなたの使用量の枠を消費しないこと、Claude Codeが表示前に最大10回・指数バックオフで自動リトライしている仕組み（Retrying in Ns・attempt x/y、CLAUDE_CODE_MAX_RETRIES既定10・API_TIMEOUT_MS既定10分）、ユーザー側の対処（少し待って再試行・/modelでモデル切替＝容量はモデル別なのでOpusが混んでもSonnetなら通る・status.claude.com確認・500継続ならrequest_idを添えて/feedback）、紛らわしいエラーとの区別（529/500=サーバー側で枠不消費／429=あなたのレート制限でretry-after付き・枠消費／usage limit=プラン枠／400=リクエストの不備）、開発者向け（SDKの型付き例外と自動リトライ・指数バックオフ＋ジッター・retry-afterは429のみ・--fallback-model・Priority Tier/Batch）、一時的スパイクか継続インシデントかの見分けまでを、公式情報に基づいて整理する。

Claude Codeで作業中に突然「Claude usage limit reached. Your limit will reset at 3pm」と出て手が止まる——これはエラーやバグではなく、サブスク（Pro/Max）の使用量制限の仕様だ。本記事では、制限の二層構造（最初のプロンプトから約5時間で回復する5時間ローリング枠＋7日ごとにリセットする週次枠＋MaxにはOpus専用の週次枠）、Claude CodeとClaudeアプリが同じプランの枠を共有すること、消費を最も食う4要因（モデル選択=Opusが桁違い・コンテキストの大きさ・長時間連続セッション・サブエージェント/MCP）、上限到達時に今すぐ動かす5つの選択肢（/modelでSonnetに下げる・/compactで文脈を削る・5時間枠ならリセットを待つ・API従量課金へ切替・使用量クレジット購入やプラン昇格）、残量の見方（/usage・/status・設定→使用量で週次リセット日を確認）、サブスク制限とAPI制限（429・retry-after・Tier）の違いまでを、公式情報をもとに整理する。なお具体的な枠の数値は時期で改定されるため断定を避け、最新の公式表示で確認することを推奨する。

Claude CodeやAPIで突然出る「Prompt is too long」（API では「prompt is too long: 233153 tokens > 200000 maximum」）——これは使用量制限ではなく、送ろうとした入力（会話履歴＋添付/読み込んだファイル＋ツール定義など）がモデルのコンテキスト窓を超えたという意味だ。本記事では、コンテキスト窓を埋める要因（増え続ける会話履歴・読み込んだファイル・ツール結果という動的要因と、MCPツール定義・CLAUDE.md・システムプロンプトという固定要因）、Claude Codeが既定でauto-compact（自動要約）して回避していること、窓のサイズ（標準200Kと1M、1Mは2026年時点で標準価格だがサブスクではクレジットが必要な場合・新トークナイザで約30〜35%多く消費する注意）、今すぐ直す手順（/compactで要約・/clearで作り直し・巨大な読み込みは別の窓を持つサブエージェントに逃がす・/contextで内訳確認し不要MCP無効化やCLAUDE.md圧縮・本当に大きい時だけ1Mモデル）、紛らわしい3つ（Prompt is too long=入力超過／max_tokens=出力切断／usage limit=プラン枠／1M credits=権限）の見分け方までを、公式情報に基づいて整理する。

Claude CodeでMCP（Model Context Protocol）サーバーを設定したのに、/mcpを開くとfailedやneeds authentication、pending approvalで止まっている——MCP接続は意外と詰まりやすい。本記事ではまず/mcp（やclaude mcp list）のステータスで原因を3系統に分類する方法（✓ connected/✗ failed=ローカル起動失敗/△ needs authentication=リモート認証/⏸ pending approval=プロジェクト承認待ち、connectedなのにツール0の状態）、failed・設定系の主因と対処（相対パス→絶対パス、サーバ用APIキーはサーバごとのenvに書く・settings.jsonのenvは伝わらない、MCP_TIMEOUTでの起動タイムアウト、.mcp.jsonはリポジトリ直下・未定義の${VAR}で解析失敗、stdoutにログを書くとプロトコルが壊れる）、Windowsで最頻出のnpx問題（spawn npx ENOENT→commandをcmdにして/c npxでラップ、またはWSL）、リモートのOAuth認証（401/403→/mcpから認証、Microsoft 365/Gmail等はclaude.aiのコネクタ側で接続）、切り分けワークフロー（/mcpでステータス→claude --debug mcpでstderr→サーバ単体起動→MCP Inspector→Desktopは完全再起動）、再発防止チェックリストまでを、公式情報に基づいて整理する。

Claude Codeで長時間作業していると、突然「court」や生の<invoke name="Bash">タグが画面に漏れ、ツール呼び出しが実行されない——そんな現象に遭遇したことはないだろうか。これはあなたの環境やコマンドのミスではなく、Claude（特にOpus 4.8/4.7系）がツール呼び出しの制御タグを生成する瞬間に、まれにそのタグが壊れて出力されるモデル側の既知の不具合だ。Anthropic公式リポジトリにも多数のIssue（#64108, #64150, #64690, #65705, #66153, #67295, #68354）が立っている。本記事では、エージェントがツール呼び出しもテキストとして「生成」している仕組み、ハーネスがfail-closedで弾くため誤コマンドは走らない安全性、原因の2層構造（①制御トークンの生成破損＋②壊れたブロックが履歴に残ることでモデルが真似て連鎖する自己汚染）、誘発条件（長時間・複数日セッション、重いコンテキスト、/compact後、複数ツール同時、3+MCP、長いツール引数）、よくある3つの誤解（暴走ではない／courtに意味はないが目印／再試行で直るは軽症時のみ）、ユーザー向け対処（2回外したら新セッション/clearへ逃げる・/compactは不確実）、開発者向け対処（stop_reason確認・invoke混入検出リトライ・壊れた履歴を残さない・引数短縮）、似たエラー（thinking署名400・max_tokens切断・Bedrock第三者連携）との見分け方、2026年6月時点で公式修正が未提供である対応状況までを、公式ドキュメントと実Issueに基づいて完全解説する。

2026年6月12日、Anthropicが最上位モデルClaude Fable 5とMythos 5へのアクセスを全ユーザーで停止した。米政府の輸出管理上の命令に従うためで、両モデルは6月9日に公開されたばかり——登場からわずか3日での全面停止となった。本記事は公表情報をもとに事実関係を整理する。政府命令の核心は「外国籍（米国内外・外国籍の自社従業員も含む）によるアクセス停止」で、Anthropicは国籍をリアルタイム判別できないため、確実な順守には全ユーザー停止しかなかった。引き金は他社による「脱獄（jailbreak＝安全装置の回避）」の指摘だが、Anthropicは「既知のごく軽微な脆弱性で、狭い脱獄の可能性をもって数億人提供の商用モデルを回収する理由にはならない」と決定に不同意を表明。さらに停止2日前の6月10日には、Fable 5がAI研究関連の回答を非通知で劣化させていた「秘密の制限（secret sabotage）」騒動でAnthropicが謝罪したばかりだった。影響範囲はFable 5・Mythos 5のみで、Claude Opus 4.8など他モデルはアプリ・API・Claude Code・クラウド経由いずれも通常稼働、料金変更の発表もなし。代替や再開時期は未定。ユーザー・開発者向けの対処（Opus 4.8へのモデル切替、フォールバック構成、単一モデル依存の回避）まで解説する時事ニュース解説。