「AIにコードを書いてもらいたいけど、どのツールを使えばいいかわからない」「ChatGPTは使ったことあるけど、開発ツールとして本格的に活用したい」——そう感じている方に、ぜひ知ってほしいのがClaude Codeです。Anthropicが提供するこのツールは、ターミナルやVSCodeに直接組み込んで使える本格的なAIコーディングアシスタント。単に質問に答えるだけでなく、実際にコードを書き・実行し・ファイルを編集するところまでこなしてくれます。この記事では、Claude Codeの基本的な概要から料金プラン、インストール方法、主要なCLIコマンドとスラッシュコマンド、CLAUDE.mdの活用法、そしてAPIとの連携まで、初心者の方でも迷わないよう順を追って丁寧に解説します。

Claude Codeとは?基本概要をおさらい

Claude Codeは、AI企業Anthropicが開発したコーディング特化型のAIエージェントツールです。同社のAIモデル「Claude」をベースに、開発者の日常的な作業——コード生成、バグ修正、リファクタリング、ドキュメント生成——を自動化・効率化することを目的として設計されています。

一般的なAIチャットとの大きな違いは、ファイルシステムに直接アクセスし、コードを読み書きできる点です。たとえば「このディレクトリ全体のコードを見てバグを探して」と頼むと、実際にファイルを開いて問題のある箇所を特定し、修正提案まで行ってくれます。2024年後半にベータ公開され、2025年に正式版がリリース。2026年現在は個人開発者からスタートアップのチームまで幅広く活用されており、YouTubeや技術ブログでの解説記事も急増しています。

実際に数週間使ってみた結果、「複数ファイルにまたがるリファクタリング」や「既存コードへの機能追加」といった作業で特に効果を実感しました。単発の質問応答ではなく、プロジェクト全体を把握した上で作業を進めてくれるのが、他のAIチャットツールとの明確な違いです。

なお、Claude CodeはNode.jsで動作します。バージョン18以上が必須で、2026年現在は22 LTSが推奨環境として広く使われています。インストール前に必ずバージョンを確認しておきましょう。

Claude Codeの画面イメージ
keikunkeikun
私も最初はGitHub Copilotとの違いがわからなかったけど、ターミナルで

料金プランの詳細と選び方

Claude Codeの利用料金は、主にAnthropicのAPI使用量に基づいた従量課金制が基本です。ただし、2026年現在は利用形態によっていくつかの選択肢があります。それぞれの特徴とデメリットを把握した上で、自分に合ったプランを選びましょう。

① Claude.ai Proプラン経由で使う場合(初心者におすすめ)

月額$20(約3,000円)のClaude.ai Proプランに加入することで、Claude Codeも一定の範囲内で利用できます。Claude Appのアカウントでログインする方法で、初心者の方にはまずこちらから試すことをおすすめします。日常的なコーディング補助や小規模プロジェクトであれば、このプランで十分なケースが多いです。

デメリット:長時間の連続利用や大量のコード処理には使用制限がかかる場合があります。「使いたいときに制限がかかっていた」という状況が発生するリスクを念頭に置いておきましょう。

② Anthropic APIを直接使う場合

より本格的に使いたい場合は、Anthropic APIキーを取得して直接接続する方法があります。この場合、入力トークン$3/百万・出力トークン$15/百万(Claude 3.5 Sonnet基準、2026年3月時点)という従量課金になります。使った分だけ払う仕組みなので少量なら安く済みますが、大きなコードベースを渡すと1回の処理でトークンを大量消費し、コストが予想以上に膨らむことがあります。毎月の使用量をAnthropicコンソールで確認しながら運用することが必須です。

③ Maxプラン(上位プラン)

月額$100または$200のMaxプランでは、より高い使用上限と優先アクセスが提供されます。チームや企業での本格利用を検討している場合に向いています。個人利用でProプランの制限に頻繁に引っかかるようになってきたら、Maxプランへの移行を検討する目安になります。なお、speakdeckで公開されているベストプラクティス資料(2025年5月版)によると、ProプランはAIコーディングを試す入門段階として位置づけられており、日常的にフル活用するなら上位プランへの移行を視野に入れておくことが推奨されています。

注意:料金体系はAnthropicの方針変更により随時更新される場合があります。最新情報は必ず公式サイト(anthropic.com)で確認してください。

keikunkeikun
料金を見て諦めかけたけど、実際に使った月のトークン消費量を計算したら思ったより全

ターミナルへのインストール方法

Claude Codeはnpm(Node.jsのパッケージマネージャー)経由でインストールします。事前にNode.js 18以上(推奨:22 LTS)がインストールされていることを確認してください。2026年現在、Node.js 22 LTSが安定版として広く使われており、この環境でのインストールが最も動作が安定しています。

手順1:Node.jsのバージョン確認

node -v

