Claude Code できること総まとめ＆エラー対応_20261013

Claude Code できること総まとめ＆エ ラー対応 基本編 / Skills・Hooks編 / マルチエージェント編｜公式ドキュメント参照（2026年10月11日時 点） うさうさ研修工房

基本編｜まず覚える 3点セット できること よく使うコマンド 権限モード • ファイルの読み書き • /model：モデル切替 • default：都度確認 • コマンドの実行 • /compact：会話を圧縮 • acceptEdits：編集は自動承認 • MCPで外部ツール連携 • /clear：会話をリセット • plan：読み取り専用で計画 • サブエージェントで並列作業 • /usage：利用枠の確認 • auto：分類器が判定 • hooksで自動チェック • /status：認証の確認 • • Skillsで手順を再利用 • /doctor：設定の診断 bypassPermissions：確認を 全て省略（要注意） 2

Skills・Hooks編｜手順の再利用と自動チェック Skills（手順を再利用） Hooks（自動で動く関所） • 個人：~/.claude/skills/<名前>/SKILL.md • PreToolUse：ツール実行の前 • プロジェクト：.claude/skills/<名前>/SKILL.md • PostToolUse：ツール実行の後 • 先頭に name と description を書く • Stop / SubagentStart / SubagentStop • /名前 で呼び出せる • 終了コード2で処理をブロック よくある失敗： ファイル名は SKILL.md（大文字小文字を区別）／hooksのスクリプトは chmod +x が必要／動かないときは claude --debug で確認 3

マルチエージェント編｜ 3つの方法を使い分ける 方法 会話の引き継ぎ 向く作業 費用 サブエージェント なし（新しく開始） 調査・レビュー・テスト実行 低め フォーク（/subtask） 全部引き継ぐ 今の流れで別作業 低め（キャッシュ共 有） Agent Teams（実験的） なし（指示文のみ） 議論・相互チェック 高め 迷ったらサブエージェントから始める。Agent Teamsは CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効化でき、使用量が大きく増えるため、最初は調査・レビューだけに使う。 4

エラー対応①｜サーバー・利用上限・認証 メッセージ 意味 対処 API Error: 500 / 529 Overloaded API側の一時障害や混雑（自動で最 大10回リトライ済み） status.claude.com を確認→数分待つ →/model で別モデル You've hit your session limit プランの利用枠が上限 リセット時刻まで待つ。/usage で確認 Request rejected (429) キー/プロジェクトのレート制限 /status で認証を確認、並列数を減らす Not logged in / Invalid API key 認証情報がない、または無効 /login。環境変数 ANTHROPIC_API_KEY が 残っていないか確認 Credit balance is too low Console残高不足、またはAPIキー が優先されている /status の API key 行を確認し、不要な環境 変数を外す 5

エラー対応②｜会話の長さ・マルチエージェント メッセージ 意味 対処 Prompt is too long / Context limit reached 会話が長すぎる /compact か /clear Agent would be spawned with zero tools tools の指定が1つも解決しない tools の綴りと、使える道具かを確認 subagent_type is required general-purpose が無いセッション 呼び出しで subagent_type を指定 Invalid --agents configuration --agents のJSONが不正 JSONの書式を見直す Concurrent subagent limit reached 同時実行が上限（既定は 20） 終了を待つ。 CLAUDE_CODE_MAX_CONCURRENT_SUB AGENTS で変更可 Agent terminated early due to an API error サブエージェントが APIエラーで停止 詳細のエラーを対処 →再実行または再開 6

困ったときの 5ステップと参考リンク 1 メッセージをそのまま読む（自動リトライは済み） 参考（公式） code.claude.com/docs/en/errors 2 公式の Error reference で同じ文言を探す …/en/sub-agents …/en/agent-teams …/en/skills 3 /status と /doctor で認証・設定を確認 4 claude --debug で詳細ログを見る 5 直らなければ /feedback で報告 status.claude.com（障害情報） 7