メインコンテンツへスキップ
見出し画像

【最新AI解説】Claude Codeの壊れた設定は/statusで先に見つける

    「定期実行が止まっていた。原因は、だいぶ前に壊れていた設定ファイルだった」

    AIエージェントに作業を任せる運用で怖いのは、派手なエラーより「静かに止まる」ことです。設定ファイルの書き間違いや、永遠に一致しないフックの条件は、実行するまで表に出てこないことがあります。その「実行するまで分からない」を減らす更新が入りました。
    2026年11月17日、Claude Codeの公式changelogに新しい更新が掲載されました。
    この記事で分かるのは次の3つです。

    • /statusで「壊れた設定ファイル」が一覧で見られるようになったこと

    • MCPサーバーの追加で、トークンをコマンドラインに残さない方法と、設定ファイルを上書きしない変更

    • 公式changelogで確認した制限・注意点

    情報源はClaude Code公式changelog(2026年11月17日の項目)です。この記事は公式情報で確認した範囲を解説するもので、本機能の使用体験談ではありません。



    /statusで「壊れた設定」が先に一覧で見られる


    画像
    要点は、設定の不整合を「実行時の失敗」ではなく「事前の点検」で見つけられるようになったことです。
    公式changelogは、2026年11月17日の追加項目として次の内容を挙げています。



    Added a list in /status of broken agent, skill, command and output style files, keybinding errors, an unavailable sandbox, ignored permission settings and hook matchers that never match(/statusに、壊れたエージェント・スキル・コマンド・出力スタイルのファイル、キーバインドのエラー、使えないサンドボックス、無視されている権限設定、永遠に一致しないフックのマッチャ

    ーの一覧を追加)

    一覧に挙がるのは、次のような「普段は見えない壊れ方」です。

    • 壊れたエージェント/スキル/コマンド/出力スタイルのファイル

    • キーバインドのエラー

    • 使えない状態のサンドボックス

    • 無視されている権限設定(書いたつもりで効いていない設定)

    • 永遠に一致しないフックの条件(発火するはずがない設定)

    「書いたつもりで効いていない」が一番危ない

    権限設定やフックは、書けば効くとは限りません。条件の書き方ひとつで、永遠に発火しないフックや、別の設定に上書きされて無視される権限が残ります。こうした不整合は、通常の作業ではエラーとして現れず、「止めたい場面で止まらない」「動くはずの場面で動かない」という形で初めて表面化します。
    点検の一覧が用意されたことで、更新のたびや定期実行の前に「設定が意図通りか」を目で確認する手順を、運用に組み込みやすくなります。



    MCPの追加も「秘密を残さない・上書きしない」方向へ


    画像
    要点は、外部ツールの接続設定でも、秘密情報の扱いと既存設定の保護が強くなったことです。
    同じ2026年11月17日の更新には、MCP(外部ツール接続の仕組み)まわりで次の変更が含まれています。
    1. claude mcp add-json <name> - で、サーバーのJSON設定を標準入力から読めるようになった。公式changelogは「トークンをコマンドラインに残さないため」と明記している(ただしClaude Codeのセッション内では使えない)

    2. claude mcp add --scope project は、プロジェクトの .mcp.json に mcpServers キーなしでサーバーが最上位に書かれている場合、ファイルを上書きせずに停止するようになった

    3. /install-github-app がリポジトリを変更する前に、確認が入るようになった

    コマンドラインにトークンを書くと、履歴に残る

    コマンドの引数にトークンを直接書くと、シェルの履歴やプロセス一覧など、思わぬ場所に秘密が残ります。標準入力から渡せるようになったことで、「秘密は引数に書かない」という基本的な線引きを、設定作業でも守りやすくなります。

    上書きで止まるのは、不便ではなく保護


    既存の書き方と違う形式の設定ファイルに対して、黙って上書きせずに止まる変更も地味に重要です。自動化の現場では、設定ファイルは複数のツールや人が触ります。「分からない形式なら止まる」方が、「正しそうに書き換えて他の設定を消す」より安全です。自分の自動化運用でも、秘密情報は渡さず権限と承認でつなぐこと、取り返しのつかない変更の前には確認を挟むことを線引きにしています。今回の変更は、その考え方と方向が一致しています。



    検証:公式changelogで確認した制限・注意点


    画像
    ここからは、公式changelog(2026年11月17日の項目)で確認した範囲の制限と注意点です。確認できていないことは書きません。

    対象と前提

    • この更新はClaude Codeの変更履歴の2026年11月17日分として掲載されています。公式ページにはバージョン番号の明記がないため、この記事では日付で特定しています

    • claude mcp add-json の標準入力読み取りは、公式changelogに「Claude Codeのセッション内では使えない」と明記されています。対話セッションの中から同じ手順は使えません

    • /statusの一覧は点検のための表示です。一覧に出た不整合を自動で直す機能とは、公式changelogの確認範囲では案内されていません。直す作業は人が行う前提で読むのが正確です

    同じ日の更新に含まれる、確認まわりの変更


    • ワークツリーを削除する操作(ExitWorktree)は、未保存の作業が残っている可能性がある場合に事前に確認するようになりました。確認できないモードでは、許可ルール等がある場合を除き拒否されます

    • 権限まわりでは、作業フォルダの外を読むコマンドへの確認が一部で強くなっています。自動実行の許可ルールを広く書いている場合は、更新後に想定より確認が増える可能性があります

    • 料金や提供プランについての変更は、この日の公式changelogの確認範囲では案内されていません

    更新内容は「新機能の追加」よりも「壊れと秘密と確認」の手当てが中心です。派手さはありませんが、任せる範囲を広げる前に必要な種類の更新です。


    この仕組みの作り方(実装手順)は有料記事で公開しています。自動化の役割分担や確認の残し方を、実際の手順とテンプレートで再現したい方はこちらをどうぞ。


    まとめ:任せる前に「壊れが見える」ことが前提になる


    • 2026年11月17日のClaude Code更新で、/statusに壊れた設定ファイルや永遠に一致しないフックなどの一覧が追加された

    • MCP設定は標準入力から渡せるようになり、トークンをコマンドラインに残さない書き方ができる(セッション内では不可)

    • 形式の違うMCP設定ファイルは上書きされずに止まる。確認なしの変更を減らす方向の更新がそろった

    • 一覧は点検用で、修正まで自動とは案内されていない。見る手順を運用に入れるところが使いどころ

    関連記事として、Claude Codeの定期実行で確認ルールが変わった話の解説もあわせてどうぞ。

    このアカウントでは、AIで自動化できることの解説と、最新AIの解説を毎日届けています。続きはマガジン「AIで自動化できること解説」で読めます。

     
     
    AIで自動化できることを、分野別に解説するノートです。商品づくりから販売、情報収集、投稿や問い合わせの対応まで。実際に動かしている仕組みを例にして、「どこまで自動でできて、どこからは人間がやるのか」まで正直に書きます。再現手順の詳細は有料記事で公開しています。

    あなたへのおすすめ