$ capsul 用語集
用語集
コーディングエージェントのコストを決める言葉を、まず一文で定義し、そのうえで説明します。
- トークン
- トークンとは、言語モデルが読み取り、課金の単位とするもののことです。よく使われる単語、単語の断片、あるいは句読点にあたり、英語では平均しておおよそ 3 から 4 文字分です。
- コンテキストウィンドウ
- コンテキストウィンドウとは、モデルが一度に考慮できるトークンの最大数のことで、指示、会話、そして質問と一緒に送られるすべてを含みます。
- 入力トークンと出力トークン
- 入力トークンはリクエストでモデルに送られるすべて、出力トークンはモデルが書き返すものです。エージェントの作業では、入力側が請求を 1 桁以上の差で支配します。
- トークン予算
- トークン予算とは、1 回のリクエストに入れてよいコンテキスト量の強制的な上限で、モデルと交渉するのではなく、送る前に適用されるものです。
- プロンプトキャッシュ
- プロンプトキャッシュは、繰り返される前置き部分の処理済みの形をリクエストをまたいで再利用させ、その分のトークンを新規料金の何分の一かで課金する仕組みです。
- キャッシュヒット率
- キャッシュヒット率とは、1 回のリクエストの入力トークンのうち、新規に処理されるのではなくプロンプトキャッシュから供給された割合のことです。
- コンテキストの劣化
- コンテキストの劣化とは、コンテキストが膨らむにつれてモデルの回答が悪くなっていくことです。関連する材料の希釈、新旧の食い違い、積み上がった行き止まりによって起こります。
- エージェントループ
- エージェントループとは、モデルがツールを呼び、結果を読み、次に何をするかを決める、という循環を回答が出るまで繰り返すことです。
- ツール呼び出し
- ツール呼び出しとは、ファイルを読む、コマンドを走らせるなど、モデルが自分の外側で何かを実行させるための構造化された要求で、その結果はコンテキストに戻されます。
- リポジトリマップ
- リポジトリマップとは、コードベースを圧縮した見取り図で、ファイルとそこで定義された記号を並べ、モデルがすべてを読まずに目的の場所を特定できるようにするものです。
- 利用上限
- 利用上限とは、一定の時間枠内に送れる量の上限で、送ったメッセージの数ではなく処理されたトークンで計られます。
- コマンドライン型コーディングエージェント
- コマンドライン型コーディングエージェントとは、あなたが定めた承認ルールのもとで、モデルに作業ディレクトリ内の読み取り、実行、編集を行わせるコマンドラインのプログラムです。
- CLAUDE.md
- CLAUDE.md は、Claude Code が各セッション開始時に読み込む常駐指示の Markdown ファイルで、内容はセッションのすべてのリクエストに含まれます。
- AGENTS.md
- AGENTS.md は、特定の製品ではなく一般的な AI コーディングエージェント向けに書かれた常駐プロジェクト指示の Markdown ファイルで、エージェントは作業開始前にそれをコンテキストにロードします。
- コンテキスト圧縮
- コンテキスト圧縮は、エージェントの会話履歴をモデルが生成した要約に置き換え、長時間のセッションを詳細を犠牲にしてコンテキストウィンドウに収めます。
- サブエージェント
- サブエージェントは、独自のコンテキストウィンドウ、システムプロンプト、ツールアクセスを持つ別個のエージェントインスタンスで、コーディングエージェントがタスクを委譲し、結果の要約だけを受け取ります。
- モデルコンテキストプロトコル (MCP)
- モデルコンテキストプロトコル (MCP) は、AI アプリケーションと外部ツールやデータを接続するためのオープン標準で、サーバーがツール・リソース・プロンプトを公開し、コーディングエージェントなどの互換クライアントが利用できます。
- ツール定義
- ツール定義とは、ツールをモデルに説明する名前・説明・入力スキーマで、クライアントがリクエストに含めた場合に入力として数えられます。
- キャッシュ書き込み
- キャッシュ書き込みとは、再利用のためにプロンプトプレフィックスを処理・保存することで、通常の入力価格より高く課金されますが、以降のリクエストでははるかに安価に読み取れます。
- キャッシュTTL
- キャッシュTTL（有効期間）は、使用されずにキャッシュされたプロンプトプレフィックスが存続できる時間で、期限が切れると次のリクエストで再処理・再キャッシュが必要になります。
- キャッシュ加重入力トークン
- キャッシュ加重入力トークンは、リクエストの入力を新規入力に対する価格比率で重み付けし、フレッシュトークンは1倍、キャッシュ読み取りは0.1倍、キャッシュ書き込みはプレミアム倍率でカウントした指標です。
- API等価コスト
- API等価コストは、セッションのトークン使用量をプロバイダーの公表API価格で換算した金額で、トークン課金されないサブスクリプション上で実行された作業をモデルやワークロード間で比較する指標です。
- タスクあたりコスト
- タスクあたりコストは、開始から完了までの作業単位に要した総費用で、すべてのリクエスト、リトライ、委譲呼び出しを含み、トークン単価や単一リクエストの価格とは異なります。
- システムプロンプト
- システムプロンプトは、モデルへの各リクエストで会話の前に送られる指示ブロックで、モデルの役割と従うルールを設定します。
- トークナイザー
- トークナイザーはテキストをモデルが読み取り課金対象とするトークンに分割するコンポーネントで、同一テキストでもモデルによりトークン数が異なる理由です。
- 拡張思考
- 拡張思考は、モデルが回答前にトークンとして生成する推論で、表示有無に関わらず出力トークンとして課金されます。