Claude Codeチュートリアル — 従量課金キーの日常利用：モデル変更、費用計算、コンテキスト管理

Claude Codeの使い方は4ステップにまとめられます。プロジェクトフォルダでclaudeを実行し、まず/initを1回実行してCLAUDE.mdを生成し、中国語でタスクを説明してファイルパスを添え、提案された変更を確認して受け入れるか決めます。ターミナル内で動くプログラミングアシスタントで、ファイルを読み、編集し、テストを実行します。操作前には確認を求めます。Pro／Max購読でログインするか、従量制APIキーを設定して使えます。キー使用時は各ステップがtoken単位で課金されるため、日常利用の要点は3つ——タスクごとのモデル切り替え、1セッションの費用把握、コンテキストの簡潔さ——です。

オンラインのClaude Code解説はほぼすべて購読ログインを前提にしています。このページは、購読がない人、または5時間の利用枠に縛られたくなく従量制キーを使う人向けです。未インストールならまずClaude Codeインストールガイドを確認し、インストールと接続を済ませてから戻ってきてください。

初めて使う：4つの操作

# 1. 一定要在專案資料夾裡啟動——它能看、能改的範圍就是這個資料夾
cd ~/work/my-app
claude

# 2. 第一個指令：讀過整個 repo，產生 CLAUDE.md
> /init

# 3. 之後直接用中文交代任務，附上檔案路徑最準
> 把 src/api/user.ts 的輸入驗證改用 zod，測試也一起修好

# 4. 牽涉很多檔案的任務，先按 Shift+Tab 切到計畫模式，確認做法再動手

ファイル変更やコマンド実行のたびに確認されます。方向が違えばEscで停止し、/rewindで前のチェックポイントに戻せます。コードと会話が同時に戻ります。/initが生成するCLAUDE.mdは下書きにすぎず、短くする方法を以下で説明します。

APIキー使用時の1セッションの課金

Claude Codeはリクエストを送るたびに、システムプロンプト、CLAUDE.md、会話全体、読み込んだファイル内容を再送し、新しい内容を末尾に追加します。変わらない前半はキャッシュされ、キャッシュ読み取りは入力価格の10%、キャッシュ書き込みは入力価格の1.25倍です。そのためセッション料金の大半は「古い会話の再読み込み」です。

以下の表では、Anthropic公式コスト文書のセッション例——入力1,200、出力5,300、キャッシュ読み取り940,000、キャッシュ書き込み50,000 token——をKunavoの料金に置き換え、4モデルでそれぞれ計算します。

Claude Sonnet 5では、このセッションの請求額の約85%がキャッシュの読み書きです。つまり費用を決めるのは入力した文字数ではなく、会話の長さです。これが後述する「コンテキスト衛生」の理由です。

自分の数値を見るには、Claude Codeで/usageを実行します（/costは別名）。4種類のtoken数が表示されます。ただし横の金額はClaude CodeがAnthropic価格でローカル推定したものです。Kunavo使用時の実際の請求は管理画面の使用量ページを確認してください。各モデルのtoken数（キャッシュ読み書きを含む）と請求額が表示されます。

タスクに応じてモデルを切り替える

まず~/.claude/settings.jsonのenvセクションで、各エイリアスを実際のモデルに対応付けます。このファイルに記述すれば、エディター拡張機能やバックグラウンドプロセスも読み取れます。プロジェクトに含まれ、commitされる.claude/settings.jsonには記述しないでください。エイリアスは必ず対応付ける必要があります。Claude Codeのデフォルトモデルとopusエイリアスはいずれも最新のOpusを指します。Kunavoでまだ提供されていない場合、対応設定がないと最初のリクエストで404が返ります。sonnetエイリアスはSonnet 5.5を指しますが、Kunavoはこのモデルを提供していません。ANTHROPIC_DEFAULT_SONNET_MODELがないと、/model sonnet、opusplanの実行フェーズ、およびmodel: sonnetに設定したサブエージェントは404を受け取ります。以下の設定では、opusエイリアスをClaude Opus 5.5（claude-opus-5-5）に対応付けています。Claude Code v2.1.280以上が必要です。旧バージョンでは先にclaude updateを実行してください。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

設定後の切り替えは1行だけです。

# 工作階段裡切換（別名會對應到上面設定的模型）
> /model haiku
> /model sonnet
> /model opus

# 也可以直接打完整名稱
> /model claude-fable-5

# 或在啟動時指定
claude --model claude-opus-5-5

/modelは選択を保存し、以後の新セッションの既定値にします。今回だけ変更するなら引数なしの/modelを実行し、メニューでsを押します。ANTHROPIC_DEFAULT_HAIKU_MODELはClaude Codeがバックグラウンドで行う要約とタイトルも制御するため、最安モデルを指定するのが最も効率的です。

Kunavoでは、Claude Opus 5.5は$2.80 / $14.00、Claude Sonnet 5は$1.40 / $7.00です。Claude Haiku 4.5の単価はClaude Sonnet 5の約1/2、Claude Fable 5はその5倍です。公式価格と比較すると：Claude Sonnet 5 Anthropic公式より約30%安い、Claude Opus 5.5 Anthropic公式より約30%安い、Claude Haiku 4.5 Anthropic公式より約30%安い、Claude Fable 5 Anthropic公式より約30%安い。

