Claude マニュアル
日本語EN

Claude Code をはじめよう

ターミナルに不慣れな方は 非エンジニア向け Claude Code ガイド から始めることをおすすめします。

Claude Code は、ターミナル（コマンドラインツール）上で動作する AI コーディングエージェントです。自然言語で指示するだけで、ファイルの読み書き、コードの修正、コマンドの実行、Git 操作まで、開発作業を幅広くこなしてくれます。

この記事では、Claude Code のインストールから最初のコマンド実行までを順を追って解説します。

Claude Code とは

Claude Code は、ブラウザやデスクトップアプリで使う Claude（チャット UI）とは異なる、ターミナルネイティブの AI エージェントです。

チャット版との違い

Claude Web / DesktopClaude Code
操作環境ブラウザ・デスクトップアプリターミナル（コマンドライン）
ファイルアクセスアップロードが必要ローカルファイルに直接アクセス
コマンド実行できないシェルコマンドを実行できる
Git 操作できないコミット・プッシュなど直接操作
向いている作業質問・文章作成・チャットコーディング・ファイル操作・自動化

Claude Code がとりわけ威力を発揮するのは、次のような場面です。

  • コードベース全体の把握: 「このプロジェクトの構成を説明して」と頼むと、ディレクトリを走査して概要を答えてくれる
  • バグ修正: エラーメッセージを貼り付けるだけで、原因を特定して修正案を実装してくれる
  • リファクタリング: 「このファイルの関数を整理して」と指示すると、コードを書き換えてくれる
  • Git 操作: 「変更内容を確認してコミットして」と頼むと、git diff の確認からコミットメッセージの生成まで行ってくれる
  • ファイル一括処理: 「このフォルダ内の CSV を全部結合して」といった繰り返し作業も自動化できる

料金について

Claude Code は Pro プラン以上で利用できます。Free プランでは使えません。Claude Code の利用はチャットと同じ利用枠を共有するため、コーディング作業をメインにする場合は Max プランが向いています。詳しくは料金プランの比較を参照してください（最新の料金は Anthropic 公式の料金ページ で確認してください）。

前提条件

Claude Code をインストールする前に、以下を確認してください。

対応 OS

Windows でも利用できます。 PowerShell、WSL、WinGet のいずれかでインストールできます（Git for Windows が必要です）。

WSL を使う場合で、まだインストールしていない場合は、PowerShell（管理者権限）で以下を実行してください。

wsl --install

Node.js 18 以上（npm でインストールする場合のみ）

npm 経由で Claude Code をインストールする場合は Node.js 18 以上が必要です。ネイティブインストーラーを使う場合は不要です。

node --version

v18.0.0 以上が表示されれば OK です。インストールされていない、またはバージョンが古い場合はNode.js 公式サイトからインストールしてください。

つまづきポイント: node: command not found と表示される場合、Node.js がインストールされていません。nodejs.org から LTS（長期サポート版）をダウンロードしてインストールするか、Node.js が不要なネイティブインストーラーの利用を検討してください。

Git

Git 操作の機能を使うには Git が必要です。

git --version

インストールされていない場合はGit 公式サイトからインストールできます。

WSL 環境では以下でインストールできます。

sudo apt-get update && sudo apt-get install git

インストール

Claude Code のインストール方法は複数あります。ネイティブインストーラーが公式推奨の方法です。

ネイティブインストーラー（推奨）

Node.js 不要で、バックグラウンド自動更新にも対応しています。

PowerShell の場合:

irm https://claude.ai/install.ps1 | iex

WinGet の場合:

winget install Anthropic.ClaudeCode

インストールが完了したら、以下でバージョンを確認します。

claude --version

バージョン番号が表示されれば成功です。

Homebrew でインストール（macOS のみ）

Windows ではネイティブインストーラーまたは npm を使ってインストールしてください。

npm でインストール

Node.js 18 以上が必要です。ネイティブインストーラーの利用が難しい場合に使えます。

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

つまづきポイント: npm: command not found と表示される場合、Node.js がインストールされていません。前のセクションの「Node.js 18 以上」を先に対応してください。

EACCES: permission denied エラーが出た場合は、sudo npm install -g @anthropic-ai/claude-code を試してください。ただし、sudo での npm グローバルインストールは権限やセキュリティの問題が生じる場合があるため、公式はネイティブインストーラーの利用を推奨しています。

認証（ログイン）

インストール後、はじめて claude コマンドを実行すると認証フローが始まります。

claude

初回起動時には、Anthropic アカウントへの認証を求めるメッセージが表示されます。ブラウザが自動的に開き、claude.ai の認証ページに移動します。

認証の手順

  1. ターミナルで claude を実行する
  2. 自動的にブラウザが開き、Anthropic の認証ページが表示される
  3. claude.ai にログインする（アカウントがない場合はサインアップする）
  4. 認証が完了すると、ブラウザに「認証成功」のメッセージが表示される
  5. ターミナルに戻ると、Claude Code が起動している

つまづきポイント: ブラウザが自動的に開かない場合は、ターミナルに表示される URL をコピーしてブラウザに貼り付けてください。

重要: Claude Code を使うには Pro プラン以上のサブスクリプションが必要です。Free プランのアカウントでログインすると、利用できない旨のエラーが表示されます。

API キーで認証する場合

Anthropic の API キー（有料の API アクセス）を持っている場合は、環境変数でも認証できます。

export ANTHROPIC_API_KEY="your-api-key-here"
claude

