Claude Code の使い方 完全ガイド — ターミナルからAIペアプログラミングする方法【2026年版】

Claude Code とは？ ターミナルで動くAIペアプログラマー

Claude Code は、Anthropic が提供するターミナルベースのAIコーディングアシスタントです。VS Code や JetBrains のようなエディタを開かずに、ターミナル上で直接AIとペアプログラミングできるのが最大の特徴です。

通常のチャットAIとは異なり、Claude Code はプロジェクトのファイルを直接読み書きでき、git 操作やテスト実行まで一貫してターミナル内で完結します。

Claude Code の主な特徴

• エディタ不要 — ターミナルだけで完結するため、SSH先のサーバーでも使える
• コードベース全体を理解 — プロジェクト内のファイルを横断的に検索・分析できる
• ファイルの直接編集 — 提案だけでなく、許可を得た上でファイルを実際に書き換える
• git 統合 — コミット、ブランチ操作、PR作成まで自然言語で指示可能
• 拡張性 — カスタムスラッシュコマンドやエージェント機能で自分好みにカスタマイズ可能
• コンテキスト管理 — CLAUDE.md ファイルでプロジェクト固有のルールをAIに伝えられる

開発の現場では「ちょっとこのバグ見てほしい」「この関数リファクタして」といった依頼を、まるで隣に座っている同僚に話しかけるように実行できます。

---

インストール方法（macOS / Linux / Windows）

Claude Code は Node.js 18 以上が必要です。事前に node -v でバージョンを確認しておきましょう。

macOS

# npm でグローバルインストール
npm install -g @anthropic-ai/claude-code

# インストール確認
claude --version

Homebrew 経由でも導入可能です。

brew install claude-code

Linux（Ubuntu / Debian 系）

# Node.js 18+ がインストール済みであることを確認
node -v

# npm でインストール
npm install -g @anthropic-ai/claude-code

Windows（WSL2 経由）

Claude Code は現時点でネイティブ Windows をサポートしていません。WSL2（Windows Subsystem for Linux） を使って Linux 環境上で動作させます。

# WSL2 のターミナルで実行
sudo apt update && sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code

ポイント: Windows ユーザーは WSL2 + Windows Terminal の組み合わせが最もスムーズです。VS Code の WSL 拡張と併用すれば、ファイル編集もシームレスに行えます。

---

初期設定とAPIキーの設定

1. 初回起動と認証

インストール後、プロジェクトのルートディレクトリで claude と入力して起動します。

cd ~/my-project
claude

初回起動時に認証方法を選択する画面が表示されます。

• Anthropic Console のAPIキー を使う方法
• Claude Pro / Max サブスクリプション でログインする方法

APIキーを使う場合は環境変数に設定します。

# .bashrc または .zshrc に追加
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxx"

Claude Pro に加入すると、APIキーの管理なしで即座に利用開始できます。 月額の利用枠内であれば追加料金なしで Claude Code が使えるため、個人開発者には最もコストパフォーマンスの高い選択肢です。

2. CLAUDE.md でプロジェクトルールを設定

プロジェクトルートに CLAUDE.md を作成すると、AIにプロジェクト固有のルールや文脈を伝えられます。

# CLAUDE.md

## プロジェクト概要
- Next.js 15 + TypeScript のWebアプリケーション
- パッケージマネージャーは pnpm を使用

## コーディング規約
- 関数コンポーネントのみ使用（クラスコンポーネント禁止）
- CSS は Tailwind CSS を使用
- テストは Vitest で記述

## コマンド
- ビルド: `pnpm build`
- テスト: `pnpm test`
- Lint: `pnpm lint`

この設定ファイルがあるだけで、Claude Code の回答品質が大幅に向上します。

3. グローバル設定

ユーザー単位の設定は ~/.claude/ ディレクトリに配置します。

# グローバル設定ファイル
~/.claude/CLAUDE.md          # 全プロジェクト共通のルール
~/.claude/settings.json      # Claude Code の動作設定

---

基本的な使い方（コマンド一覧・よく使うパターン）

起動と終了

# プロジェクトディレクトリで起動
claude

# ワンショットモード（質問して即終了）
claude -p "このプロジェクトの技術スタックを教えて"

# 終了
# 対話中に /quit または Ctrl+C

よく使うスラッシュコマンド

コマンド	説明
/help	ヘルプを表示
/clear	コンテキストをクリア
/compact	会話を要約してコンテキストを圧縮
/model	使用モデルを切り替え
/cost	現在のセッションのトークン使用量を確認
/quit	Claude Code を終了

キーボードショートカット

ショートカット	説明
Esc	現在の生成を中断
Option + T	Extended Thinking の切り替え
Tab	ファイルパスの自動補完
Ctrl + O	Thinking の内容を表示

日常的によく使うパターン

# ファイルの内容を説明してもらう
> src/auth/login.ts を読んで、認証フローを説明して

# エラーの原因を調査
> npm run build で出るこのエラーの原因を調べて

# 新しいファイルを生成
> ユーザー登録用のAPIエンドポイントを src/api/register.ts に作って

# テストを実行して結果を確認
> pnpm test を実行して、失敗しているテストがあれば修正して

---

実務での活用テクニック

1. コードレビューを依頼する

# 現在の変更差分をレビュー
> git diff をレビューして。セキュリティ上の問題やバグがないか確認して

# 特定ファイルの品質チェック
> src/utils/validator.ts をレビューして。改善点があれば指摘して

Claude Code はコードベース全体の文脈を理解した上でレビューするため、単体では見つけにくい整合性の問題も指摘してくれます。

