本文へスキップ
hdknr blog
戻る

claude -p の入力トークンを実測 — Claude Code の既定 1 万前後を --bare で約 700 に減らす

Claude Code の非対話モード claude -p は、スクリプトやジョブから「小さな判断を頼む関数」として呼びたくなる(自動化から呼ぶ例は claude -p をローカル文脈で動かす記事を参照)。たとえば、JSON Schema で形を決めた計画や分類を返させる使い方だ。ところが claude -p は Claude Code そのものなので、プロンプトを短くしても、Claude Code 自身のシステムプロンプトや、設定から読み込まれる情報が毎回一緒に送られる。

本記事では、その「毎回必ず送られる入力(固定分)」がどれくらいあるのかを、オプションを変えながら実測した。わかるのは次の 4 点だ。

claude -p の入力トークンの測り方と測定条件

数百トークン程度の「計画を JSON で返す」プロンプトを用意し、オプションだけを変えて呼んだ。

オプション別の実測結果:既定は 1 万前後、--bare で約 700

呼び出し方入力トークン
既定(リポジトリ内)13,417
既定(空のディレクトリ)8,566
--system-prompt で既定のシステムプロンプトを差し替え14,421
--strict-mcp-config(MCP サーバーを読み込まない)11,712
--setting-sources ""(ユーザー・プロジェクト・ローカルの設定ファイルを読み込まない)6,490
--setting-sources "" と --strict-mcp-config6,490
--setting-sources "" と --strict-mcp-config と --system-prompt4,077
--bare(apiKeyHelper で認証)695
--bare と --system-prompt651

apiKeyHelper は、API キーを返すスクリプトを指定する設定項目だ(詳しくは後述)。表から読み取れることは 4 つある。

数値は、使っている人の設定・プラグイン・MCP サーバーの数によって大きく変わる。自分の環境で測ってから決めたい。応答を JSON で保存し、jq で usage を読めば測れる(条件をそろえるなら --json-schema も付ける)。

claude -p "(自分のプロンプト)" --output-format json --tools "" > out.json
jq '.usage.cache_creation_input_tokens + .usage.cache_read_input_tokens' out.json

プロンプトキャッシュで費用はさらに変わる

費用にはもう 1 つ大きな要因がある。プロンプトキャッシュだ。同じ呼び出しを 2 回続けて実行すると、2 回目は入力がキャッシュから読まれて安くなった。金額は、応答の total_cost_usd に出る推定値だ。既定の行はサブスクリプションで認証した呼び出しなので、この額がそのまま請求されるわけではない。--bare の行は API の利用として課金される額の目安になる。

呼び出し方1 回目2 回目(キャッシュあり)
既定(リポジトリ内)約 0.055 ドル約 0.003 ドル
--bare約 0.0033 ドル約 0.0016 ドル

キャッシュがない 1 回目では、既定と --bare の差は約 17 倍ある。キャッシュに乗った 2 回目では、差は約 2 倍まで縮む。同じ形の判断を何度も呼ぶ自動化では、固定分を削ることと、固定分を毎回同じに保ってキャッシュに乗せることの両方が効く。キャッシュが効きやすいのは固定部分を毎回同じにしたときだ(CLAUDE.md の部分英語化でキャッシュを効かせる記事、Claude Code の既定設定とトークンの記事も参考になる)。

claude -p —bare の認証(apiKeyHelper)と課金の注意

認証と課金が変わる

--bare では、Anthropic への認証は ANTHROPIC_API_KEY か、--settings で指定する apiKeyHelper だけになる(claude --help の説明による)。サブスクリプションの OAuth やキーチェーンは読まれない。つまり、呼び出しはサブスクリプションの枠ではなく、API キーを発行した Claude Console 上の組織の API 利用として課金される。

Team プランと Max プランなら、毎月の API クレジットを充てられる。Console の組織を紐付けておけば、その組織の API キーでの利用がクレジットから引かれる。クレジットは翌月に繰り越されず、Team プランは席数分を合算して月 500 ドルが上限だ。対話で使う Claude Code の利用はクレジットの対象外になる(Monthly API credits for Max and Team plans)。

—bare で「Not logged in」になるときは apiKeyHelper を使う

公式ドキュメントでは、--bare のときは ANTHROPIC_API_KEY を環境変数で設定するのが標準の手順になっている。ところが手元では、環境変数だけで渡すと「Not logged in」で失敗し、同じキーを apiKeyHelper からも返すようにすると動いた。

キー自体は、API の token counting エンドポイントで有効だと確かめてある。原因は特定できていない。なお、キーはチームに変換した Console の組織で発行したもので、先頭が sk-ant-api ではなかった。

apiKeyHelper には、キーを標準出力に返すだけのスクリプトを指定する。キーそのものは権限 600 のファイルに置き、スクリプトには実行権限を付けておく。

#!/bin/sh
# key_helper.sh(chmod 700)。キーは ~/.config/anthropic/api_key(chmod 600)に置く
cat "$HOME/.config/anthropic/api_key"

呼び出しは次のようになる。/path/to/key_helper.sh は、上のスクリプトの絶対パスに置き換える。$SCHEMA には、返してほしい形を表す JSON Schema を入れる。

SCHEMA='{"type":"object","properties":{"done":{"type":"boolean"},"steps":{"type":"array"}},"required":["done","steps"]}'
claude -p "(判断を頼むプロンプト)" --bare --settings '{"apiKeyHelper": "/path/to/key_helper.sh"}' \
  --output-format json --json-schema "$SCHEMA" --tools ""

本番ではキーを置かない構成も検討する

サーバーで動かすなら、キーのファイルはシークレットマネージャーに置き換えたい。AWS や Google Cloud、GitHub Actions などの上なら、Claude Console の Workload Identity Federation で、長期の API キーを置かずに済ませる手もある。ただし、claude -p --bare と組み合わせて動くかどうかは確かめていない。

claude -p・—bare・Messages API の使い分け

--bare で固定分を 700 程度まで削るなら、Messages API や Claude Agent SDK を直接呼ぶのも手だ。claude -p --bare には、--json-schema による出力の検証や、CLI 1 行で呼べる手軽さが残る。

まとめ

参考



前の記事
AI 時代にこそ効くエクストリーム・プログラミング(XP)— 27 年前の価値・原則・実践を読み直す
次の記事
「従業員なしで会社を立ち上げるマニュアル」の中身 — Anthropic の Routines ワークショップを読み解く