コストと安全
（お金とセキュリティ）

1不安なのは「お金」と「危なくないか」

Claude Code を使い始めて、操作に慣れてくると、次に気になるのが「これって毎回いくらかかってるの？」「うっかり大事なファイルを壊さない？」という2つの心配ごと。でも大丈夫。どちらも仕組みがあって、ちゃんと止められます。

このページのゴールは、初心者が一番ドキドキする「お金」と「安全」を、見える化・予防・確認の3ステップでスッキリさせること。例えるなら、はじめての一人暮らしで「電気代いくら？」「ガス火つけっぱなしで出かけてない？」を確認する感覚に近いです。怖いから使わない、ではもったいない。知って、安心して、どんどん使えるようになりましょう。

2料金のしくみ（トークンって何？）

Claude Code の料金は「トークン」という単位で決まります。これを知ると、なぜ料金が増えたり減ったりするのかが一気に分かるようになります。

📏たくさんの文章 ＝ たくさんのトークン ＝ コスト

あなたが送る質問も、Claude が返す答えも、読み込んだファイルの中身も、ぜんぶトークンとして数えられます。つまり——

• 会話が長くなるほど増える：これまでのやりとり全部を毎回思い出しながら答えるため。
• 大きいファイルを読ませるほど増える：1000行のコードを丸ごと渡せば、その分のトークンを消費します。
• 賢い（重い）モデルを使うほど1トークンあたりの単価が上がる：頭のいい人に頼むほど時給が高い、というイメージ。

sequenceDiagram
    participant U as あなた
    participant C as ClaudeCode
    participant F as ファイル
    U->>C: 質問を送る（入力トークン）
    C->>F: 関連ファイルを読み込む
    F-->>C: 中身を渡す（さらに入力トークン）
    Note over C: 会話の履歴も毎回ぜんぶ読む
    C-->>U: 答えを返す（出力トークン）
    Note over U,C: 入力＋出力の合計でお金が決まる

3使った額を「見える化」する

不安の正体は、たいてい「分からないこと」。だったら見えるようにすればいい。Claude Code には、使った量や金額をその場で表示してくれるコマンドが用意されています。

📊3つの確認コマンド

# いまのセッションの料金を確認
/cost

# 使用量の統計をまとめて見る
/stats

# 使い方の傾向・気づきを表示
/insights

4使いすぎを防ぐ「安全装置」

見える化の次は「予防」。あらかじめ上限（フタ）を決めておけば、うっかり使いすぎても自動でストップしてくれます。車のスピードリミッターみたいなものです。

🧯3つのブレーキ

① 予算の上限 — --max-budget-usd

「このセッションは最大◯ドルまで」と金額のフタを決められます。そこに達したら自動で止まるので、寝てる間に勝手に大金が…なんてことを防げます。

# 最大2ドルまで、を上限にして起動
$ claude --max-budget-usd 2

② 回数の上限 — --max-turns

「やりとりは最大◯回まで」とターン数のフタを決めます。ターン（＝AIが考えて動く1回ぶんの作業）を制限することで、無限に動き続けるのを防ぎます。自動実行のときに特に安心。

# 最大5ターンまでで打ち切る
$ claude --max-turns 5 -p "READMEを要約して"

③ 会話を残さない — --no-session-persistence

このフラグをつけると、その場かぎりの会話になり、セッションを保存しません。ちょっと試すだけ・残したくない作業のときに、後腐れなく使えます。

# 使い捨ての会話で起動（保存しない）
$ claude --no-session-persistence

5賢く節約するコツ

止めるだけじゃなく、そもそも「ムダに使わない」のが一番。ポイントは「軽い作業には軽い道具を、難所だけ強い道具を」というメリハリです。

⚖️モデルとモードを使い分ける

かんたんな作業に毎回いちばん賢い（＝高い）モデルを使うのは、近所のコンビニにスポーツカーで行くようなもの。もったいないですよね。普段は軽快に、ここぞの難所だけパワーを出すのがコツです。

• 軽い作業は Haiku や /effort low：安くて速い。/fast は速いが割高（Opusの高速化）なので急ぎ専用。
• 普段使いは --model sonnet：バランスのよいモデル。多くの作業はこれで十分。
• 難所だけ --model opus や /effort を上げる：複雑な設計やデバッグのときだけ本気を出す。/model でいつでも切替できます。

# 普段はバランス型のsonnetで軽快に
$ claude --model sonnet

