Claude Codeのプロンプト提案とクレジット消費|止め方・法人の確認点【2026年10月】

公開日: 2026年10月20日 最終更新: 2026年10月20日
【結論】Claude Codeのプロンプト提案とは、返答のあと次に打てそうなプロンプトを灰色の候補として出す機能です。候補の生成はバックグラウンドで走り、プランの使用量上限やAPI費用に計上されます。
- 公式ドキュメントは、提案が会話のプロンプトキャッシュを再利用する短いリクエストで、追加コストは小さい、と説明する
- changelog 2.1.302は、プランがクレジットでのみ払うモデルについて、クレジット課金された返答のあとに提案がクレジットを消費していた問題を修正した(クレジット課金後はスキップ)
- 止め方は
/configの「Prompt suggestions」オフ、または設定のpromptSuggestionEnabled: false。組織では managed settings で固定できる
この記事は開発リーダー・情シス向けに、公式ドキュメントとchangelogだけを手順に落とします。二次報告の「週上限の○%」といった未検証の割合は書きません。モデル階層の比較はAIモデルの使い分け、公開前の秘密情報チェックは公開前セキュリティチェックを参照してください。
この記事で分かること:提案の公式説明/使用量・クレジットと2.1.302/オフ手順(個人・組織)/法人が先に決めること。
プロンプト提案とは(公式)
Claude Code Docs「Interactive mode」の Prompt suggestions 節によると、Claudeの返答のあと、会話履歴をもとに次のプロンプト候補を出します。生成は、セッションが使っているモデルへの短いバックグラウンドリクエストです。会話のプロンプトキャッシュを再利用するため、多くはキャッシュ読取とわずかな出力トークンになり、追加コストは小さい、と公式は書いています。
提案をスキップする条件の例(公式):
- プロンプトキャッシュが冷えているとき(不要なコストを避けるため)
- 直前の返答がエラーのとき
- プランモード中
- アカウントが使用量上限に近い、または達しているとき
出典:Claude Code Docs「Prompt suggestions」(2026年10月20日確認)
クレジット消費と 2.1.302 の修正
Claude Code changelog の 2.1.302 には、次の修正が載っています。
Fixed prompt suggestions spending usage credits on models your plan pays for only with credits: they are now skipped after a reply billed to credits
要約すると、プラン上クレジットでのみ支払うモデルについて、クレジットに課金された返答のあとに出る提案が、クレジットを消費していた。修正後は、そうした返答のあとは提案をスキップする、という意味です。
同じ系統で、モデル切替時に前モデルの要約でクレジットが先に使われるケースも、近接バージョンで修正されています(changelog)。数字の規模や返金の有無は公式が公表していないため、本記事では断定しません。
| 状況 | 提案と課金の関係(公式ベース) |
|---|---|
| 通常のプラン使用量 | 提案の短いリクエストも使用量上限に計上され得る |
| クレジット課金後の返答(修正前) | 提案がクレジットを追加消費し得た(changelog が修正対象にした経路) |
| クレジット課金後の返答(2.1.302以降) | 提案はスキップされる |
| APIキー課金 | クレジット経路とは別。トークン課金として扱う |
出典:Claude Code Docs「Changelog」2.1.302(2026年10月20日確認)
実務の読み方は次のとおりです。
- 提案は「無料のおまけ」ではなく、使用量またはAPI費用の枠に入る
- クレジットをONにしているチームは、バージョンと提案のオンオフをセットで確認する
- APIキー課金の利用では、クレジットの話とは別経路になる(トークン課金)
止め方(公式どおり)
Interactive mode の案内では、次のいずれかで提案を完全に止められます。
/configで Prompt suggestions をオフにするsettings.jsonに"promptSuggestionEnabled": falseを書く- 環境変数
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
組織全体で止める場合は、managed settings で promptSuggestionEnabled を false にし、あわせて managed の env に CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false を置くと、個人の環境変数で再有効化しにくくなります(公式)。
| 範囲 | 手段 | 用途 |
|---|---|---|
| 個人 | /config または settings.json |
自分の端末だけ止める |
| 個人(環境変数) | CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false |
シェルやCIの起動単位で止める |
| 組織 | managed settings + managed env |
個人設定で戻しにくくする |
出典:同「Turn prompt suggestions off」節/Managed settings
法人が先に決めること
| 項目 | 決める内容 |
|---|---|
| 既定の提案 | 社内標準はオンかオフか。クレジット利用者はオフを標準にするか |
| バージョン | 誰が Claude Code を更新するか。古いチャネル固定の有無 |
| クレジットの承認 | 誰が usage credits をONにできるか。上限とアラート |
| 計測 | /usage や管理画面で、想定外の伸びを誰が見るか |
料金プラン自体の比較は Claude Code 料金・プラン を参照してください。ツール比較はClaude Code/Cursor/Codex比較です。
よくある質問(FAQ)
Q1. プロンプト提案は無料ですか?
いいえ。公式は、バックグラウンドの短いリクエストがプランの使用量上限またはAPI費用に計上される、と書いています。追加は小さい、とも書いていますが、ゼロではありません。
Q2. 2.1.302 を入れればクレジットはもう減りませんか?
提案がクレジット課金後にクレジットを消費する経路は、changelog上修正されています。通常の会話・ツール実行のクレジット/使用量は別です。更新と設定の両方を確認してください。
Q3. 組織で一括オフできますか?
はい。managed settings で promptSuggestionEnabled と環境変数を固定する方法が公式にあります。
Q4. 印刷モード(claude -p)でも提案が出ますか?
Interactive mode の節では、print モードでは既定で候補を生成しない、と関連ドキュメント側でも整理されています。運用前に自環境で確認してください。
Q5. 提案をスキップする条件は何ですか?
公式の例では、プロンプトキャッシュが冷えているとき、直前の返答がエラーのとき、プランモード中、使用量上限に近い/達しているときなどです。
Q6. APIキー課金でも同じですか?
いいえ。changelogのクレジット修正は、プラン上クレジットでのみ払うモデル向けの話です。APIキー課金はトークン課金として別経路で見てください。
Q7. バージョンが古いと何が起きますか?
2.1.302未満では、クレジット課金後の提案がクレジットを消費する経路が残り得ます。更新担当とチャネルを決めてください。
Q8. 相談できますか?
はい。AIシステム・AIエージェント開発支援/お問い合わせから相談できます。
参考文献・出典
- Claude Code Docs「Interactive mode — Prompt suggestions」
- Claude Code Docs「Changelog」(2.1.302)
- Claude Code Docs「Manage costs effectively」
- Claude Code Docs「Managed settings」
本記事は2026年10月20日時点の公式公開情報に基づきます。バージョン・既定値・料金は更新され得るため、最新は公式ドキュメントをご確認ください。攻撃手順や未検証の課金割合は扱いません。
x3d株式会社では、本記事で解説したClaude Codeの利用設定・クレジット管理に関する企業研修・導入支援を提供しています。
まずはお気軽にご相談ください。
関連:Claude Code/Cursor/Codex比較 / Claude Code 料金 / エンジニア・PM育成研修