「v18.0.0」以上が表示されればOKです。表示されない場合や古いバージョンの場合は、Node.jsの公式サイト(nodejs.org)からLTS版をインストールしてください。バージョンが古いままだとClaude Codeのインストール自体は成功しても、起動時にエラーが出るケースがあるため、この確認は省略しないようにしましょう。

手順2:Claude Codeのインストール

npm install -g @anthropic-ai/claude-code

-g オプションをつけることでグローバルインストールされ、どのディレクトリからでも claude コマンドが使えるようになります。インストール完了後、claude --version を実行してバージョンが表示されれば成功です。権限エラーが出る場合は、macOS・Linuxでは sudo を頭につけるか、npmのグローバルディレクトリのパーミッション設定を見直してください。

手順3:認証(ログイン)

claude

初回起動時にブラウザが立ち上がり、AnthropicアカウントまたはAPIキーの入力画面が表示されます。Claude App(Claude.aiのアカウント)でログインする方法と、APIキーを直接使う方法の2種類があります。初心者の方はClaude Appでのログインが手軽です。APIキーを使う場合は、Anthropicのコンソール(console.anthropic.com)でキーを発行し、環境変数 ANTHROPIC_API_KEY にセットするか、起動時に入力します。

VSCodeへのインストール方法

VSCodeユーザーの場合、ターミナル統合機能を通じてClaude Codeを使うのが一般的です。専用の拡張機能も提供されており、よりGUIフレンドリーな操作が可能になっています。

方法A:VSCode内蔵ターミナルで使う

