Claude Code

Claude Codeとは?AIコーディングツールの使い方

Claude Code AI 開発ツール

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作成まで対応しています。

Git操作の例
> この変更を適切なコミットメッセージでコミットして

> feature/add-validation ブランチを作成して、この変更のPRを作って

4. マルチファイル対応

複数のファイルにまたがる変更も一度に処理できます。モデルの追加、ビューの作成、URLの設定、テストの作成といった一連の作業を1回の指示で完了します。

CLAUDE.mdによるプロジェクト設定

CLAUDE.md は、プロジェクトのルートに配置する設定ファイルです。Claudeにプロジェクトのルールや背景情報を伝えることで、より適切なコード生成が可能になります。

CLAUDE.md の例
# プロジェクト名

## 技術スタック
- Python 3.13 / Django 5.2
- PostgreSQL 16
- htmx + Bootstrap 5

## コーディング規約
- 関数名はスネークケース
- docstringは日本語で記述
- テストは pytest を使用

## ディレクトリ構成
- app/ - メインアプリケーション
- tests/ - テストコード
- docs/ - ドキュメント

## よく使うコマンド
- python manage.py runserver  # 開発サーバー起動
- pytest                      # テスト実行
CLAUDE.mdのポイント

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を組み込めます。

CI/CDでの活用例
# PRのコードレビューを自動化
git diff main...HEAD | claude -p "このdiffをレビューして問題点を指摘して"

# テスト失敗時の自動分析
pytest 2>&1 | claude -p "失敗しているテストの原因を分析して"
まとめ
  • Claude Codeはターミナルで動作するエージェント型AIコーディングツール
  • ファイルの読み書き、コマンド実行、Git操作を自動で処理
  • CLAUDE.mdでプロジェクト固有の設定を管理
  • スラッシュコマンドやIDE連携で効率的に利用可能
  • 段階的な指示と権限モードの活用が効果的な使い方のコツ