pstackをClaude Codeに入れる:公式版と同名の移植版の見分け方

当ページのリンクには広告が含まれています。

Zennのpstack実践ガイドがはてなブックマークで500usersを超え、Claude Codeにpstackを入れる人が増えています。ところがGitHubで「pstack claude」と探すと、作者の違う移植版が10以上出てきます。しかもそのうち2つは、入れたあとの名前がどちらもpstack@pstack-claudeになります。

Lauren Tan(poteto)さんの本家は、Cursorのプラグイン集cursor/pluginsから配られていて、Claude Codeではpstack@cursor-pluginsとして入ります。これから入れるなら、こちらを選んでください。すでにpstack@pstack-claudeが入っているなら、それが誰の版か、版が古いまま止まっていないかを先に確かめます。

実はこのMacにも、10月30日に移植版を入れていました。公式のClaude Code対応から2週間後のことです。11月22日に中身を調べると、移植版は公式版にない指示を毎回会話に足していました。移植版も、一緒に追加していた公式のマーケットプレイスも、3週間前の状態のままでした。

「pstack@pstack-claude」という名前だけでは、誰の版か分からない

Claude Codeのプラグインは「プラグイン名@マーケットプレイス名」で区別されます。マーケットプレイス名は配布する側が自由に付けられます。11月22日に各リポジトリのmarketplace.jsonを取得したところ、Michael Denyerさんのmichael-denyer/pstack-claudeと、Angel Hermonさんのanhermon/pstack-claudeは、どちらもマーケットプレイス名がpstack-claude、プラグイン名がpstackでした。

そのため/pluginの一覧やclaude plugin listには、どちらを入れても同じpstack@pstack-claudeと表示されます。ほかの移植版も、マーケットプレイス名はpstack、open-pstack、pickleboxerとまちまちです。

  • 公式(cursor/plugins):pstack@cursor-plugins、11月19日更新の0.15.46
  • michael-denyer版:pstack@pstack-claude、11月21日更新の0.9.146
  • anhermon版:pstack@pstack-claude
  • ericlitman/open-pstack:pstack@open-pstack、1.21.0

版番号も配布元ごとに独立しています。移植版の0.9系が公式の0.15系より古い、という意味ではありません。どこから入れたかは、ターミナルで次のコマンドを実行するとSource:の行で分かります。

claude plugin marketplace list

このMacではpstack-claudeの下にSource: GitHub (michael-denyer/pstack-claude)と出ました。公式版なら、cursor-pluginsの下にGitHub (cursor/plugins)と出ます。

移植版は起動のたびに982字の指示を会話へ足す。公式版にはその仕組みがない

両者でいちばん違うのは、セッション開始時のフックです。michael-denyer版0.9.112は、起動・再開・/clear・コンパクトのたびにsession-start.shを動かし、「複数ファイルに触れる作業ではpoteto-modeを呼べ」という英語の指示を982字、会話の冒頭に入れます。この記事の材料を集めたClaude Codeのセッションでも、冒頭にこの文が入っていました。

ユーザースコープで入れると、この指示はpstackと関係のないプロジェクトにも毎回入ります。指示には「CLAUDE.mdなど利用者の指示が優先する」とあります。それでも、作業の進め方を変える前提が全プロジェクトに入ること自体は知っておくべきです。

手元にある公式版0.15.36のClaude Code用フォルダには、フックがありませんでした。11月22日時点の公式リポジトリのmainも同じ構成です。公式版では、使いたいときに/pstack:poteto-modeを自分で呼びます。

入れたプラグインが毎回どれだけ足すかはclaude plugin detailsで見られます。移植版では常時約5,676トークンと出ましたが、フックの行には「harness-only — no model context cost」とありました。実際には会話に入る982字は、この数字に含まれていないと読めます。表示だけで判断せず、フックの中身も見てください。

claude plugin details pstack@pstack-claude