上記のターミナルインストールが完了していれば、VSCodeのターミナル(Ctrl + ` で開く)から claude コマンドをそのまま実行できます。プロジェクトのルートディレクトリでターミナルを開いた状態で使うと、ファイルの読み書きがスムーズです。実際にこの方法で使ってみると、VSCodeのエディタ画面とターミナルを並べながら作業できるため、生成されたコードをすぐに確認・編集しやすいのがメリットです。

方法B:VS Code拡張機能を使う

VSCodeの拡張機能マーケットプレイスで「Claude Code」または「Anthropic」と検索すると、公式または対応拡張機能が見つかります。インストール後、設定画面でAPIキーを入力するだけで、サイドパネルからClaude Codeと対話できるようになります。コードを選択した状態で右クリックメニューから「Explain with Claude」などのオプションを使えることもあります(拡張機能のバージョンによって機能は異なります)。

注意点:拡張機能は更新頻度が高く、インターフェースや機能が変わる場合があります。インストール後にリリースノートを確認する習慣をつけておくと、新機能を見逃さずに済みます。また、2026年現在はMCP(Model Context Protocol)連携への対応も進んでおり、外部ツールとの連携機能が拡張機能経由でも利用できるようになってきています。

ターミナルでClaude Codeを使っている様子

CLAUDE.mdでプロジェクトを記憶させる

Claude Codeを使いこなす上で、ぜひ早めに習得しておきたいのがCLAUDE.mdファイルの活用です。これはプロジェクトのルートディレクトリ(またはそれに近い場所)に置く設定ファイルで、Claude Codeが作業を開始するときに自動的に読み込まれます

CLAUDE.mdに書くべき内容

  • 使用言語・フレームワークのバージョン(例:Python 3.12、Next.js 15)
  • コーディング規約(例:インデントはスペース2つ、変数名はキャメルケース)
  • テストの書き方(例:テストはpytestで書き、カバレッジ80%以上を目標にする)
  • プロジェクトの構成概要(例:src/以下がメインのソースコード、tests/以下がテスト)
  • 使ってはいけないライブラリや非推奨の書き方

CLAUDE.mdの基本的な書き方例

# プロジェクト設定

## 環境
- Python 3.12
- FastAPI 0.110以上
- テスト: pytest

## コーディング規約
- 型ヒントを必ず付ける
- 関数名はスネークケース
- コメントは日本語でOK

## 注意事項
- 本番DBに直接接続するコードは書かないこと

実際にCLAUDE.mdを整備してから作業すると、毎回「このプロジェクトはPythonを使っていて……」と説明しなくて済むようになり、作業効率が体感で30〜40%向上しました。タスクが変わるたびに内容を更新していくのが運用のコツです。なお、プロジェクトフォルダに近い場所に置いたCLAUDE.mdが優先される仕様になっているため、サブディレクトリごとに個別のCLAUDE.mdを置いて細かく設定を分けることも可能です。

チーム開発では、CLAUDE.mdをGitリポジトリにコミットしておくと、メンバー全員が同じ設定でClaude Codeを使えるというメリットがあります。ただし、機密情報(環境変数の値や内部URL等)はCLAUDE.mdに書かず、.gitignoreで管理するファイルに分けるよう注意してください。

keikunkeikun
これ知らずに使ってた人は本当に損してて、CLAUDE.mdに技術スタックを書いて

覚えておきたいCLIコマンド一覧

ターミナルから使う際の主要なCLIコマンドをまとめます。最初はこの6つを覚えるだけで十分です。

  • claude:インタラクティブモードで起動。チャット感覚でAIと対話しながらコーディングできる。
  • claude "質問や指示":起動と同時に指示を渡す1ショット実行。例:claude "このコードのバグを直して" のように使う。
  • claude -p "指示":プロンプトモード。パイプと組み合わせてスクリプト処理に使いやすい。
  • claude --continue:前回の会話セッションを引き継いで続きから作業できる。
  • claude --version:現在インストールされているバージョンを確認。アップデート後に使うと良い。
  • claude --help:使用可能なオプション一覧を表示。迷ったらまずこれを実行する。

これらのコマンドはNode.jsベースで動作するため、環境によってはnpxを使って実行するケースもあります。うまく動かない場合は npx @anthropic-ai/claude-code を試してみてください。また、claude --version で表示されるバージョンが古い場合は npm update -g @anthropic-ai/claude-code でアップデートできます。Claude Codeはアップデート頻度が高いため、定期的に最新版へ更新することをおすすめします。

スラッシュコマンドの使い方

Claude Codeのインタラクティブモード中に使えるスラッシュコマンド(/から始まるコマンド)は、操作をより効率化するためのショートカットです。チャット画面の中で / を入力すると候補一覧が表示されます。

  • /help:使い方のヘルプを表示する。
  • /clear:現在の会話履歴をリセットして新しいセッションを開始する。コンテキストが混乱してきたと感じたらこれ。
  • /compact:長くなった会話をコンパクトに要約してコンテキストを節約する。長時間作業時に特に有効で、APIコスト削減にもつながる。
  • /config:設定項目の確認・変更ができる。使用モデルの変更などもここから行う。
  • /cost:現在のセッションで消費したAPIコストの概算を表示する。APIキー直接利用時には必須。
  • /exit または /quit:Claude Codeを終了する。

特に/costコマンドはAPIキーで直接使っている方には必須です。大きなコードベースを何度も読み込ませると、気づかないうちに数ドル〜数十ドルを消費してしまうことがあります。セッションの区切りごとに確認する習慣をつけておくことを強くおすすめします。なお、スラッシュコマンドのラインナップはバージョンアップとともに追加・変更されることがあります。/help で最新のコマンド一覧を確認するのが確実です。

APIとの連携について

Claude CodeはAnthropicのAPIを内部的に使っていますが、自分のアプリケーションやスクリプトに組み込みたい場合は、Anthropic Python SDKまたはNode.js SDKを使ってAPIを直接呼び出す方法もあります。

Python SDKの基本例

pip install anthropic
import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "このPythonコードのバグを直してください: ..."}
    ]
)
print(message.content)

このようにAPIを使えば、CI/CDパイプラインへの組み込みやバッチ処理での自動コードレビューなども実現できます。Claude Codeというツール自体もこのAPIの上に構築されているため、カスタマイズの自由度は非常に高いです。

注意点:APIを直接呼び出す場合、利用するモデル名(例:claude-3-5-sonnet-20241022)は定期的に新バージョンに更新されます。古いモデル名を指定すると非推奨警告が出たり、将来的にサポート終了となる場合があるため、Anthropicの公式ドキュメントで最新のモデル名を定期的に確認してください。また、2026年現在はMCP(Model Context Protocol)を通じた外部ツール連携も実用段階に入っており、ファイルシステムやWebブラウザ、データベースなどとの統合がより柔軟に行えるようになっています。興味があればAnthropicの公式ドキュメントの「MCP」セクションも参照してみてください。

初心者が使うときの注意点・コツ

実際に数週間にわたってClaude Codeを日常的に使ってみた結果をもとに、初心者が躓きやすいポイントと対処法をまとめます。

  • 指示は具体的に書く:「直して」より「この関数の○行目でNoneが返ってくるバグを修正して」のほうが精度が大幅に上がります。「うまくいかない」ではなく、エラーメッセージをそのまま貼り付けるのも有効です。
  • コンテキストを意識する:長時間使い続けると会話履歴が長くなり、応答が遅くなったり精度が落ちたりすることがあります。/clear/compact を適宜使いましょう。
  • APIコストの管理を怠らない:特に大きなコードベースを渡す際は1回の処理でトークンを大量消費することがあります。/cost で確認する習慣をつけてください。月末に想定外の請求が来るケースが報告されています。
  • 生成されたコードはその
    keikun

    keikun|AIツール研究家

    AIとプロンプトエンジニアリングに魅了され、毎日のようにAIツールを試し続けるブロガー。海外の最新AI情報をキャッチアップしながら、日本のユーザーが実際に使える形で発信しています。

    ▶ プロフィール詳細を見る

keikun

keikun

AIツール研究家 / PromptTeq 管理人

ChatGPT・Claude・Geminiなど主要AIツールを毎日使い込みながら、実践的な活用法を発信しています。「難しそう」と感じているあなたに、使える形でお届けするのがミッションです。