2. バグの原因を特定する

# エラーメッセージから原因を特定
> 以下のエラーが出ている。原因を特定して修正して：
> TypeError: Cannot read properties of undefined (reading 'map')

Claude Code は該当箇所を見つけるだけでなく、修正パッチまで提案・適用してくれるため、デバッグ時間を大幅に短縮できます。

3. テストコードを生成する

# 特定の関数のユニットテストを生成
> src/utils/calculatePrice.ts のユニットテストを Vitest で書いて。
> エッジケースも網羅して

# 既存テストのカバレッジを改善
> pnpm test -- --coverage を実行して、カバレッジが低い箇所のテストを追加して

4. リファクタリングを提案してもらう

# 特定ファイルのリファクタリング
> src/components/Dashboard.tsx が500行を超えている。
> 適切な粒度でコンポーネントを分割して

# パターンの統一
> プロジェクト内のエラーハンドリングを統一したい。
> 現在のパターンを調査して、統一案を提示して

5. git 操作を自動化する

# コミット
> 変更内容を確認して、適切なコミットメッセージでコミットして

# ブランチ作成と切り替え
> feature/user-profile ブランチを作成して切り替えて

# PR作成
> 現在のブランチの変更内容をまとめて、GitHub にPRを作成して

6. ドキュメントを自動生成する

# APIドキュメントの生成
> src/api/ 配下のエンドポイントを調査して、API仕様書を生成して

# 関数のJSDocを追加
> src/utils/ 配下の全関数にJSDocコメントを追加して

7. 依存関係の調査と更新

# 脆弱性のあるパッケージを調査
> npm audit を実行して、重大な脆弱性があれば対処方法を提案して

# メジャーバージョンアップの影響調査
> Next.js を14から15にアップグレードしたい。
> 破壊的変更の影響を調査して、移行計画を立てて

---

Cursor / GitHub Copilot との使い分け

Claude Code、Cursor、GitHub Copilot はそれぞれ異なる強みを持っています。併用が最も効果的です。

観点	Claude Code	Cursor	GitHub Copilot
動作環境	ターミナル	専用エディタ	VS Code / JetBrains 拡張
得意領域	大規模な調査・修正、git操作	ファイル横断の編集	リアルタイムのコード補完
コンテキスト	プロジェクト全体を把握	開いているファイル中心	現在のファイル中心
自律性	高い（ファイル操作・コマンド実行）	中程度	低い（補完が主）
SSH / リモート	対応	制限あり	対応

おすすめの使い分け

• 日常的なコード補完 → GitHub Copilot
• UI込みのファイル編集 → Cursor
• 大規模調査・リファクタ・git操作 → Claude Code
• リモートサーバーでの作業 → Claude Code

---

料金体系（無料枠 / Pro / Max）

API 利用（従量課金）

モデル	入力	出力
Claude Sonnet 4.6	$3 / 100万トークン	$15 / 100万トークン
Claude Opus 4.5	$15 / 100万トークン	$75 / 100万トークン

(出典: Anthropic公式サイト, 2026年3月時点)

開発用途では、1日あたり $1〜5 程度が一般的な使用量の目安です。

サブスクリプション

プラン	月額	特徴
Pro	$20	基本枠。個人開発に十分
Max 5x	$100	Pro の5倍の利用枠
Max 20x	$200	Pro の20倍の利用枠

料金は2026年3月時点の情報です。最新の料金は各公式サイトでご確認ください。(出典: Anthropic公式サイト, 2026年3月時点)

どのプランを選ぶべきか？

• お試し・軽い使用 → API従量課金（数ドル/月）
• 個人開発者 → Claude Pro がベストバランス
• 業務で毎日使う → Max 5x
• チーム開発 → Max 20x または API従量課金

---

FAQ（よくある質問）

Q. Claude Code は無料で使えますか？

APIキーの従量課金で利用する場合、少量であれば月に数ドルで使えます。Claude Pro（月額 $20）に加入すれば月間利用枠内で追加料金なしで使えます。

Q. インターネット接続は必要ですか？

はい、クラウド上のAIモデルと通信するため、常にインターネット接続が必要です。

Q. プライベートなコードがAnthropicに送信されますか？

Claude Code は入力されたプロンプトと参照したファイルの内容をAPIに送信します。API利用の場合、Anthropic はAPIデータをモデルのトレーニングに使用しないことをポリシーとして明示しています。

Q. どのプログラミング言語に対応していますか？

特定の言語に限定されていません。TypeScript、Python、Rust、Go、Java、PHP、Ruby など、主要な言語はすべてサポートしています。

Q. Vim / Neovim と一緒に使えますか？

はい。tmux などのターミナルマルチプレクサを使えば Vim/Neovim と並べて使用できます。Neovim 用のプラグインも開発されています。

Q. Windows のネイティブ対応予定はありますか？

2026年3月時点では WSL2 経由での利用が推奨されています。

---

まとめ

Claude Code は、ターミナルから直接AIとペアプログラミングできる強力なツールです。

特に以下のようなケースで真価を発揮します。

• 大規模なコードベースの調査・理解
• 複数ファイルにまたがるリファクタリング
• SSH接続先のリモートサーバーでの開発
• git操作やCI/CDとの連携

まずは npm install -g @anthropic-ai/claude-code でインストールして、自分のプロジェクトで試してみてください。

Claude Pro に加入すれば、月額 $20 で Claude Code も Web版 Claude も使い放題。 個人開発者にとって最もコスパの良い選択肢です。