この記事の日付について。 2026年9月17日に調査・執筆し、公開日の2026年10月4日に、料金プラン・Remote Control の開始方法・権限モードの既定・チェックポイントの制限・費用目安の定義・用語集（英語版）を一次資料で再確認して更新しました。本文中の「2026-09-17確認」は執筆時、「2026-10-04確認」は公開前の再確認の日付です。筆者環境の計測値は、断りがない限り2026年9月17日の記録です。2026年10月11日に第7節・第8節・第9節の「無料で使えるか」・よくある質問3項目を追記しました（「2026-10-11確認」はその日の確認です）。
この記事でわかること
- Claude Code がモデルそのものではなく、モデルにツール・コンテキスト管理・実行環境を与える「ハーネス」だということ
- 入口（サーフェス）が5つ、実行環境の公式の区分が3つあり、その2つが別の軸だということ
- 収集・実行・検証の3フェーズで何が起きているか、ツールの5分類とあわせて
- 公式が示す費用目安の数字が「誰の・何の」平均なのか、サブスクリプション利用者にとって何を意味しないのか
- できないこと、戻せないこと、権限モードで止められる範囲
最初の問いに先に答えます。Claude Code とは、Claude というモデルを動かす側の仕組みです。公式用語集は agentic harness を「言語モデルを有能なコーディングエージェントに変える、ツール、コンテキスト管理、実行環境」と定義し、続けて「Claude Code はハーネスです。Claude はその中のモデルです」と書いています（Claude Code 用語集 2026-09-17確認）。
ツールを使わずテキストだけを返す対話との差はここに集約されます。テキストだけの対話なら、提案を適用するのは人間です。Claude Code はファイルを読み、編集し、シェルコマンドを実行し、テストを走らせて結果を確認します。同じ Claude でも、周りに何を持たせるかが違います。
1. Claude Code とは──定義を1文で
Claude Code は agentic coding ツールで、コードベースを読み取り、ファイルを編集し、コマンドを実行し、開発ツールと統合します。ターミナル、IDE、デスクトップアプリ、ブラウザで利用できます。 （Claude Code 概要 2026-09-17確認）
この定義文には「ターミナル」の語が入っていますが、ターミナル専用とは書かれていません。同じ文にデスクトップアプリとブラウザが並んでいます。ただし公式内部でも書き方は一様ではなく、「Claude Code の仕組み」ページの冒頭定義は「Claude Code はターミナルで実行される agentic アシスタントです」とターミナル起点で書かれています（Claude Code の仕組み 2026-09-17確認）。入口の広さを示しているのは概要ページの定義文のほうで、2ページで粒度が違うと理解しておくのが正確です。
関連して、公式用語集は agentic coding（エージェンティックコーディング）を「AI がファイルを読み取り、コマンドを実行し、自律的に変更を加えることができるワークフロー」と定義しています。英語版の同じ項は、これをテキストだけで応答するチャット型アシスタントと対比しています。そちらでは、返ってきたテキストを人間が自分で適用する必要があります（Claude Code 用語集 英語版 2026-10-04確認）。日本語版の訳文はこの対比の主語が読み取りにくいため、英語版に沿って要約しました。Claude Code が agentic なのは、助言に加えて行動できるツールを持っているから、という説明です。
2. チャット型の AI と何が違うのか
公式ドキュメントの記述から、差が出る観点を4つに整理します。
| 観点 | ツールを使わないテキスト対話 | Claude Code |
|---|---|---|
| 出力 | テキストで助言する。適用は人間が行う | ツールを呼んで実際に編集・実行する |
| 見える範囲 | 貼り付けた内容と添付ファイル | 作業ディレクトリとサブディレクトリ、許可した他の場所、git の状態 |
| 手元のファイル | 変えない | 変える。ファイル編集ツールによる変更は Esc 2回で巻き戻せる（Bash 経由などは対象外） |
| 検証 | 人間がテストを走らせる | テストスイートやビルドを自分で実行し、結果を見て修正を反復する（成功の保証ではない） |
公式の「Claude Code の仕組み」ページは、Claude がアクセスできるものとしてプロジェクトのファイル、ターミナル（実行できるあらゆるコマンド）、git の状態、CLAUDE.md、自動メモリ、設定した拡張機能を列挙しています。そのうえで「これは現在のファイルのみを見るインラインコードアシスタントとは異なります」と明記しています（Claude Code の仕組み 2026-09-17確認）。
この表の左列は、Claude アプリ全体ではありません。料金ページによると、Claude アプリ自体も Free プランからコード実行によるファイルの作成・編集と、コネクタによる外部アプリ接続を備えています（Claude 料金プラン 2026-10-04確認）。ここで比べているのは、ツールを使わずテキストだけを返す対話です。
なお、他のコーディングエージェントとの比較はこの記事の範囲外です。Codex CLI や Gemini CLI との違いはAIコーディングエージェント比較記事にまとめてあります。
3. 一次資料の対応表と確認日
この記事は GPU を使いません。Claude Code はクラウド上のモデルを呼ぶため、ローカル GPU も VRAM も必要としないからです。したがって検証環境表の代わりに、記事中の主張がどの一次資料に紐づくかの対応表を置きます。
| 主張 | 一次資料 | 種別 | 確認日 |
|---|---|---|---|
| Claude Code はハーネスであり、Claude はその中のモデル | 用語集 agentic harness | 公式ドキュメント | 2026-09-17 |
| 収集・実行・検証の3フェーズ、ツールの5分類 | Claude Code の仕組み | 公式ドキュメント | 2026-09-17 |
| 全サーフェスが同一エンジンに接続する旨（入口5種は用語集 surface の数え方。仕組みページのインターフェース一覧は Slack・CI/CD などを含む7項目） | 概要 | 公式ドキュメント | 2026-09-17 |
| 実行環境3区分（ローカル / クラウド / リモートコントロール） | Claude Code の仕組み | 公式ドキュメント | 2026-09-17 |
クラウドセッションは手元の ~/.claude/ を読まない | 用語集 surface | 公式ドキュメント | 2026-09-17 |
| 1人の利用日あたり約13ドル、月150〜250ドル、90%が利用日あたり30ドル以下 | コストを効果的に管理する | 公式ドキュメント | 2026-09-17 |
| 有料プランに Claude Code が含まれる | 料金プラン | 公式ページ | 2026-09-17 |
| Enterprise の料金表示、Claude アプリのコード実行・コネクタ | 料金プラン | 公式ページ | 2026-10-04 |
| Remote Control の開始方法（CLI・Desktop・VS Code） | Remote Control | 公式ドキュメント | 2026-10-04 |
| auto が開始モードになる条件（v2.1.283以降） | 権限モード | 公式ドキュメント | 2026-10-04 |
| チェックポイントで戻せない変更 | Checkpointing | 公式ドキュメント | 2026-10-04 |
実測については、claude --version と /usage の実出力は本記事に掲載していません。第9節に載せる手元の値は、シェルコマンドではなくファイル一覧ツールとファイル読み取りツールで列挙・計数したものです。バージョン依存の挙動は、公式が明記しているバージョン要件をそのまま引用します。
4. 仕組み：収集・実行・検証の3フェーズ
公式は agentic loop を「コンテキストを収集し、アクションを実行し、結果を検証し、完了するまで繰り返す」サイクルと定義しています。ループを駆動するのは、推論するモデルと、行動するツールの2つです。
ツールは5つのカテゴリに分かれます。
- ファイル操作 — ファイルの読み取り、コード編集、新規作成、名前変更と再編成
- 検索 — パターンでファイルを検索、正規表現でコンテンツを検索、コードベースの探索
- 実行 — シェルコマンド実行、サーバー起動、テスト実行、git 操作
- ウェブ — ウェブ検索、ドキュメント取得、エラーメッセージ検索
- コードインテリジェンス — 編集後の型エラー表示、定義へのジャンプ、参照検索（コードインテリジェンスプラグインが必要）
5番目だけプラグイン前提である点は見落とされがちです。プラグインが無い状態ではこの専用機能によるシンボル単位の移動は使えず、テキスト検索などで代用されます。
公式は「失敗しているテストを修正して」と頼んだときの呼び出し列を例示しています。テストスイートを実行 → エラー出力を読む → 関連ソースを検索 → ファイルを読む → 編集 → 再度テスト実行、という6ステップです。各ツール使用の結果が次の判断材料になり、Claude は数十のアクションを連鎖させ、途中で軌道修正します。
ここが「なぜプロジェクト全体を触れるのか」の答えでもあります。1回の応答で完結させず、検索と読み取りを何度も挟めるからです。逆に言えば、読み取ったファイルの内容はコンテキストウィンドウを消費します。容量が迫ると古いツール出力の削除と会話の要約が行われ、サブエージェントは独自のコンテキストウィンドウで作業します（Claude Code 用語集 英語版 2026-10-04確認）。
5. 入口は5つ、実行環境の区分は3つ
入口とコードが動く場所は別の軸だという整理は、公式側で既に明示されています。「Claude Code の仕組み」ページは「環境とインターフェース」の節で実行環境3種とインターフェースの一覧を並記し、導入文で「変わるのは、コードが実行される場所とそれとの相互作用方法です」と書いています（Claude Code の仕組み 2026-09-17確認）。
| 入口（サーフェス） | ローカル実行 | クラウド実行 | リモートコントロール |
|---|---|---|---|
| ターミナル CLI | 既定。手元の CLAUDE.md と設定を読む | claude --cloud で送出 | claude --remote-control や /remote-control で有効化 |
| VS Code 拡張 | 手元の CLAUDE.md と設定を読む | — | /remote-control で有効化 |
| JetBrains プラグイン | CLI 必須。手元の設定を読む | — | — |
| デスクトップアプリ | 手元の CLAUDE.md と設定を読む | アプリからクラウドセッションを開始可能 | ローカルセッションで /remote-control |
| claude.ai（Web） | — | リポジトリの新しいクローンから開始 | ブラウザが操作、実行はマシン側 |
Remote Control の公式ページは、開始手段として CLI・デスクトップアプリ・VS Code 拡張を挙げています（Remote Control 2026-10-04確認）。表の「—」は、公式の開始手順に記載が無いことを示します。なお /desktop はターミナルのセッションをデスクトップアプリに引き継ぐコマンドで、Remote Control の有効化とは別物です（概要 2026-09-17確認）。
この表で押さえるべき列は「手元の設定が読まれるか」です。公式用語集は surface の項で「マシン上のセッションはローカルの CLAUDE.md、設定、スキルを読み取ります」と書き、続けて「cloud sessions はリポジトリの新しいクローンから開始され、マシン上の ~/.claude/ を読み取りません」と明記しています。つまり、ユーザースコープの ~/.claude/CLAUDE.md に書いたルールはクラウドセッションには効きません。リポジトリにコミットした CLAUDE.md は、クローンに含まれるので読み込まれます。
リモートコントロールは3列目とも違います。用語集の定義は「ローカル Claude Code セッションを電話またはブラウザから claude.ai 経由で続行する方法」で、「コード実行とファイルはマシンに留まります。インターフェースはリモートです」とあります。ブラウザから触っていても、動いているのは手元のマシンです。つまり3区分は公式の概念上の分け方で、コードが動く物理的な場所が3つあるという意味ではありません。
実行環境そのものの公式の整理は3行です。ローカルは「マシン」で「ファイル、ツール、環境への完全なアクセス」、クラウドは「Anthropic 管理 VM、またはセルフホスト環境（組織が運用）」で「タスクをオフロード、ローカルにないリポジトリで作業」、リモートコントロールは「マシン、ブラウザから制御」で「ウェブ UI を使用しながら実行とファイルをローカルに保つ」。
そして概要ページには「各サーフェスは同じ基盤となる Claude Code エンジンに接続するため、repo の CLAUDE.md ファイル、設定、MCP サーバーはすべてのサーフェスで機能します」とあります。エンジンは共通、読まれる設定の範囲は実行環境で変わる、という二段構えです。
6. できること──任せられる作業の型
概要ページが挙げる用途を、依頼の粒度で並べ替えます。
- 後回しにしている雑務 — テストが無いコードへのテスト作成、プロジェクト全体のリントエラー修正、マージコンフリクト解決、依存関係の更新、リリースノート作成
- 機能追加とバグ修正 — エラーメッセージを貼るか症状を説明すると、コードベース全体で問題を追跡し、根本原因を特定して修正する
- コミットと PR — 変更のステージング、コミットメッセージ作成、ブランチ作成、プルリクエストのオープン。CI 側は GitHub Actions や GitLab CI/CD で自動化できる
- MCP による外部接続 — Model Context Protocol（MCP）で Google Drive のドキュメント読み取り、Jira のチケット更新、Slack からのデータ取得などをつなぐ
- 並行実行 — 複数エージェントの生成、複数セッションの並行監視、Agent SDK による独自エージェントの構築
MCP は入れれば入れるほど良いものではありません。現在はツール定義が既定で必要時まで読み込まれませんが、ツール名とサーバーの指示は最初からコンテキストに入ります（コスト管理 英語版 2026-10-04確認）。そのため公式は未使用サーバーの無効化と、gh や aws のような CLI ツールの優先を勧めています。どのサーバーを入れるかの判断基準はMCPサーバーの選び方の記事に分けてあります。
逆に、できないことも公式は明示しています。チェックポイントが戻すのはファイル編集ツールによる変更と会話で、「リモートシステム（データベース、API、デプロイメント）に影響するアクションはチェックポイントできません」。またチェックポイントは git とは別の仕組みで、Bash ツール経由で行われた変更は追跡せず、復元はシンボリックリンクとハードリンクされたファイルをスキップします。通常のサブエージェントによる編集も巻き戻しでは復元されず、公式は git での取り消しを案内しています（Checkpointing 2026-10-04確認）。
7. 自動化とガードレール──Hooks・Skills・サブエージェント・自動モード
第6節の作業を毎回手で指示せずに回す仕組みと、任せる範囲を絞る仕組みは、公式ドキュメントでは別々の機能として用意されています。名前は公式ページの表記のままです。
| 機能 | 何をするか | 使いどころの例 |
|---|---|---|
| Hooks | 決まった時点でシェルコマンドを実行する（モデルの判断を通さない） | 編集のたびに整形する、保護したいファイルの編集を止める |
| Skills | 手順書を必要なときだけ読み込む | 毎回チャットに貼っている手順やチェックリスト |
| サブエージェント / エージェントチーム | 別のコンテキストで作業させる | 調査を本筋の会話から切り離す、観点を分けた並行レビュー |
| 権限モード（auto を含む） | 確認なしで実行してよい範囲を決める | 長い作業は auto、CI は dontAsk |
Hooks。 公式は「Hooks are user-defined shell commands」と定義しています。ライフサイクルの決まった時点で実行されるので「certain actions always happen rather than relying on the LLM to choose to run them」という説明です（Hooks ガイド 2026-10-11確認）。CLAUDE.md に書いたルールはモデルが読んで従うものですが、Hooks はモデルの判断を通さずに必ず走ります。ガイドの例には、PostToolUse イベントでファイル編集のたびに Prettier をかける設定と、.env や .git/ 内のファイルへの編集を終了コード2で止める設定があります。
Skills。 SKILL.md に指示を書いておくと、Claude が関係する場面で使うか、/skill-name で直接呼び出せます。公式は作りどころを「when you keep pasting the same instructions, checklist, or multi-step procedure into chat, or when a section of CLAUDE.md has grown into a procedure rather than a fact」と書いています。本文は使うときだけ読み込まれるため、長い手順を CLAUDE.md に置くよりコンテキストを消費しません（Skills 2026-10-11確認）。
サブエージェントとエージェントチーム。 サブエージェントは自分専用のコンテキストウィンドウで動き、結果を呼び出し元に返します。公式は利点の筆頭に、探索や実装を本筋の会話から外してコンテキストを保つことを挙げています。独自の定義はプロジェクトの .claude/agents/ に置けます（サブエージェント 2026-10-11確認）。エージェントチームは複数の Claude Code セッションを束ねる機能で、1つのセッションがリードとなり、チームメイト同士は共有タスクリストとメッセージで直接やり取りします。公式は「experimental and disabled by default」としており、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 で有効にします。トークン消費は単独セッションより大幅に多く、向く用途としてセキュリティ・性能・テスト網羅を分担する並行コードレビューや、複数の仮説を競わせるデバッグが挙がっています（エージェントチーム 2026-10-11確認）。
権限モードと auto。 権限モードは、確認なしで実行してよい操作の範囲を決めます。公式の表では、default（Manual）が確認なしで通すのは読み取りだけです。acceptEdits はファイル編集と mkdir や mv などの一般的なファイル操作まで通します。dontAsk は事前に許可したツールだけを通して残りを拒否し、用途は「Locked-down CI and scripts」です。bypassPermissions は「Isolated containers and VMs only」とされています。auto では確認の代わりに、別の分類器モデルが実行前に各操作を審査します。CLI では Shift+Tab で切り替えます（権限モード 2026-10-11確認）。分類器でも防ぎきれない範囲は第10節で扱います。
8. 既存ツールとの連携──Cursor・VS Code・JetBrains との使い分け
第5節の入口のうち、IDE から使うのが VS Code 拡張と JetBrains プラグインです。ここで扱うのはその入口の一部で、新しい入口が増えるわけではありません。
VS Code 拡張について、公式は「This is the recommended way to use Claude Code in VS Code」と書いています。機能としては、計画を受け入れる前に確認・編集すること、編集の自動承認、選択範囲の行番号付き @ メンション、会話履歴、複数の会話をタブやウィンドウで開くことを挙げています。前提は VS Code 1.94.0 以降です（VS Code 拡張 2026-10-11確認）。拡張はチャットパネル用に CLI のコピーを同梱していますが、claude コマンドをシェルの PATH には追加しません。統合ターミナルで claude を打つには CLI の別途インストールが要ります。
Cursor では同じ拡張を使います。公式のインストール手順は VS Code 用と並べて Cursor 用のリンクを載せ、続けて Devin Desktop や Kiro など「other VS Code forks」にも入ると書いています。拡張が入らないエディタでは、CLI を入れて統合ターミナルで claude を実行するよう案内しています。
JetBrains プラグインは IDE のターミナルで Claude Code を動かす作りで、権限モードの切り替えも CLI と同じ Shift+Tab です（権限モード 2026-10-11確認）。第5節の表の通り、CLI の導入が前提になります。
使い分けは「どこで差分を見るか」で考えると整理できます。Cursor や VS Code はコードを書く画面で、Claude Code はモデルにツールと権限を与えて作業させるハーネスです。両者は排他ではなく、エディタの中で Claude Code を動かす形が公式に用意されています。差分を1件ずつ見ながら受け入れたい作業は IDE 拡張、-p によるスクリプト実行や CI での実行はターミナルの CLI が向きます。Cursor 自体が持つ AI 機能との比較は、一次資料を確認していないためこの記事では扱いません。
9. 費用：公式の目安と、手元のファイルから数えた実測
公式 costs ページの数字を先に置きます。いずれも2026-09-17時点の記載です。
| 項目 | 公式の記載 | その数字が指すもの |
|---|---|---|
| 1人1日あたり | 約13ドル | エンタープライズ展開全体の平均（利用した日あたり） |
| 1人1か月あたり | 150〜250ドル | 同上 |
| 分布 | 90%のユーザーは利用した日あたり30ドル以下 | 同上 |
| アイドル時 | 通常セッションあたり0.04ドル未満 | 会話要約などのバックグラウンドジョブ |
| キャッシュ有効期間 | サブスクリプションで1時間、使用クレジット利用時は5分（TTL の指定で1時間も可）、APIキー/クラウドは既定5分 | キャッシュミス時は全コンテキストを再処理 |
| CLAUDE.md の目安 | 200行以下に保つ | セッション開始時に毎回読み込まれるため |
この表で一番重要なのは右の列です。英語版の costs ページは日あたりの値を「per active day」と書いており、暦日すべての平均ではありません（コスト管理 英語版 2026-10-04確認）。13ドルも150〜250ドルも、API トークン課金を前提とした企業展開の平均であり、プラン表の月額とは別勘定です。公式は /usage の説明に注記を付けています。「/usage のセッションブロックは API トークン使用量を表示し、API ユーザーを対象としています。Claude Max および Pro サブスクライバーはサブスクリプションに使用量が含まれているため、セッションコスト数値は請求目的では関連がありません」。
料金プラン側は Free / Pro / Max / Team / Enterprise の5段階で、Free には Claude Code が含まれません。Pro は月払いで月20ドル、Max は月100ドルから、Team は標準シートが月払いで1席25ドルです（Claude 料金プラン 2026-09-17確認）。有料プランでは Claude Code の使用量が他機能と同じ枠を共有します。ただし2026-10-04確認の料金表では、Enterprise は「席料金＋API レートの使用料」（年払いで1席月20ドル）と表示されています。Pro・Max と同じ定額枠として扱わず、請求は料金表と契約条件で確認してください。
セッションのドル表示がどう作られているかは公式が説明しています。「Claude Code はトークン数からドル数値をローカルで計算します」。課金対象のトークンは4種です。costs ページの /usage 出力例は「1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write」とキャッシュ書き込みを独立して表示し、modelPricing の説明も「各モデルの 4 つのトークンあたりレートをリストする」と単価が4種類あることを明記しています（コストを効果的に管理する 2026-09-17確認）。単価 $p$ がセッション中で一定（モデルを切り替えない）で、データレジデンシーの1.1倍や modelPricing の multiplier のような乗数が掛からないと仮定すると、リクエスト $i$ ごとの入力・キャッシュ読み（cr）・キャッシュ書き込み（cw）・出力のトークン $t$ に単価を掛けて足し合わせた形になります。
公式は計算式そのものを公開していないため、これは表示値の構造を示す近似です。実際にはモデル別の内訳と前述の乗数が入ります。
長時間セッションで使用量が伸びる理由も、この式の $N$ と $t$ で説明が付きます。公式は「Claude Code はすべてのリクエストで完全な会話を送信し、Claude がツールを使用するたびに、そのツール結果のバッチを含む別のリクエストを送信します」と書いています。1行の質問でも、開きっぱなしのセッションでは会話全体分の使用量が発生します。ただし容量が迫ると古いツール出力の削除と要約が入るので、元の履歴が無制限に積み上がるわけではありません。加えて、キャッシュ有効期間より長く休むと最初のメッセージがキャッシュをミスし、全コンテキストを再処理します。サブスクリプションの1時間と、使用クレジット利用時の5分の差がここで効きます。
手元のファイルシステムから数えた値（2026-09-17時点、Linux aarch64 実機）
以下はシェルコマンドではなくファイル一覧ツールで列挙して数えた筆者環境の自己計測値です。セッション JSONL と総ファイル数は使用に伴って変わるため、環境依存かつ時点依存で、他環境や後日には再現しません。当時の列挙出力は掲載していないため、第三者が独立に検証できる値ではありません。
| 項目 | 値 | 数えた場所 |
|---|---|---|
自動メモリの MEMORY.md を持つプロジェクトディレクトリ | 14 | ~/.claude/projects/*/memory/MEMORY.md |
| プロジェクト直下のセッション JSONL | 86 | ~/.claude/projects/*/*.jsonl |
~/.claude/projects/ 配下の総ファイル数 | 2,595以上 | 同ディレクトリ全体 |
~/.claude/settings.json の allow ルール | 336件 | permissions.allow |
同 additionalDirectories | 12件 | permissions.additionalDirectories |
| 既定モデル / 努力レベルの設定値 | fable[1m] / xhigh | ~/.claude/settings.json |
Documents/gh/CLAUDE.md の行数 | 97行 | 当該ファイル |
Documents/gh/auto-article-generator/CLAUDE.md の行数 | 166行 | 当該ファイル |
2026-10-04 再計測（シェルコマンドで計数）では、MEMORY.md を持つディレクトリ 14、JSONL 72、総ファイル 1,855、allow ルール 336件、additionalDirectories 12件、モデル / 努力レベルの設定値 opus / xhigh、CLAUDE.md は97行と165行でした。JSONL と総ファイル数の減少は、Claude Code が既定で約30日より古いセッションデータを削除する仕様によるものと考えられます。auto-article-generator の CLAUDE.md は git の履歴上9月11日以降変更されておらず、9月17日の166行は数え違いと見られます。
数えて分かるのは、公式が「各メッセージ、ツール使用、結果は ~/.claude/projects/ の下のプレーンテキスト JSONL ファイルに書き込まれ」ると書いている通り、セッションが本当にローカルのファイルとして残っているということです。サブエージェントの実行記録も、各セッション ID のディレクトリ配下に subagents/ として分かれて置かれていました。ただしこれは保存レイアウトの観察にとどまります。用語集の「subagent は、それを生成したセッション内に留まります」という記述は調査結果が別セッションへ渡らないというスコープの話なので、ディスク上の配置はその裏付けにはなりません。
CLAUDE.md の行数は、確認した2本がいずれも公式指針の200行以下でした。公式メモリページはこの目安を「CLAUDE.md ファイルあたり 200 行以下を目標にします。より長いファイルはより多くのコンテキストを消費し、遵守を減らします」と、あくまでファイル単位で定義しています（Claude があなたのプロジェクトを記憶する方法 2026-09-17確認）。同じページは読み込み方について「Claude Code は現在のワーキングディレクトリからディレクトリツリーを上に歩き、途中の各ディレクトリをチェックして CLAUDE.md および CLAUDE.local.md ファイルを探します」「発見されたすべてのファイルはコンテキストに連結され」とも書いています。この2本は親ディレクトリと子リポジトリという包含関係にあるため、auto-article-generator で作業するセッションでは両方が連結して読み込まれ、実効の読み込み量は97行＋166行＝263行になります（2026-10-04 再計測では97行＋165行＝262行）。1ファイルあたりの目安は2本とも守れていますが、セッションが実際に読む合計は200行を上回るので、コンテキスト消費を見積もるときは連結後の合計で数える必要があります。手元リポジトリ全体の分布はClaude Code の使い方記事で31リポジトリを棚卸ししているので、そちらを参照してください。
バージョンで挙動が変わる項目
costs ページ自身が、機能ごとに必要バージョンを列挙しています。解説記事に版の明記が無いと手元と突き合わせられないのは、この列挙があるからです。
| 挙動 | 必要バージョン |
|---|---|
/clear でセッション合計がリセットされる（以前は累積） | v2.1.211以降 |
| データレジデンシー1.1倍レートをセッションコストに反映 | v2.1.239以降 |
modelPricing による契約レート表示 | v2.1.242以降 |
Prompt cache (main) 行の表示 | v2.1.251以降 |
| キャッシュミスの推定原因テキスト | v2.1.260以降 |
/usage のループ行 | v2.1.242以降 |
| 使用制限リセット後の待機と自動継続（開始条件・管理設定あり） | v2.1.234以降 |
Claude Code は無料で使えるか
無料では使えません。料金ページのプラン比較表で、Free プランの Claude Code の欄は「No」です（Claude 料金プラン 2026-10-11確認）。Claude Code が含まれるのは Pro 以上で、Pro の欄は「Yes」です。
サブスクリプションを使わない方法もあります。同じ料金ページの FAQ は「For heavy coding sessions, you can also switch to pay-as-you-go API credits through a Console account」と書いています。Console アカウントの API クレジットによる従量課金で、こちらも使った分だけ請求されます。
VS Code 拡張の前提条件も同じ線引きです。ログインに使えるのは「any paid Claude subscription (Pro, Max, Team, or Enterprise) or a Claude Console account」で、API キーは不要とされています（VS Code 拡張 2026-10-11確認）。無料で試せる枠は、2026-10-11時点の料金ページと公式ドキュメントには見当たりません。プランごとの使用量枠や上限に達したときの課金は、Claude の料金記事で詳しく扱っています。
10. 限界・リスク・向かない場面
権限モードの数え方が2ページで違います。 仕組みページは Auto / Manual / Accept edits / Plan の4つを紹介していますが、用語集は default、acceptEdits、plan、auto、dontAsk、bypassPermissions の6つを列挙しています。default は CLI と VS Code / JetBrains 拡張では Manual と表示されます。仕組みページが紹介するのは前者の4つ、設定値として存在するのは6つ、という理解が正確です。公式の権限モードのページによると、v2.1.283以降は対話ターミナルと VS Code セッションで、プランやプロバイダーを問わず auto が組み込みの開始モードです。それより前の版では Pro・Max・Team プランだけが対象でした（権限モード 2026-10-04確認）。設定や対応モデル、組織の管理ポリシーによって開始モードは変わります。
auto モードは承認プロンプトを出す代わりに、別の分類器モデルが各アクションをレビューします。用語集によれば、この分類器は「スコープエスカレーション、信頼されていないインフラストラクチャ、および prompt injection をブロック」し、「ツール結果はそれが見るものから削除されるため、ファイルまたは Web ページ内の悪意のあるコンテンツはそれを直接操作することはできません」。これは分類器を直接操作されにくくする設計の説明で、攻撃をすべて防げるという保証ではありません。また、明示的な ask ルールに該当する操作は auto でも確認を求めます。
プロンプトインジェクションは設計上の前提リスクです。 公式はこれを「ファイル、ウェブページ、またはツール結果に埋め込まれた敵対的な指示」と定義しています。エージェントが外部のテキストを読む以上、読んだ内容が指示として機能してしまう可能性は消えません。防御は権限システム、コマンドインジェクション検出、信頼検証の組み合わせで、ゼロにはなりません。権限を「クラス」として設計する考え方の実例はセッション間メッセージングの記事で扱っています。
戻せる範囲は限定されます。 第6節で挙げた通り、チェックポイントで戻せるのはファイル編集ツールによる変更と会話です。デプロイや DB 更新はチェックポイントでは取り消せないため、そのシステム側のバックアップやロールバックで備えます。
コンテキストが埋まると初期の指示が失われることがあります。 公式は「Claude は自動的にコンパクト化しますが、会話の早い段階からの指示が失われる可能性があります」と明記し、対策として「永続的なルールを CLAUDE.md に入れ、/context を実行してスペースを使用しているものを確認してください」と書いています。会話の最初に口頭で伝えたルールは、長いセッションでは残らない可能性がある前提で設計する必要があります。
並行実行はコストが跳ねます。 エージェントチームについて公式は「チームメイトがプランモードで実行される場合、標準セッションよりも約7倍多くのトークンを使用します」と書いています。この機能は実験的機能で、既定で無効です。
11. 始め方──最短で1セッション動かすまで
ターミナルから始める場合、公式が示す手順は3行です。
curl -fsSL https://claude.ai/install.sh | bash
cd your-project
claude
初回起動時にログインを求められます。ANTHROPIC_API_KEY を設定している場合はログインプロンプトが飛ばされ、代わりにキーの承認を求められます。Windows は PowerShell なら irm https://claude.ai/install.ps1 | iex、macOS は Homebrew の cask も使えます。デスクトップアプリには Claude Code が同梱されているので、CLI の別途インストールは不要です。
インストール後の初回タスクの進め方、CLAUDE.md の書き方、承認フローの設定は手順記事の役割なので、Claude Code の使い方記事に送ります。この記事は「何であるか」で止めます。
12. よくある質問
Claude と Claude Code は別物ですか
別の層の話です。Claude はモデル、Claude Code はそのモデルにツールと実行環境を与えるハーネスです。公式用語集の agentic harness の項が「Claude Code はハーネスです。Claude はその中のモデルです」と明示しています。契約上は同じ有料プランの中に含まれ、使用量の枠も共有します。
ターミナルが使えなくても使えますか
使えます。入口はターミナル CLI、VS Code、JetBrains、デスクトップアプリ、claude.ai の5つで、公式はすべてが同じエンジンに接続すると書いています。デスクトップアプリは Claude Code を同梱しているため CLI を別途入れる必要がなく、claude.ai ならローカルのセットアップ自体が不要です。ただし JetBrains プラグインは CLI の導入が必要です。
定額プランで足りますか。使うほど請求が増えますか
Pro / Max では、/usage に出るセッションのドル表示は請求額ではありません。Team と従来のシート型契約の Enterprise は席ごとの使用量枠から消費します。料金表に載っている現行の Enterprise は「席料金＋API レートの使用料」で、使用量が API 単価で別に請求されるため、どちらの方式かを契約条件で確認してください（2026-10-04確認）。プランの使用量枠を使い切ると制限に達し、リセットを待つか使用クレジットを有効にして続けます。API キーやクラウドプロバイダー経由の場合はトークン単位の課金になり、この場合に公式の利用日あたり約13ドルという目安が参照点になります。
勝手にファイルを書き換えられませんか
権限モードで制御します。Manual はファイル編集やシェルコマンドなど多くの操作の前に確認しますが、allow ルールや sandbox の自動許可を設定すると確認が省かれます。Plan はソースファイルを編集せずに調査と提案を行い、読み取りや探索のコマンドは実行します。auto は分類器がリスクのあるアクションをブロックし、承認プロンプトは基本的に出ません。ファイル編集ツールによる変更は Esc 2回または /rewind で巻き戻せます。ただし Bash ツール経由の変更、通常のサブエージェントの編集、外部システムへの操作はチェックポイントでは戻せません。
-p で使う headless mode という呼び方はまだ有効ですか
呼称が変わりました。公式用語集の「非推奨および名前変更された用語」の表に、headless mode は non-interactive mode へ改称されたと記載されています。フラグは -p のまま、動作も同じです。同じ表では custom commands が skills に、slash commands が commands に整理されています。
Claude Code はどこの会社のサービスですか
Anthropic のサービスです。公式の組織向けページは「Organizations can deploy Claude Code through Anthropic directly or through a cloud provider」と書いています（Enterprise deployment overview 2026-10-11確認）。
初心者は何から始めればいいですか
小さな作業から始めます。公式の組織向けページは、新しい利用者にはまずコードベースについての質問や、小さなバグ修正・機能追加で試させ、計画を作らせて提案を確認するよう勧めています。慣れるにつれて、より自律的に任せられるようになる、という順番です（Enterprise deployment overview 2026-10-11確認）。インストールから最初の CLAUDE.md までの手順はClaude Code の使い方記事にまとめています。
法人で導入するにはどうすればいいですか
公式は多くの組織に Claude for Teams か Claude for Enterprise を勧めています。1つのサブスクリプションで Claude Code と Web 版の Claude の両方が使え、請求は一元化され、インフラの準備が要らないためです。Teams には SSO、管理ツール、組織全体の Claude Code 設定を配る server-managed settings が含まれます。Enterprise はさらにドメインキャプチャ、ロールベースの権限、コンプライアンス API を加えます（Enterprise deployment overview 2026-10-11確認）。料金表では Team の標準シートが月払いで1席25ドル（年払いなら20ドル）、Premium シートが月払い125ドル（年払いなら100ドル）、Enterprise は「席料金＋API レートの使用料」です（Claude 料金プラン 2026-10-11確認）。
自社のクラウド契約で払う方法もあります。同じページは Amazon Bedrock、Claude Platform on AWS、Google Cloud’s Agent Platform（旧 Vertex AI）、Microsoft Foundry を挙げています。比較表によると、いずれも各クラウド経由の従量課金で、Web 版の Claude は含まれません。コストは各クラウドの請求画面で追います。プランごとの金額と使用量の数え方はClaude の料金記事を参照してください。
13. まとめ
- Claude Code はモデルではなく、モデルにツール・コンテキスト管理・実行環境を与える側の仕組みです。公式用語集がそのまま agentic harness と定義しています
- 入口は5つ、実行環境の公式の区分は3つで、この2つは別の軸です。リモートコントロールの実行先は手元のマシンです。手元の
~/.claude/が読まれるかどうかは入口ではなく実行環境で決まり、クラウドセッションは読みません - 動作は収集・実行・検証の3フェーズの反復で、ツールは5分類。5番目のコードインテリジェンスだけプラグインが要ります
- 公式の利用日あたり約13ドル・月150〜250ドルはエンタープライズ展開の平均であり、サブスクリプション利用者の請求額ではありません。長時間セッションで使用量が伸びるのは、毎リクエストで現在の会話を送る構造とキャッシュ有効期間で説明が付きます
- チェックポイントで戻せるのはファイル編集ツールによる変更と会話です。デプロイ・DB 更新・Bash 経由の変更はチェックポイントでは戻せず、長い会話では初期の指示が失われることがあります。永続的なルールは
CLAUDE.mdに置きます
14. 関連記事
- Claude Code の使い方──インストールから CLAUDE.md 1本までの公式手順と、手元31リポジトリの棚卸しで見えた実態 ── この記事で省いた手順を番号付きで扱っています
- MCPサーバーの選び方と候補一覧──登録した本数と実際に載るツール定義を分けて数える ── 第6節の MCP をコンテキスト消費の側から掘り下げています
- Claude料金はいくらか──Pro・Max・Team・APIの月額、使用量の数え方、上限を超えたときの課金まで（2026年10月時点） ── 第9節の「無料で使えるか」と法人導入の料金を詳しく扱っています
- Claude Code vs Codex CLI vs Gemini CLI──2026年4月版AIコーディングエージェント徹底比較 ── 他ツールとの比較はこちらです