モデルを切り替えるのはタスクの途中ではなく、タスク間にしてください。モデルごとにキャッシュが分かれているため、タスク途中で/modelすると、次のリクエストで会話全体を未キャッシュ料金で読み直す必要があります（キャッシュが有効ならClaude Codeが先に確認します）。先に/clearしてから切り替えれば、読み直すのは短い新規会話だけです。思考tokenは出力価格で課金されるため、簡単なタスクでは/effortで思考レベルを下げられます。タスク開始時に設定し、多くのモデルでは途中のeffort変更でもキャッシュが無効になります。

CLAUDE.md：何度も繰り返し伝えることだけを書く

# CLAUDE.md — 放在專案根目錄，commit 進 git

## 指令
- 測試：npm test（只跑一個檔：npm test -- path/to/file）
- 型別檢查：npx tsc --noEmit
- Lint：npm run lint

## 規則
- 日期一律用 date-fns，不用 moment。
- API handler 只放在 app/api/**/route.ts。
- commit 訊息用繁體中文，前綴 feat / fix / docs。

## 不要動的地方
- db/migrations/ —— 產生出來的檔案，不要手改。

CLAUDE.mdは各セッション開始時に読み込まれ、その後すべてのリクエストに含まれます（多くはキャッシュ読み取り料金）。Anthropicは1ファイルを200行以内にするよう推奨しています。長いほどコンテキストを消費し、遵守度が下がります。コードから分かる内容（ディレクトリ構成、関数説明）は不要です。人間だけに見せたいメモは<!-- -->で囲めば、コンテキストに送る前に除去されます。

よくある誤解がもう1つあります。セッション途中でCLAUDE.mdを編集してもすぐには反映されず、/clear、/compact、または再起動するまで新しい版は読み込まれません。

コンテキスト衛生：各ステップを安くする

• 無関係なタスクの間には/clearを使います。新しい会話を開始し、それ自体は課金されません。旧会話は後で/resumeで戻せます。
• 同じタスクが長くなったら/compactを使います。保持したい要点（例：/compact 保留測試輸出和改過的檔案）を添えられます。要約リクエストを1回送るため、キャッシュが有効なうちが最も安価です。長時間離れてからcompactすると、履歴全体を未キャッシュ料金で再読込する必要があります。
• 方向を間違えたら/rewind。戻されるのはすでにキャッシュされた前半なので、compactより安く済みます。
• キー使用時、キャッシュの既定保存期間は5分です。5分を超えて離れて戻ると、最初のステップで前文全体がキャッシュに再書き込みされます（入力価格の1.25倍）。会議や食事の前には/compactまたは/clearで区切ってください。
• /contextでコンテキストを占めているものを確認します。Kunavo使用時、この数値はローカル推定です。Kunavoは現在/v1/messages/count_tokensを提供しておらず、自動圧縮やセッション自体には影響しません。
• 不要なMCPサーバーは/mcpで無効にします。Anthropicのドキュメントによると、カスタムANTHROPIC_BASE_URLを設定するとツール検索（tool search）がなくなり、MCPツール定義は遅延読み込みされず、各リクエストを直接消費します。
• タスクにはファイルパスを添えます。「バリデーションを少し変更して」では広範囲を検索して大量のファイルを読みます。「src/api/user.tsのバリデーションをzodに変更して」なら必要な箇所だけを読みます。

「実行してよいですか」と何度も聞かせたくない場合は、読み取り・検証系コマンドだけを許可するのがおすすめです。確認をすべて省略するフラグは、環境全体を破棄できる場合に限って使ってください。理由は--dangerously-skip-permissionsの説明（英語）にあります。キャッシュの課金方法はキャッシュドキュメントを参照してください。

費用上限と支払い

キー管理ページでClaude Code専用キーを作成し、月間費用上限を設定します。上限に達すると、そのキーのリクエストは402を返し、追加課金されません。制御不能なループも上限までで止まります。同じページでIPホワイトリストも設定できます。

アカウントは前払い方式です。最低チャージ額は$10で、残高に有効期限はなく、失敗したリクエストには課金されません。台湾では海外利用可能なクレジットカード（Visa、Mastercard、Amex、JCB、銀聯）、Apple Pay、Google Payでチャージできます。現在、街口やLINE Payのような現地決済手段には対応していません。詳しくはClaude Codeの料金をご覧ください。

購読の方が得になるのはいつか

毎日長時間対話し、月に多くのステップを実行する人は、購読の固定月額が通常、従量課金より安くなります。判断は1回の割り算で十分です。月額料金÷1ステップの費用＝損益分岐ステップ数。Claude Sonnet 5では1ステップ約$0.043（キャッシュ除外）として、月の実行数がこれより少なければ従量課金が得で、作業しない月は$0です。各プランの現在の月額と完全な計算式はClaude Code料金ページに掲載しているため、ここでは繰り返しません。

この方法のトレードオフも明確にしておきます。Kunavo経由では共有容量を使い、専用割当も契約上のSLAもありません。保証された割当やSLAが必要なチームはAnthropicから直接購入してください。接続設定の詳細はClaude Code統合ドキュメント（英語）にあります。

よくある質問