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

Postman Claude Code プラグイン 勝手に入った?Issue #14370 を原文で確認、確定したこと・分からないこと、調べるスクリプト付き【11月9日時点】

    10月24日(土)、ある開発者の Mac で、API ツール Postman(ポストマン)のデスクトップアプリが、本人に聞かないまま Claude Code と Codex にプラグインを入れていた——そんな報告が、25日に GitHub の Issue #14370 に投稿されました。Codex には、起動時に指示を読み込ませる「フック」が入り、それを「信頼する」という記録まで書かれていた、とあります。

    11月3日(UTC)に Postman 側とみられる返信が「オプトイン(利用者が選んで入れる形)をはっきりさせる」、5日に「この変更を元に戻している」と述べ、Issue は閉じられました。一方、公式ドキュメントには「デスクトップアプリはプラグインを自動ではインストールしない」とあり、報告と食い違って見えます。

    私は Claude Code と Codex を毎日使って、教材づくりや出品の自動化をしている個人です。セキュリティの専門家でも Postman の関係者でもなく、引用は英語の原文を私が日本語にしたものです。Issue・公式ドキュメント・公開リポジトリ・npm は自分で開いて読みました。この PC(Windows)には Postman のアプリが無く、現象は再現できていません。悪意の有無は公開情報から分からないので、断定しません。全文無料です。後半に、知らないプラグイン・フック・MCP サーバーが入っていないかを読むだけで調べるスクリプトの全文を載せました。

    この記事で分かること

    • 報告の中身と Postman 側の発言(原文つき)、公式ドキュメントとの食い違い

    • 時刻・日数の検算と、確定していること・分からないこと

    • 自分の環境を読むだけで調べるスクリプト(全文)

    先に結論

    • 報告の根拠: Issue 本文に Postman 自身のログがあり、"source":"auto-existing-upgrade"、claude-code:installed、codex:installed と記録されています(Postman 12.33.4、macOS)

    • 変わったもの: ~/.codex/config.toml、~/.claude/settings.json、installed_plugins.json、~/.local/bin の Postman の CLI。Cursor は already-installed と記録され、Copilot CLI の設定にも記載があった、という報告が1人ずつ

    • Postman 側とみられる返信: 11月3日 23:36(UTC)の返信は、同梱の理由を「別々に設定するのにつまずく人が多かったから」と説明し、「オプトインをはっきりさせる」「フックの承認を見直している」と述べました。5日 03:46(UTC)の返信(GitHub の表示は組織の MEMBER)は、再設計までの間「この変更を元に戻している」です

    • 食い違い: 公式ドキュメントは「フックは未承認で入る」と「インストーラーがフックを承認する」の両方を書き(別の経路の説明かもしれません)、Postman の公開コミット(11月5日)は「承認を書き込んでいた。それは利用者が決めること」と述べました。それでも npm の latest(0.7.1)には、11月9日の時点で承認のコードが残っていました(11月5日 17:19 の変更はその日の 23:50 に取り消され、0.7.1 はその直後に公開された版です)

    • 分からないこと: 影響人数、アプリの画面に案内が出たか、Windows で起きたか、悪意の有無。報告者自身も、データを外に送ったとは主張していません

    画像

    経緯:10月21日から11月9日まで

    日時は UTC。日本時間は +9 時間
    
    10/21(水) 16:08  公開リポジトリに「Codex のフックを自動承認する」コミット
    10/24(土) 09:34  報告者の Mac で自動インストール(Postman のログ)
    10/25(日) 19:03  Issue #14370 が作られる
    11/03(火) 23:36  Postman 側とみられる返信「オプトインをはっきりさせる」
    11/05(木) 03:46  MEMBER の返信「(再設計までの間)この変更を元に戻している」
    11/05(木) 11:41  Issue が閉じられる
    11/05(木) 17:19  公開リポジトリで「自動承認をやめる」変更(#149。Codex のセッション開始フックをなくす変更を含む)
    11/05(木) 23:50  その変更を取り消す(Revert)。23:55 に npm で 0.7.1 を公開(今の latest)
    11/06(金) 08:25  取り消しを取り消す(Reapply)。15:33 に npm で 0.8.0-rc.0 を公開(next)
    11/09(月) 04:09  私が npm を確認。latest は 0.7.1 のまま

    報告の中身を、原文で確かめる

    根拠は報告者の Mac のログとファイルです。ログは次のとおりです(2026-10-24T09:34:14Z)。Codex の config.toml には、[marketplaces.postman]、[plugins."postman@postman"]、trusted_hash つきの [hooks.state.…] が増えていました。

    PostmanAgentPluginService~install: script completed
    {"source":"auto-existing-upgrade","results":["claude-code:installed","codex:installed"],"installer":"script"}

    フックが読み込ませる文面は、報告者が固定したリンク先(Postman の公開リポジトリ)にあります。API の簡単でない作業の前に postman:api-engineer スキルを読み込め、という指示です。

    Before responding to any non-trivial API engineering task — ... — load the postman:api-engineer skill and follow it.

    同じファイルの終わりには、利用者の指示(AGENTS.md・CLAUDE.md・直接の依頼)が優先する、ともあります。

    電卓で検算した結果

    時刻と日数が矛盾していないかを、Python で確かめました(作業用で非公開)。

    installedAt と、ほぼ同時刻のログ(script completed)の差: 11.808 秒
    Issue 本文の「12:34 Jerusalem time」: 09:34:14 UTC → エルサレム時間 12:34 で一致
    自動インストール → Issue 作成: 1日9時間29分11秒
    Issue 作成 → 最初のコメント: 8日1時間38分20秒
    最初の返信 → 「元に戻している」: 1日4時間9分37秒
    コメント69件(UTC): 11/02 2件・11/03 30件・11/04 25件・11/05 12件 → 11/03 は 30/69 = 43.5%
    10/21 の「自動承認」コミット → 11/05 の「自動承認をやめる」変更: 15日1時間11分

    どの数字も、書かれた日時と矛盾しません。ただし、貼られたログの数字で、元のファイルは見ていません。最後の行は、アプリがそのコミットの版を使っていたか分からないので、日数の差にすぎません。

    論点1:「勝手に入った」と言い切れるか

    言い切れること

    • ログの記録元は auto-existing-upgrade、結果は installed だった、と報告されています

    • 公式ドキュメント(デスクトップアプリのページ)は今、「メニューから選んだときだけ入れる」と書き、「以前に自動で入った場合は削除できる」とも書いています

    • Postman 側とみられる返信は同梱を認め("we bundle the Postman CLI and the agent plugins with the desktop app")、「オプトインをはっきりさせる」、のち「この変更を元に戻している」と述べました

    言い切れないこと

    • 利用者への案内があったか。Postman は、ダウンロードページとアプリの更新の流れで案内したと説明しました。コメントには、アプリ内に確認も設定も見当たらないと書く人もいます(1人)。私は更新画面を見ていません

    • ダウンロードページの一文。Notebookcheck と idlen が伝える「The Postman app includes Postman CLI & Postman plugins」は、私が開いた10月26日のアーカイブと現在の HTML のどちらにも見つかりませんでした。この点は決められません

    論点2:Codex のフック承認は、誰が書いたのか

    Codex の公式ドキュメントには、こうあります。

    Before a non-managed hook can run, Codex requires you to review and trust the exact hook definition.

    (管理対象でないフックは、定義を確認して信頼するまで実行されません。)

    報告の trusted_hash は、その「信頼した」という記録です。報告者は、記録だけでは誰が作ったかは証明できない、と書いています。判断材料は4つです。

    1. Postman の公開コミット(10/21):件名が "auto-approve Postman's Codex hook"。コードのコメントは "Approves only Postman's current hook after installation"

    2. 同(11/5):本文が "The installer wrote trust for Postman's hook into the user's Codex config. The user must make that choice."(インストーラーは信頼を書き込んでいた。それは利用者が決めること)

    3. 公式ドキュメント:デスクトップアプリのページは「フックは未承認で入る」、npx のページは「インストーラーがフックを承認する」。デスクトップアプリのページは、アプリがこれらのエージェントを見つけられない・自分のインストーラーを動かせないときは、npx のインストーラーに切り替わるとも書きます。経路の違いの可能性があり、報告のログがどちらの経路かは分かりません

    4. 別の利用者の Mac(アプリ 12.35.1。11/3 22:58 UTC に自動インストールと報告):hooks.state が無かったと本人が書いています

    私の読みでは、公開コードのある版には、インストーラーが承認を書く処理があったと言えそうです。報告者の Mac で動いた版と同じかは確かめられていません。npm の配布物を読むと、latest の 0.7.1(11月5日 23:55 UTC 公開)には承認のコード(approvePostmanHook)があり、0.7.0 と next の 0.8.0-rc.0 には無いことを確かめました(展開せず読んだだけ)。フックが実際に動いたかは別の話で、私は再現していません。

    論点3:悪意か、設計の甘さか、データは出たか

    分かっていること:追加された MCP の設定は https://mcp.postman.com/mcp を指し、報告者の環境では "Auth required" で失敗していました。

    分からないこと:意図は、3日の返信が「セットアップを簡単にするため」、5日の返信が「案内で意図が伝わると考えたが、そうではなかったと理解した」です。データが出たかは、報告者が「データの持ち出しを立証すると主張するものではない」と書くだけで、私は通信を調べていません。

    私が言えるのは1つです。設定ファイルは、あなたとして動くどのアプリからも書き換えられる、ふつうのファイルです。何が入っているかを自分で一覧できると安心です。

    実例:自分の環境を、読むだけで調べるスクリプト

    Claude Code のプラグインの仕組みは、別の記事(55)に書きました。ここでは ~/.claude/settings.json、~/.claude/plugins/installed_plugins.json、~/.claude.json(MCP の置き場所)、~/.codex/config.toml を読むだけで調べます。[hooks.state] は Issue とコードで見た形で、Codex の公式ドキュメントには見つかりませんでした。

    出すのは名前・種類・日時だけです。コマンドの中身、URL、トークン、ハッシュの値は出さず、ホームのパスも伏せます。書き込みも通信もしません。Python 3.11 以上が必要です。

    # agent_audit.py - 読むだけ。名前・種類・日時だけを出す(コマンド・URL・トークンなどの値は出さない)
    import json, re, sys
    from datetime import datetime
    from pathlib import Path
    
    import tomllib
    
    sys.stdout.reconfigure(errors="replace")
    HOME = Path(sys.argv[1]) if len(sys.argv) > 1 else Path.home()
    CLAUDE, CODEX = HOME / ".claude", HOME / ".codex"
    FLAGS = ("postman",)                       # 目印にしたい語(小文字)
    DATE = re.compile(r"^\d{4}-\d\d-\d\dT[\d:.]{5,14}Z?$")
    VER = re.compile(r"^[0-9A-Za-z.+-]{1,20}$")
    rows = []
    ok = lambda rx, v: str(v) if rx.match(str(v)) else "?"
    stamp = lambda p: datetime.fromtimestamp(p.stat().st_mtime).strftime("%Y-%m-%d %H:%M")
    
    
    def scrub(s, n=90):                        # ホームのパスが混ざっていたら伏せる
        s = str(s)
        for h in {str(HOME), str(HOME).replace("\\", "/")}:
            s = s.replace(h, "~")
        return s if len(s) <= n else s[: n - 3] + "..."
    
    
    def read(p, parse):
        try:
            return parse(p.read_text(encoding="utf-8"))
        except FileNotFoundError:
            return None
        except Exception:                      # 例外の文面には中身が入りうるので出さない
            print(f"  ! {p.name} は読めませんでした")
    
    
    def items(d):                              # 辞書のときだけ (キー, 値)
        return list(d.items()) if isinstance(d, dict) else []
    
    
    def add(where, kind, name, note=""):
        rows.append((where, kind, scrub(name), note))
    
    
    SET = CLAUDE / "settings.json"
    INST = CLAUDE / "plugins" / "installed_plugins.json"
    CJ, CFG, HJ = HOME / ".claude.json", CODEX / "config.toml", CODEX / "hooks.json"
    print("無かったファイル:", ", ".join(scrub(p) for p in (SET, INST, CJ, CFG, HJ) if not p.exists()) or "なし")
    
    W = "Claude Code settings.json"
    s = read(SET, json.loads)
    if isinstance(s, dict):
        add(W, "更新", SET.name, stamp(SET))
        for n, on in items(s.get("enabledPlugins")):
            add(W, "plugin", n, "有効" if on else "無効")
        for ev, g in items(s.get("hooks")):
            add(W, "hook", ev, f"{len(g) if isinstance(g, list) else 1}件")
        for key, kind in (("mcpServers", "mcp"), ("extraKnownMarketplaces", "marketplace")):
            for n, _ in items(s.get(key)):
                add(W, kind, n)
    
    W = "Claude Code installed_plugins.json"   # 名前・範囲・版・入れた日時だけ。installPath は見ない
    ip = read(INST, json.loads)
    for n, recs in items(ip.get("plugins", ip) if isinstance(ip, dict) else None):
        for r in recs if isinstance(recs, list) else [recs]:
            if isinstance(r, dict):
                sc = r.get("scope") if r.get("scope") in ("user", "project", "local") else "?"
                add(W, "plugin", n, f"{sc} / v{ok(VER, r.get('version'))} / 入れた日時 {ok(DATE, r.get('installedAt'))}")
    
    W = "Claude Code .claude.json"             # MCP サーバー。プロジェクトのパスは出さない
    cj = read(CJ, json.loads)
    if isinstance(cj, dict):
        for n, _ in items(cj.get("mcpServers")):
            add(W, "mcp(全体)", n)
        for _, pr in items(cj.get("projects")):
            for n, _ in items(pr.get("mcpServers") if isinstance(pr, dict) else None):
                add(W, "mcp(プロジェクト)", n)
    
    W = "Codex config.toml"
    c = read(CFG, tomllib.loads)
    if isinstance(c, dict):
        add(W, "更新", CFG.name, stamp(CFG))
        for n, v in items(c.get("plugins")):
            en = v.get("enabled") if isinstance(v, dict) else None
            add(W, "plugin", n, "有効" if en is True else "無効" if en is False else "enabled の指定なし")
        for n, v in items(c.get("marketplaces")):
            t = v.get("source_type") if isinstance(v, dict) else None
            add(W, "marketplace", n, t if t in ("git", "local") else "")
        for k, v in items(c.get("hooks")):
            if k == "state":                   # hook を信頼した記録。ハッシュの値は出さない
                for key, st in items(v):
                    add(W, "hook承認の記録", key, "trusted_hash あり" if isinstance(st, dict) and "trusted_hash" in st else "")
            else:
                add(W, "hook", k, f"{len(v) if isinstance(v, list) else 1}件")
        for n, v in items(c.get("mcp_servers")):
            t = "stdio" if isinstance(v, dict) and "command" in v else "http" if isinstance(v, dict) and "url" in v else ""
            add(W, "mcp", n, t)
    hj = read(HJ, json.loads)
    for ev, _ in items(hj.get("hooks") if isinstance(hj, dict) else None):
        add("Codex hooks.json", "hook", ev)
    
    last = None
    for where, kind, name, note in rows:
        if where != last:
            print(f"\n[{where}]")
            last = where
        mark = "   <-- 目印の語を含む" if any(f in name.lower() for f in FLAGS) else ""
        print(f"  {kind}: {name}" + (f"  ({note})" if note else "") + mark)
    hit = sum(any(f in r[2].lower() for f in FLAGS) for r in rows)
    print(f"\n合計 {len(rows)} 行 / 目印の語({', '.join(FLAGS)})を含む名前 {hit} 行")

    agent_audit.py で保存して python agent_audit.py で動かします。次は、Postman が入った状態を真似た偽の見本のフォルダを引数に渡した結果です。

    無かったファイル: ~\.codex\hooks.json
    
    [Claude Code settings.json]
      更新: settings.json  (2026-11-01 09:00)
      plugin: postman@claude-plugins-official  (有効)   <-- 目印の語を含む
      plugin: note-helper@my-market  (有効)
      hook: SessionStart  (1件)
      mcp: fake-db
      marketplace: my-market
    
    [Claude Code installed_plugins.json]
      plugin: postman@claude-plugins-official  (user / v2.0.1 / 入れた日時 2026-11-01T09:00:00.000Z)   <-- 目印の語を含む
      plugin: note-helper@my-market  (user / v1.0.0 / 入れた日時 2026-10-01T03:00:00.000Z)
    
    [Claude Code .claude.json]
      mcp(全体): fake-search
      mcp(プロジェクト): local-tool
    
    [Codex config.toml]
      更新: config.toml  (2026-11-01 09:00)
      plugin: postman@postman  (有効)   <-- 目印の語を含む
      marketplace: postman  (git)   <-- 目印の語を含む
      hook承認の記録: postman@postman:hooks/codex-hooks.json:session_start:0:0  (trusted_hash あり)   <-- 目印の語を含む
      mcp: fake-http  (http)
      mcp: fake-stdio  (stdio)
    
    合計 16 行 / 目印の語(postman)を含む名前 5 行

    読み方です。

    1. 入れた日時(installed_plugins.json の行)に、覚えのない日があれば、そのプラグインを疑います。名前でなく日時で気づけます

    2. hook承認の記録は、Codex でフックを信頼した記録です。覚えのないものは、何のフックかを調べます

    3. 目印の語を含む行は、FLAGS(初期値は postman)を含む名前です。語は足せます

    見本の値は全部ダミーです。偽のトークン・パスワード・ユーザー名・URL・ハッシュ値など 16 個を入れて、どれも出力に出ないことを確かめました(壊れた設定ファイルでも漏れません)。私の PC の本物の設定にも読み取りだけで動かすと、合計 23 行、postman を含む名前は 0 行でした。この PC には Postman のアプリが無い(%LOCALAPPDATA% と %APPDATA% にフォルダが無い)ので、想定どおりです。名前の一覧は個人の環境なので載せません。

    注意点です。プラグインの中身(同梱のフックや MCP)は読んでいません。この表は入口です。CLAUDE_CONFIG_DIR や CODEX_HOME を使う人は、CLAUDE、CODEX の行を書き換えてください。Cursor・Copilot CLI・Postman の CLI(報告では ~/.local/bin)は見ていません。

    見つかったときは、Help メニューの「Postman CLI and Plugins」→「Uninstall Postman Coding Agent Plugin」で削除できる、と公式ドキュメントにあります。ただし Copilot の記載が消えなかったという報告が1件あり、Postman の公開コミット(11/6)には、npx の remove が以前はプラグインの記載しか消さず、配布元の登録とフック承認が残っていた、とあります。削除のあとにもう一度スクリプトを動かして、残りを確かめてください。手で消すなら、先にバックアップを。

    次に見ること

    • Postman の公式の説明(リリースノートは読めず、ブログは見つかりませんでした。製品責任者が広報会社経由で RuntimeWire に同じ趣旨を伝えたと idlen が書いています。RuntimeWire の原文の URL は出典欄に載せていません)

    • npm の latest が 0.8 以降に進むか。公式ドキュメントの食い違いが直るか

    確かめたこと・確かめていないこと

    • 確かめた:Issue 本文とコメント69件の全文(GitHub の API)、Postman 公式ドキュメント2ページ、ダウンロードページ(現在と10月26日のアーカイブ)、公開リポジトリのコミット5件と報告者が固定した版の文面、npm の4つの版の中身、Claude Code と Codex の公式ドキュメント、Notebookcheck の本文、日時の計算、スクリプトの動作

    • 確かめていない:報告の再現(Mac も Postman のアプリもありません)、ログの元ファイル、リリースノート、The New Stack の記事(403 で開けませんでした)、idlen(要約ツール経由で読んだだけ)、Windows での挙動

    • 11月3日の返信の投稿者(zecoquit)は組織のメンバーとは表示されず、社員かは分かりません。5日の投稿者は MEMBER と表示されています

    まとめ

    • 報告では、Postman のログに auto-existing-upgrade で Claude Code と Codex に installed とあります。Postman 側とみられる返信は同梱を認め、5日に「この変更を元に戻している」と述べました

    • 公式ドキュメントの「自動ではインストールしない」と報告は食い違い、Codex のフック承認も、公式ドキュメント・公開コミット・npm の配布物が一致していません

    • 悪意の有無とデータの送信は、公開された範囲では分かりません

    • 次の一歩は、agent_audit.py を1回動かして、覚えのない日時の行がないかを見ることです

    出典


    次に読む

    このアカウントをフォローすると、AI まわりの新しいニュースの整理や、Claude Code・Codex の手順の記事が届きます。ぜひフォローしてください。

    この先で分かること(今後の有料記事)

    • 自分の Claude Code・Codex の設定を毎日自動で点検して、増えたもの・変わったものだけを知らせる仕組み(設計とコード)

    • プラグインやフックを入れる前に、中身を点検するチェックリストと指示文

    • 設定ファイルをバックアップして、元に戻せるようにする手順

    まさのAI実務ラボ|Codex・Claude Code では、有料記事が読み放題になります。テンプレートや指示文をまとめて使いたい方はご覧ください。

    あなたへのおすすめ