スキルとプラグインは毎ターンどれくらいトークンを消費する?
毎ターン送られるのは各スキルの名前と説明だけで、全文ではありません。6 つのスキルを含むプラグイン 1 つの実測値は、1 ターンあたり約 221 トークンでした。全文は、そのスキルを使うときに読み込まれます。Claude Code は、プラグインごとの 1 ターンあたりの追加分を /usage に表示します。Codex も仕組みは同じですが、スキルごとの数値は表示しません。
Codex
仕組みは同じです。最初に持つのは名前、説明、ファイルパスだけで、選ばれたスキルだけ全文を読みます。Codex はスキルごとのトークン数を表示しません。
最初のスキル一覧が使うのは、最大でコンテキストウィンドウの 2%(ウィンドウの大きさが分からないときは 8,000 文字)です。スキルを多くインストールしていると、Codex はまず説明を短くし、それでも足りなければ一部のスキルを一覧から外して警告を表示します。スキルを選ぶと、SKILL.md の全文を読みます。Codex CLI の /usage は、トークンを日別・週別・累計で表示し、スキルごとには分けません。持ち運ぶ量を減らすには、~/.codex/config.toml で使わないスキルを無効にします。
公式ドキュメントの記載
Skills use progressive disclosure to manage context efficiently. ChatGPT and Codex start with each skill's name and description, then load the full SKILL.md instructions when they decide to use that skill. In Codex, the initial list also includes each skill's file path.To avoid crowding out the rest of the prompt, this list uses at most 2% of the model's context window, or 8,000 characters when the context window is unknown. If many skills are installed, Codex shortens skill descriptions first. For large skill sets, Codex may omit some skills from the initial list and show a warning./usage — View account token usage or use a rate-limit reset. Inspect daily, weekly, or cumulative ChatGPT token activity from inside the TUI.Claude
毎ターン送られるのは、各スキルの名前と説明だけです。/usage で、プラグインごとの 1 ターンあたりの追加分を確認できます。
Claude Code は、すべてのスキルの名前と説明を 1 つの一覧にして、システムプロンプトに入れます。使っても使わなくても、すべてのメッセージがこれを持ち運びます。2 ターン目以降は、キャッシュ用のレートで読み直されます。一覧の上限はコンテキストウィンドウの 1%、スキル 1 つの説明の上限は 1,536 文字で、上限を超えると、呼び出しの少ないスキルから順に説明が省かれます。SKILL.md の全文が読み込まれるのはスキルが呼び出されたときだけで、読み込まれた後は会話に残り、その後の毎ターンで読み直されます。
公式ドキュメントの記載
In a regular session, skill descriptions are loaded into context so Claude knows what's available, but full skill content only loads when invoked.Every skill in the skill listing adds to your context on every turn, whether or not Claude ever uses it. Run /skill-doctor to see what each of your skills costs and how often it gets used, so you can decide which ones to turn off.The budget scales at 1% of the model's context window. When the listing overflows, Claude Code drops descriptions starting with the skills you invoke least, so the skills you use most keep their full text.Skills load on-demand only when invoked, so moving specialized instructions into skills keeps your base context smaller./usage のプラグインの行
Claude Code で /usage を実行し、Plugin skill-listing footprint という行を探します。プラグインごとに、スキルの数と 1 ターンあたりのコストが表示されます。たとえば diagram-design 6 skills · ~221 tok/turn。この数値は実測したプラグイン 1 つの例で、平均ではありません。
/usage のパネルは、この行を次のように説明しています。「What each plugin's skill descriptions add to the system prompt (cached input after the first turn). Agents and MCP tools not yet counted.」(各プラグインのスキルの説明がシステムプロンプトに追加する量。2 ターン目以降はキャッシュされた入力として数える。エージェントと MCP ツールはまだ含まない)。この文はパネルのもので、公式ドキュメントのものではありません。プラグインに同梱されているエージェントと MCP ツールの分は、表示される数値とは別にかかります。
使わないスキルをオフにする
オフにしたスキルは、毎ターン説明を追加しなくなります。オフにする方法は、そのスキルの入手元によって違います。
Claude Code、プラグインのスキル:/plugin disable プラグイン名@マーケットプレイス名 を実行するか、/plugin の Installed タブで操作します。プラグインのスキルは、この方法でしかオフにできません。
Claude Code、自分で入れたスキル:/skills を開き、スキルを選んで Space で状態を切り替え、Esc で保存します。name-only は名前だけを残し、off はスキルを完全に隠します。
Claude Code、手動でしか起動しないスキル:SKILL.md の先頭に disable-model-invocation: true を追加します。説明が毎ターン持ち運ばれなくなります。
Codex:~/.codex/config.toml に [[skills.config]] の項目を追加し、path = "/path/to/skill/SKILL.md" と enabled = false を書いてから、Codex を再起動します。
公式ドキュメントの記載
Plugin skills are not affected by skillOverrides. Manage those through /plugin instead.Use [[skills.config]] entries in ~/.codex/config.toml to disable a skill without deleting itよくある誤解
- スキルを 50 個入れると、毎ターン 50 個分の全文が読まれる
読まれません。毎ターン送られるのは名前と説明だけで、6 つのスキルの実測値は合計で約 221 トークンでした。全文が読み込まれるのは、そのスキルが使われたときだけです。
- スキルの説明は詳しいほどよい
違います。説明は毎ターン持ち運ばれる部分で、しかも切り詰められます。Claude Code はスキル 1 つあたり 1,536 文字まで、一覧全体でコンテキストウィンドウの 1% まで、Codex は一覧全体で 2% までです。主な用途とトリガーになる言葉を最初に書き、短く保ちましょう。
- 一度実行したスキルは、もうトークンを使わない
いいえ、使い続けます。スキルの全文は読み込まれた後も会話に残り、その後の毎ターンで読み直されます。Claude Code がセッションを圧縮した後も、呼び出された各スキルは最初の 5,000 トークンを保持します(合計で最大 25,000)。タスクを変えるときは、新しいセッションを始めましょう。
ヒント
- Claude Code:/usage を実行し、Plugin skill-listing footprint の行を見ます。1 ターンあたりのトークンがいちばん多いプラグインから手を付けましょう。
- Claude Code:/skill-doctor を実行します(v2.1.252 以降)。一度も呼び出されていないスキルと、最近使っていないプラグインに印が付きます。/context の Skills の行は、一覧全体の現在の大きさです。
- スキルを実行した後で別のタスクに移るときは、/clear を使います(Codex は /new)。そうするまで、スキルの全文はセッションに残り続けます。