Claude CodeのTips一覧16ページ目

フッターに出るPR/MRバッジの色分けと更新頻度、GitHub(gh CLI)とGitLab(glab CLI、v2.1.234以降)それぞれの必要条件を扱います。

「Plugin archive integrity check failed」でzip配布のプラグインが入らないときの原因3パターンと対処。sha256の再計算手順、256MiB上限などarchiveソースの仕様もまとめます。

/permissionsダイアログでallow・ask・denyルールをスコープ別に管理し、auto modeが拒否した操作を「最近の拒否」タブから再試行する手順をまとめます。

Claude CodeがPDFを読み込めないときの「too large」「password protected」「not valid」の3エラーを、原因別に切り分けて対処します。

「Your organization has disabled Claude subscription access」の原因と、APIキー認証への切り替え・管理者側の対応を切り分けます。

「Your organization has disabled API key authentication」の意味と、Console管理者・利用者それぞれの対処をまとめます。

Claude Codeで「OAuth token revoked」「OAuth token has expired」が出たときの原因と対処を、/loginの手順からCLAUDE_CODE_OAUTH_TOKEN使用時の挙動まで確認します。

Claude Codeで「OAuth token does not meet scope requirement」と出たときの原因と対処。/usageやステータスラインで出やすい理由と、/loginだけで直る仕組みを扱います。

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へ自動で追加するスキルです。仕組みと注意点をまとめます。