AIRA@aira
Claude Code入門：インストール、料金体系、トークン節約術
ブラウザでClaudeとチャットすることに慣れていると、コマンドラインベースのAIツールは敷居が高く感じられるかもしれません。Anthropicが提供するClaude Codeは、エージェント型のコーディングアシスタントをターミナルで直接利用できるようにすることで、そのギャップを埋める存在です。コードスニペットのコピー＆ペーストを繰り返す必要はなく、開発環境にツールが直接アクセスし、リポジトリの読み込み、テストの実行、ファイルの編集、プロジェクトに関する質問への回答までを完結させることができます。
本稿では、Claude Codeの仕組みと必要なプラン、そしてサブスクリプション料金やAPIクレジットを無駄に消費しないための設定方法を解説します。
Claude Codeを利用できる対象
Claude Codeは、Anthropicの有料サブスクリプションプランおよびAPIアカウントで利用可能です。Claude Pro（月額20ドル、年間契約なら月額17ドル相当）、Claude Team（1シートあたり月額25ドル）、Claude Max（月額100～200ドル）のいずれかに加入していれば利用できます。なお、通常の無料版ではCLIへのアクセスは含まれていません。
サブスクリプションを利用せず、使用量に応じて支払いたい場合は、AnthropicのAPIキーを接続して利用することも可能です。APIキーの場合は、使用するモデルに応じたトークン従量課金となります（例：Claude Sonnet 3.5は入力100万トークンあたり2ドル、出力100万トークンあたり10ドル。Claude Haiku 3.5はそれぞれ0.1ドルと0.5ドル）。日常的なタスクであれば、Claude ProやTeamサブスクリプションで利用する方が、トークン課金を気にせず定額で管理できるためおすすめです。
ネイティブインストールによるCLIの導入
Anthropicは、npmのようなパッケージマネージャーを使用するのではなく、ネイティブインストールスクリプトによる導入を推奨しています。これにより、インストールが軽量に保たれ、CLIを常に最新の状態にアップデートしやすくなります。
macOS、Linux、またはWindows Subsystem for Linux (WSL) の場合は、ターミナルを開き、公式のインストールコマンドを実行してください。
WindowsのPowerShellを使用する場合、Claude CodeがBash互換のユーティリティコマンドにアクセスできるよう、「Git for Windows」をインストールしておく必要があります。準備ができたら、PowerShellで以下のインストーラーコマンドを実行してください。
認証とログイン
スクリプト完了後、ターミナルを再起動するか新しいタブを開いてパスを更新します。以下のコマンドでバージョンが表示されれば、インストールは成功です。
また、Anthropicはシェル権限、ネットワーク接続、依存関係を検証する診断用コマンドも用意しています。最初にこれを実行しておくと、トラブルシューティングの時間を節約できます。
プロジェクトディレクトリ内で初めてclaudeを実行すると、対話形式のサインインフローが始まります。ブラウザが自動的に開き、Anthropicのサブスクリプション認証またはAPIキーの入力が求められます。連携が完了すれば、すぐにエージェントがコードの解析を開始できます。
CLAUDE.mdファイルによるトークン節約
エージェント型のCLIアシスタントはローカルファイルを読み込み、ディレクトリ構造を分析するため、対策を怠るとコンテキストトークンを急速に消費してしまう可能性があります。Anthropicはトークン消費を抑えるためのプロジェクト設定標準として、自動化された仕組みを用意しています。
プロジェクトのルートディレクトリで、以下の初期化コマンドを実行してください。
このコマンドを実行すると、リポジトリがスキャンされ、ルートフォルダに軽量なCLAUDE.mdマークダウンファイルが生成されます。このファイルはCLIのメモリとして機能し、パッケージマネージャー、テストコマンド、コードのフォーマットルール、フォルダ構造など、プロジェクトの重要な詳細情報を記憶させることができます。
Claude Codeは起動時に自動的にCLAUDE.mdを読み込みます。プロジェクトの構成や実行方法をアシスタントが即座に理解できるため、フォルダを再スキャンしたり、同様の確認質問を繰り返したりする必要がなくなり、クエリごとのトークン消費を大幅に削減できます。5分程度で完了する設定ですが、月々の使用量を健全に保つために非常に効果的です。