CLAUDE.md の作成

CLAUDE.md は、プロジェクトのルートディレクトリに置く設定ファイルです。このファイルに書いた内容は、Claude Code がそのプロジェクト内で作業する際に自動的に読み込まれ、プロジェクトの文脈として考慮されます。

毎回「このプロジェクトは Next.js で書かれていて...」と説明する手間がなくなります。

CLAUDE.md のテンプレート

プロジェクトのルートで以下のファイルを作成します。

touch CLAUDE.md

以下はテンプレートです。プロジェクトに合わせて書き換えてください。

# プロジェクト概要

このプロジェクトは [プロジェクトの説明を1〜2文で] です。

## 技術スタック

- 言語: TypeScript
- フレームワーク: Next.js 15 (App Router)
- データベース: PostgreSQL
- パッケージマネージャー: pnpm

## ディレクトリ構成

- `src/app/` — ページコンポーネント
- `src/components/` — 共通コンポーネント
- `src/lib/` — ユーティリティ関数
- `prisma/` — データベーススキーマ

## コーディング規約

- TypeScript の strict モードを使用する
- コンポーネントは関数型コンポーネントで書く
- テストは Vitest を使用する
- コミットメッセージは Conventional Commits に従う

## よく使うコマンド

- `pnpm dev` — 開発サーバー起動
- `pnpm build` — 本番ビルド
- `pnpm test` — テスト実行
- `pnpm lint` — Lint チェック

## 注意点

- `main` ブランチへの直接プッシュは禁止。必ず Pull Request を作成すること
- 環境変数は `.env.local` に書き、`.env.example` に変数名だけ記録すること

CLAUDE.md はプロジェクトの規模や種類に合わせて自由にカスタマイズできます。書けば書くほど Claude Code の回答精度が上がりますが、最初はシンプルなものから始めて徐々に育てていくのがおすすめです。

Tips: CLAUDE.md はホームディレクトリ（~/CLAUDE.md）にも置けます。全プロジェクト共通の設定（好みのコードスタイルや言語設定など）を書いておくと便利です。

基本的な使い方

Claude Code には3つの主な使い方があります。

1. 対話モード（会話しながら作業）

ターミナルで claude と入力するだけで、対話型のシェルが起動します。

claude

起動すると > プロンプトが表示されます。ここに自然言語で指示を入力します。

> このプロジェクトの構成を説明して
> src/app/page.tsx のコードをレビューして
> README.md を更新して
> git の差分を確認してコミットして

複数のタスクを会話形式で進めたいときや、結果を確認しながら作業を深めたいときに向いています。終了するには Ctrl + C または /exit と入力します。

2. ワンショットモード（1回だけ実行）

-p オプションを使うと、1つの指示を実行してすぐに終了します。

claude -p "このプロジェクトの README を生成して"
claude -p "src ディレクトリ内のすべての TypeScript ファイルの一覧を表示して"
claude -p "最新のコミットの内容を日本語で説明して"

スクリプトへの組み込みや、定型タスクの自動化に便利です。

3. パイプで入力を渡す

他のコマンドの出力を Claude Code に渡すこともできます。

# ファイルの内容をレビューしてもらう
cat src/utils/format.ts | claude -p "このコードをレビューして改善点を教えて"

# エラーログを解析してもらう
cat error.log | claude -p "このエラーログを解析して原因を特定して"

# git diff の内容を確認してもらう
git diff | claude -p "この変更の概要をコミットメッセージ形式で書いて"

つまづきポイント: 対話モードで長い会話を続けると、コンテキスト（AI が覚えられる情報の量）の上限に近づくことがあります。その場合は /compact コマンドで会話を要約するか、/clear で会話をリセットしましょう。

主要なスラッシュコマンド

対話モード中に使えるスラッシュコマンドの一覧です。

コマンド説明
/help使えるコマンドの一覧を表示する
/clear会話の履歴をリセットする（新しいタスクを始めるとき）
/compact会話を要約してコンテキストを節約する
/cost現在のセッションで使ったトークン数とコストを表示する
/model使用するモデルを切り替える（Sonnet / Opus など）
/exitClaude Code を終了する
/bugバグや問題を Anthropic に報告する
/review最後のレスポンスを評価する（フィードバック送信）

コンテキストのコントロール

Claude Code が参照するファイルを明示的に指定することもできます。

# 特定のファイルを読み込んで起動
claude --file src/components/Button.tsx

# ディレクトリを指定して起動
claude --dir src/components

対話中に @ファイルパス と入力すると、そのファイルをコンテキストに追加できます。

> @src/api/users.ts このファイルの型定義を整理して

Tips: 大規模なプロジェクトでは、最初に > このプロジェクトの CLAUDE.md を読んで、構成を把握して と頼むと、その後の会話の精度が上がります。

実際に試してみる

インストールが完了したら、実際に動かしてみましょう。既存のプロジェクトがある場合はそのディレクトリで、ない場合はどこか適当なフォルダで試せます。

# プロジェクトのディレクトリに移動
cd your-project

# Claude Code を起動
claude

# 試してみるコマンド例
> 今いるディレクトリの構成を説明して
> README.md があれば読んで内容を要約して
> git log の最新10件を日本語で説明して

最初の一歩として、Claude Code に現在のプロジェクトを把握してもらうことから始めるのがおすすめです。

次のステップ

Claude Code の基本的な使い方を理解できたら、さらにステップアップしましょう。