# 作業中にモデルを切り替える（難所だけopusへ）
/model opus

# 考える深さ(effort)を切り替える
/effort medium

🗜️会話を軽くする — /compact

会話が長くなるとトークンがどんどん増える、というのはセクション2で説明したとおり。そこで /compact の出番です。これはこれまでの会話を要約してギュッと圧縮してくれるコマンド。大事な流れは残しつつ、重さを減らせます。話が一段落したら使うのがおすすめ。

# 文脈を要約して圧縮（軽くする）
/compact

# 別の話題に移るなら、いっそ履歴をまっさらに
/clear

🤖サブエージェントは安いモデルに

大きな作業では、Claude が「サブエージェント」（＝お手伝いの小さなAI）を呼んで分担することがあります。この子たちまで毎回いちばん賢いモデルにすると割高。CLAUDE_CODE_SUBAGENT_MODEL という環境変数で、サブエージェントだけ安いモデルに指定できます。本体は賢く、手伝いは軽く、の合わせ技です。

# サブエージェント（お手伝い）はsonnetで動かす
$ export CLAUDE_CODE_SUBAGENT_MODEL=sonnet
$ claude

🎯「やりたい → これ」早見表

6安全に使う：権限のレベル

ここからは「お金」から「安全」の話へ。Claude Code は、ファイルを書き換えたりコマンドを実行したりする前に「やっていい？」と聞いてくれます。この“どこまで自動で任せるか”を決めるのが 権限モード（permission-mode）です。

sequenceDiagram
    participant U as あなた
    participant C as ClaudeCode
    participant F as ファイル
    U->>C: このバグ直して と頼む
    C->>U: ファイルを書き換えてよいですか
    Note over U,C: ここで人間が判断できる
    alt 承認する
        U-->>C: はい お願い
        C->>F: 変更を実行する
        F-->>C: 完了
        C-->>U: 直しました
    else 却下する
        U-->>C: いや やめて
        C-->>U: わかりました 中止します
    end

🚦6つの権限モード

モードは起動時に --permission-mode で指定できますし、作業中でも Shift+Tab（または Alt+M）でサッと切り替えられます。最初は plan で計画を見てから、納得したら進む——という流れが特におすすめです。

# まず計画だけ立ててもらう安心モードで起動
$ claude --permission-mode plan

# 作業中の権限まわりの設定を見る
/permissions

🔧使える道具（ツール）を絞る

「権限モード」が“確認の強さ”なら、こちらは“そもそも何ができるか”の制限。使ってよい道具だけを許可リスト（白名単）に入れることで、想定外の操作をシャットアウトできます。読むだけは許すけど消すのは禁止、みたいな細かい設定が可能です。

• /permissions：今の権限設定を画面で確認・調整する。
• /allowed-tools：許可するツールの一覧を管理する。
• --allowedTools：起動時に「使っていい道具」を指定する。逆に禁止は --disallowedTools。

# 読み取り系の道具だけ許可して起動
$ claude --allowedTools Read Glob Grep

# 危ない道具を名指しで禁止することもできる
$ claude --disallowedTools Bash

7⚠️ 絶対に気をつけること

便利さと引きかえに、絶対に知っておくべき“地雷”があります。ここだけは飛ばさずに読んでください。事故のほとんどは、この一線を軽く超えてしまうことで起きます。

🧯いつ使ってよくて、いつダメ？

✅事故を防ぐ2つの習慣

1. 実行する前に /diff で人間が確認Claude が変更した差分（＝どこをどう変えたか）を /diff で必ず目視チェック。「うん、これでいい」と納得してから進むクセを。もし変だったら Esc+Esc や /rewind で巻き戻せます。
2. 公開する前に /security-reviewコードを世に出す前に /security-review で脆弱性（＝悪用されかねない弱点）をチェック。パスワードの漏れや危ない設定を、公開前に見つけられます。

flowchart TD
    A["作業がひと段落した"] --> B["/diff で変更を確認した?"]
    B -->|"いいえ"| C["まず /diff で目視チェック"]
    C --> B
    B -->|"はい"| D{"変更の内容は納得できる?"}
    D -->|"いいえ"| E["/rewind で巻き戻す"]
    E --> A
    D -->|"はい"| F{"これから公開や共有する?"}
    F -->|"はい"| G["/security-review を実行"]
    G --> H["指摘を直す"]
    H --> F
    F -->|"いいえ"| I["安全に完了"]