Claude Code 使い方 完全ガイド【2026年最新版】
Claude Codeとは
Claude Codeは、Anthropicが開発したターミナルベースのAIコーディングエージェントです。従来のコード補完ツールとは異なり、プロジェクト全体のファイル構造を自律的に探索・理解し、コードの生成・編集・デバッグ・リファクタリング・テスト実行までを一連の流れで処理できます。
最大の特徴は「エージェント型」のアプローチです。たとえば「認証機能を追加して」と指示するだけで、Claude Codeは必要なファイルを自分で見つけ、ミドルウェアの作成、ルート定義の変更、設定ファイルの更新までを自動的に行います。開発者は結果を確認して承認するだけです。
2025年のリリース以降、急速にユーザーを増やし、2026年現在ではプロのエンジニアだけでなく、非エンジニアがプロダクトを作る手段としても注目されています。
インストール方法
Claude Codeのインストールは非常にシンプルです。Node.js 18以上がインストールされた環境で、以下のコマンドを実行するだけで完了します。
npm install -g @anthropic-ai/claude-code
インストール後、プロジェクトディレクトリに移動して claude コマンドを実行すれば起動します。
cd your-project
claude
初回はAPIキーの設定またはClaude Maxアカウントでのログインが求められます。Mac・Windows(WSL推奨)・Linuxのいずれでも利用可能です。詳しいOS別の手順はClaude Code インストール方法の記事で解説しています。
基本的な使い方
Claude Codeの操作は、ターミナル上で自然言語を入力するだけです。以下に代表的な使い方を紹介します。
コード生成
新しいファイルや関数をゼロから作成できます。
> Honoを使ってユーザー登録APIのエンドポイントを作って。
zodでバリデーションして、Drizzle ORMでDBに保存して。
ファイル編集
既存のコードを指定して修正を依頼できます。複数ファイルにまたがる変更も自動で行います。
> src/utils/auth.ts の validateToken 関数で、
期限切れトークンの場合に AuthError を throw するように修正して
デバッグ
エラーメッセージを貼り付ければ、原因を特定して修正まで行います。
> npm test を実行して、失敗したテストの原因を特定して修正して
Claude Codeはテストの実行結果を読み取り、エラーの原因となるコードを自動で追跡・修正します。
リファクタリング
コードの品質向上もAIに任せられます。
> src/services/ 配下のファイルを分析して、
重複しているロジックを共通化して
非対話モードでの実行
スクリプトやCI/CDパイプラインに組み込む場合は、-p フラグで非対話モードを使います。詳しくはClaude Code API活用ガイドをご覧ください。
claude -p "このdiffをレビューして" < diff.txt
CLAUDE.mdでプロジェクトのルールを定義する
Claude Codeの出力品質を大きく左右するのが CLAUDE.md ファイルです。プロジェクトルートにこのファイルを配置すると、Claude Codeが毎回読み込んでコンテキストとして活用します。
# プロジェクト概要
ECサイトのバックエンドAPI。TypeScript + Hono + Drizzle ORM。
# コーディング規約
- 変数名: camelCase
- ファイル名: kebab-case
- セミコロン: なし
# コマンド
- pnpm dev - 開発サーバー起動
- pnpm test - テスト実行
技術スタック、ディレクトリ構造、命名規則、よく使うコマンドなどを記載しておくと、Claude Codeが「プロジェクトの慣習を理解したチームメンバー」のように振る舞います。書き方の詳細はCLAUDE.md の書き方完全ガイドを参照してください。
Skills と Hooks で作業を効率化する
Skills(スキル)
Skillsは、よく使うプロンプトをテンプレートとして保存し、スラッシュコマンドで呼び出せる機能です。.claude/skills/ ディレクトリにMarkdownファイルを作成すると、Claude Code内で /コマンド名 として利用できます。
たとえば、コードレビューの観点やテスト生成のルールをSkillとして定義しておけば、チーム全体で品質を統一できます。Skillsの詳しい設定方法はClaude Code Skills 設定ガイドで解説しています。
Hooks(フック)
Hooksは、Claude Codeの特定のアクション(ファイル保存、コマンド実行など)の前後に自動で処理を実行する仕組みです。リントの自動実行やフォーマッターの適用など、開発フローの自動化に活用できます。
MCPで外部ツールと連携する
MCP(Model Context Protocol)は、Claude Codeを外部のツールやデータソースと接続するためのプロトコルです。GitHub、Slack、PostgreSQL、Notionなど、さまざまなサービスと連携できます。
プロジェクトルートに .mcp.json ファイルを作成して設定します。
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
これにより、Claude Codeから「Issue一覧を表示して」「PRを作成して」といった操作が可能になります。設定手順や実践例はClaude Code MCP接続方法で詳しく解説しています。
料金プランの概要
Claude Codeの利用には、以下のいずれかの課金方式を選びます。
| プラン | 月額 | 特徴 |
|---|---|---|
| API従量課金 | 使った分だけ | 少量利用に最適 |
| Max 5x | $100/月 | 毎日使う開発者向け |
| Max 20x | $200/月 | ヘビーユーザー向け |
迷った場合は、まずAPI従量課金で始めて、利用量が増えてきたらMaxプランに移行するのがおすすめです。各プランの詳細な比較はClaude Code 料金プラン比較をご覧ください。また、無料で始める方法も用意されています。
Tips とベストプラクティス
Claude Codeを効果的に使うためのコツをまとめます。
1. 具体的に指示する
曖昧な指示はトークン消費の無駄につながります。ファイルパス、関数名、期待する動作を具体的に伝えましょう。
2. CLAUDE.md を整備する
プロジェクト固有のルールや構造を書いておくことで、毎回の説明が不要になり、出力精度も向上します。
3. 小さなタスクに分割する
大きなタスクを一度に依頼するよりも、段階的に進めた方が精度が高くなります。まず調査を依頼し、結果を確認してから実装に進むと安全です。
4. /compact でコンテキストを圧縮する
会話が長くなったら /compact コマンドでコンテキストを圧縮できます。トークン消費の節約に効果的です。
5. サブエージェントを活用する
大規模プロジェクトでは、Claude Codeが自動的にサブエージェントを起動して並列処理を行います。複数ファイルの調査やリファクタリングが大幅に高速化されます。詳しくはサブエージェント入門をご覧ください。
6. 他のツールと使い分ける
Claude Codeは大規模な変更に強い一方、日常的なコード補完にはCursorやGitHub Copilotとの併用も効果的です。
まとめ
Claude Codeは、ターミナルから自然言語で指示するだけで、プロジェクト全体を理解した上でコードの生成・修正・テスト・デバッグを自律的に行うAIコーディングエージェントです。CLAUDE.mdによるカスタマイズ、Skillsによる作業テンプレート化、MCPによる外部ツール連携など、開発ワークフロー全体を効率化する機能が揃っています。
まずはインストールして、小さなプロジェクトから始めてみましょう。AIと対話しながらの開発体験は、一度試せばその便利さを実感できるはずです。