Claude CodeのTips一覧11ページ目

Claude Codeの完了通知が届かないときの原因と、preferredNotifChannel・Notification hook・iTerm2設定による直し方をまとめます。

claude attachが「This session has no saved transcript」を出す条件と、claude respawnでの復旧手順、v2.1.211〜v2.1.214の挙動の違いをまとめます。

claude --resume <session-id>で出る「No conversation found with session ID」の主な原因と、Ctrl+Aでの横断検索など対処をまとめます。

Claude Codeで改行だけ入れて送信しない4つの方法と、Shift+Enterがターミナルごとに効いたり効かなかったりする理由をまとめます。

CLAUDE_CODE_MAX_TURNSは非対話実行のターン数に上限を設ける環境変数です。--max-turnsとの優先順位、値の検証、金額・時間の上限との使い分けをまとめます。

CLAUDE_CODE_MAX_OUTPUT_TOKENSは1リクエストの最大出力トークンを決める環境変数です。モデルごとの上限値と、上げるとauto-compactionが早まる副作用まで押さえます。

「Marketplace is registered from an untrusted source」の意味と対処。予約名の一覧、v2.1.205前後の挙動差、strictKnownMarketplacesとの違いをまとめます。

Claude Codeで初見のコードベースを把握するコツは、全体像→アーキテクチャ→ファイル特定の3段階で質問を絞ることです。サブエージェント委任と@参照の使い分けも扱います。

Claude Codeの--json-schemaフラグでJSON Schemaが弾かれる原因を、3段階のチェック順序とformatキーワードの扱いから解説します。v2.1.205での挙動変化つき。

Write・NotebookEdit・Glob宛てのpermissionルールが効かないis not matched by file permission checks警告の直し方を解説します。書き換え先はEditとReadの2つです。

曖昧な指示のままClaude Codeに実装させると手戻りが起きます。AskUserQuestionツールで逆質問させ、仕様書に落としてから実装セッションを始める手順を解説します。

/insightsコマンドが生成するHTMLレポートの中身、保存先と保持期間、クラウドセッションで使えない制約、/usageやOpenTelemetryとの使い分けをまとめます。

空白だけのプロンプトはAPIに送られる前にClaude Codeが拒否します。-pとstream-jsonセッションで挙動が違う理由と、スクリプト側の対処をまとめました。

/initは既定では確認なしにCLAUDE.mdを自動生成しますが、環境変数CLAUDE_CODE_NEW_INIT=1を立てるとSkillsやHooksまで対話式に選べる複数フェーズの初期化に変わります。

settings.jsonのincludeGitInstructionsで組み込みのコミット/PR手順とgitステータスをシステムプロンプトから外す設定と、CLAUDE.mdでの置き換え方をまとめます。

Claude Codeに貼り付けた画像が「Image was too large」で弾かれる原因と、8000pxと2000pxの上限の使い分けをまとめます。

クラウドセッションやRoutineが特定ホストへの通信を403で拒否するエラーの原因と、ネットワークアクセス設定での対処を解説します。

/heapdumpはヒープスナップショットと診断用JSONを書き出す隠しコマンドです。会話全体と資格情報が含まれる共有禁止の理由と、報告・自己調査の手順をまとめます。

CLAUDE_CODE_GLOB_TIMEOUT_SECONDSはGlobツールのファイル探索タイムアウトを変更する環境変数です。既定値、WSLとの違い、上げる目安と確認手順をまとめます。

/forkは会話をバックグラウンドセッションに複製し、元のセッションはそのまま続けられます。/subtask・/branchとの違いとworktree分離の挙動を実例で扱います。

/focusは最後のプロンプト・ツール呼び出しの1行要約・最終応答だけを表示するCLIコマンドです。サブエージェント数の集約表示やVS Code拡張独自のFocus viewとの違いまで押さえます。

/fewer-permission-promptsは過去の会話履歴を走査し、繰り返し許可しているBashやMCPのツール呼び出しをsettings.jsonのallowlistへ自動で追加するスキルです。仕組みと注意点をまとめます。

claude --resumeのピッカーで出る「Failed to resume the conversation」の原因と対処、/resume内蔵ピッカーとの挙動の違いをまとめます。

ゲートウェイ経由で出る「Extra inputs are not permitted」の原因と、ヘッダー転送設定・環境変数での対処法をまとめます。

CLAUDE_CODE_EXTRA_BODYは、Claude CodeのAPIリクエストボディにJSONを追加でマージする環境変数です。用途・書き方・バックグラウンドセッションへの伝播条件をまとめます。

/exportはClaude Codeの会話をプレーンテキストで書き出すコマンドです。ファイル名指定の有無で挙動が変わり、スクリプトから読みたいときは別の手段を使います。

effortレベルはClaude Codeの推論の深さを決める設定です。モデルごとに使えるレベルが違い、ultracodeはeffortレベルではなく動的ワークフローを伴う別設定です。非対話モードでのhold挙動もあわせて解説します。

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICは自動更新・テレメトリ・エラー報告などをまとめて止める環境変数です。副作用で使えなくなる機能もあわせて解説します。

Claude Codeの環境変数DISABLE_ERROR_REPORTINGは、内部エラーの送信先をオプトアウトします。既定でオンになる条件、DISABLE_TELEMETRYとの違い、設定のしかたをまとめます。

Claude Codeの環境変数DISABLE_COST_WARNINGSはコスト警告メッセージを非表示にします。設定のしかたと、実際のコスト・請求には影響しない範囲、似た変数との使い分けをまとめます。