Claude Codeとは?
AIコーディングツールの使い方
Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングツールです。コマンドラインから直接Claudeと対話しながら、コードの生成・編集・デバッグ・Git操作まで、開発作業を強力にサポートします。
この記事の対象者
- Claude Codeを初めて使う開発者
- AIコーディングツールに興味がある方
- ターミナルでの開発効率を上げたい方
Claude Codeとは
Claude Codeは、ターミナル上で動作する エージェント型AIコーディングツール です。単なるチャットボットではなく、実際にファイルを読み書きし、コマンドを実行し、Gitを操作できる自律的なアシスタントです。
他のAIツールとの違い
| 機能 | Claude Code | 一般的なAIチャット |
|---|---|---|
| ファイル読み書き | 直接操作可能 | コピー&ペーストが必要 |
| コマンド実行 | ターミナルで実行 | 不可 |
| Git操作 | コミット・PR作成まで | 不可 |
| プロジェクト理解 | ファイル構造を自動把握 | 手動でコード提供 |
| マルチファイル編集 | 複数ファイルを同時に | 1ファイルずつ |
インストール方法
Claude Codeは npm でインストールします。Node.js 18以上が必要です。
# グローバルインストール
npm install -g @anthropic-ai/claude-code
# インストール確認
claude --version
# プロジェクトディレクトリで起動
cd your-project
claude
# 初回はAPIキーの設定が求められます
# Anthropic APIキーまたはClaude Max(Proプラン)で認証
Claude Codeは2つの認証方法をサポートしています。Anthropic APIキー(従量課金)または Claude Max(月額定額のProプラン)から選べます。個人開発にはClaude Maxがおすすめです。
基本的な使い方
対話モード
claude コマンドで対話モードが起動します。自然言語で指示を出すだけで、Claudeがコードの読み取り、編集、実行を行います。
$ claude
> このプロジェクトの構成を説明してください
> login関数にバリデーションを追加してください
> テストを実行して失敗しているものを修正してください
> この変更をコミットしてください
ワンショットモード
対話なしで1回だけ指示を実行することもできます。
# -p オプションで即時実行
claude -p "このプロジェクトのREADMEを生成して"
# パイプで入力を渡す
cat error.log | claude -p "このエラーの原因を教えて"
主要な機能
1. ファイルの読み取り・編集
Claudeはプロジェクト内のファイルを自動的に探索し、必要なファイルを読み取ります。編集はユーザーの承認後に実行されます。
> src/utils/validation.tsにメールアドレスのバリデーション関数を追加して
# Claudeが以下を自動で実行:
# 1. 既存ファイルを読み取り
# 2. コードのスタイルを理解
# 3. 適切な位置に関数を追加
# 4. 差分を表示して承認を求める
2. コマンド実行
テスト実行、ビルド、パッケージインストールなどのコマンドも実行できます。
> テストを実行して、失敗しているテストを修正してください
# Claudeが以下を自動で実行:
# 1. npm test や pytest などを実行
# 2. 失敗内容を分析
# 3. コードを修正
# 4. 再テストして確認
3. Git操作
コミット、ブランチ作成、PR作成まで対応しています。
> この変更を適切なコミットメッセージでコミットして
> feature/add-validation ブランチを作成して、この変更のPRを作って
4. マルチファイル対応
複数のファイルにまたがる変更も一度に処理できます。モデルの追加、ビューの作成、URLの設定、テストの作成といった一連の作業を1回の指示で完了します。
CLAUDE.mdによるプロジェクト設定
CLAUDE.md は、プロジェクトのルートに配置する設定ファイルです。Claudeにプロジェクトのルールや背景情報を伝えることで、より適切なコード生成が可能になります。
# プロジェクト名
## 技術スタック
- Python 3.13 / Django 5.2
- PostgreSQL 16
- htmx + Bootstrap 5
## コーディング規約
- 関数名はスネークケース
- docstringは日本語で記述
- テストは pytest を使用
## ディレクトリ構成
- app/ - メインアプリケーション
- tests/ - テストコード
- docs/ - ドキュメント
## よく使うコマンド
- python manage.py runserver # 開発サーバー起動
- pytest # テスト実行
CLAUDE.mdは毎回のセッション開始時にClaudeが自動で読み込みます。プロジェクト固有のルール、制約、コマンドを記載しておくと、指示のたびに説明する手間が省けます。
スラッシュコマンド
Claude Code内で使える便利なコマンドです。
| コマンド | 機能 |
|---|---|
/help |
ヘルプを表示 |
/clear |
会話履歴をクリア |
/compact |
会話を要約してコンテキストを節約 |
/cost |
現在のセッションのAPI使用料を表示 |
/doctor |
設定の問題を診断 |
/memory |
CLAUDE.mdを編集 |
IDE連携
Claude Codeは主要なエディタ・IDEと連携できます。
VS Code
VS Code拡張機能をインストールすると、エディタ内でClaude Codeを利用できます。ファイルのコンテキストが自動的に共有されるため、よりスムーズな開発が可能です。
JetBrains IDE
IntelliJ IDEA、PyCharm、WebStormなどのJetBrains IDEでもプラグインが利用可能です。
効果的な活用法
1. CLAUDE.mdを充実させる
プロジェクトのルール、制約、コマンドをCLAUDE.mdに記載しておくと、毎回の指示が簡潔になります。
2. 段階的に指示する
大きなタスクは小さなステップに分けて指示すると、精度が上がります。
3. 権限モードを活用する
Claude Codeには操作の承認レベルを設定する権限モードがあります。信頼できる操作は自動承認に、危険な操作は手動承認に設定できます。
4. パイプラインに組み込む
ワンショットモード(-p)を使えば、シェルスクリプトやCI/CDパイプラインにClaudeを組み込めます。
# PRのコードレビューを自動化
git diff main...HEAD | claude -p "このdiffをレビューして問題点を指摘して"
# テスト失敗時の自動分析
pytest 2>&1 | claude -p "失敗しているテストの原因を分析して"
- Claude Codeはターミナルで動作するエージェント型AIコーディングツール
- ファイルの読み書き、コマンド実行、Git操作を自動で処理
- CLAUDE.mdでプロジェクト固有の設定を管理
- スラッシュコマンドやIDE連携で効率的に利用可能
- 段階的な指示と権限モードの活用が効果的な使い方のコツ