移植版のままフックだけ止めるには、~/.claude/pstack-models.mdにsession hook: offの1行を書きます(移植版のsetup-pstackスキルの説明による)。982字はClaude CodeのSessionStart hookの上限1万字よりずっと短く、切り捨てられることはありません。

自動更新はオフのまま。このMacでは3週間前の版で止まっていた

Claude Codeは、Anthropic公式のマーケットプレイス以外を既定で自動更新しません。cursor/pluginsもサードパーティ扱いです。公式版のREADMEにも、入れた版のまま止まると書かれています。

このMacでは10月30日に入れたあと、移植版は0.9.112(最新は0.9.146)、手元の公式マーケットプレイスの複製は0.15.36(最新は0.15.46)のままでした。実践ガイドの筆者が使った0.15.43よりも古い版です。手で更新するなら次のコマンドを使います。/pluginのMarketplacesタブでマーケットプレイスを選べば、自動更新をオンにもできます。

claude plugin update pstack@cursor-plugins

サードパーティのプラグインが古いまま残る問題は、Modern Web Guidanceでも起きていました。自動更新をオンにすると、作者が出した次の版を確認なしで受け取ります。フックを持つプラグインほど、オンにするか手で更新するかを決めてから使ってください。

公式版へ移ると、babysitやfix-ciが使えなくなる

移植版には、公式版のClaude Code用フォルダにないスキルが入っています。手元の0.9.112と0.15.36を比べると、移植版にしかないのは次の10個でした。

  • PRとCIの面倒を見る:babysit、fix-ci、fix-merge-conflicts、get-pr-comments、make-pr-easy-to-review
  • レビューと整理:thermo-nuclear-review、thermo-nuclear-code-quality-review、thermos、deslop
  • 振り返り:what-did-i-get-done

公式版のREADMEは、こうした道具はcursor-team-kitと組み合わせるよう案内しています。ただ、11月22日時点でcursor/pluginsのClaude Code向けカタログに載っているのはpstackとorigin-appsだけで、cursor-team-kitはありません。公式版へ移した人のdotfilesでも、これらのスキルが使えなくなる点が書かれていました。

PRの監視やCI修正をpstackに任せているなら、移植版に残る理由があります。その場合は配布元を確かめたうえで手で更新し、フックの要否を決めます。poteto-modeと原則のスキルだけを使っているなら、公式版に移ってください。

移植版から公式版へ移すコマンド

Claude Codeのプラグインの説明と公式版READMEに沿うと、手順は次のとおりです。このMacでは環境を変えるため実行しておらず、動作は確かめていません。

  1. 移植版を外す(マーケットプレイスを消すと、そこから入れたプラグインもまとめて外れます)
  2. cursor/pluginsを追加して公式版を入れる
  3. Claude Codeで/pstack:setup-pstackを実行し、役割ごとのモデルを選び直す
claude plugin uninstall pstack@pstack-claude
claude plugin marketplace remove pstack-claude
claude plugin marketplace add cursor/plugins
claude plugin install pstack@cursor-plugins

移植版のために~/.claude/pstack-models.mdを作っていた場合、それを読むのは移植版のフックとスキルです。手元の公式版0.15.36のsetup-pstackは別のファイルに書くため、移したあとは古いファイルを残しても効きません。

実践ガイドの「寝てる間に動く」部分は、pstackの機能ではありません。筆者がClaude Codeをclaude -pで無人実行して実現したものです。決まった時刻に動かす部品の選び方は、Claudeで常時稼働エージェントを作る記事で比べています。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

IT業界で10年、ソフトウェア開発をしてきたエンジニアです。今もChatGPT、Codex、Claude Codeを中心に、開発の効率化や生産性向上にAIをフル活用しています。応用情報技術者。登壇や執筆もしています。このサイトでは、仕事でAIを使う立場から、料金や利用条件、使い方を調べてまとめています。

目次