はじめに（導入ガイド）

このページでは、Claude Code をゼロからセットアップして使い始めるまでの全手順を、新入社員でも迷わないレベルの詳しさで解説します。各ステップで「なぜこの手順が必要か」を補足し、エラーが出た場合の対処法もあわせて掲載しています。

Claude Code とは

従来の開発との違い

Claude Code を使った開発は、従来の開発とは根本的にワークフローが異なります。

Claude Code がどのような位置づけのツールなのか、全体像を図で確認しましょう。開発者がターミナルや IDE から Claude Code を起動すると、AI がコード生成、レビュー、Git 操作、外部ツール連携といった幅広い作業を代行してくれます。

このように、Claude Code は単なるコード補完ツールではなく、開発ワークフロー全体をサポートするパートナーです。ここからは、このツールを使い始めるための手順を一つずつ進めていきましょう。

Claude Code でできること

具体的にどのようなことができるのか、代表的なユースケースを紹介します。

前提条件の確認

2.1 Node.js の確認

Node.js は JavaScript をサーバーサイドで動かすための実行環境です。Claude Code は Node.js のパッケージマネージャー（npm）を通じてインストールするため、Node.js が必須です。

以下のコマンドをターミナルで実行して、Node.js がインストールされているか確認します。

# このコマンドは Node.js のバージョンを表示します
node --version
# v18.0.0 以上が表示されれば OK

2.2 npm の確認

npm（Node Package Manager）は Node.js のパッケージ管理ツールです。Claude Code を含む世界中の JavaScript パッケージをインストール・管理できます。

# このコマンドは npm のバージョンを表示します
npm --version
# 9.0.0 以上が表示されれば OK

2.3 Git の確認

Git はバージョン管理システムです。Claude Code はプロジェクトの変更履歴を Git で管理し、ブランチ作成やコミットなどの操作も行います。

# このコマンドは Git のバージョンを表示します
git --version
# git version 2.x.x が表示されれば OK

2.4 まとめて確認

以下のコマンドを実行して、3つのツールが全てインストールされていることを一度に確認できます。

# 3つのバージョンを一度に確認するコマンドです
# && は「前のコマンドが成功したら次を実行する」という意味です
node --version && npm --version && git --version

3行のバージョン番号が全て表示されれば、前提条件はクリアです。次のステップに進みましょう。

Claude Code のインストール

以下のコマンドを実行して、Claude Code をインストールします。

# Claude Code をグローバルインストールします
npm install -g @anthropic-ai/claude-code

このコマンドの各部分の意味は以下の通りです。

インストールの確認

インストールが完了したら、以下のコマンドで正しくインストールされたか確認します。

# Claude Code のバージョンを表示します
claude --version

バージョン番号が表示されれば、インストール成功です。

初回起動とログイン

Claude Code をインストールしたら、次はツールを起動して認証を行います。初回起動時にアカウント認証が求められ、認証が完了すると Claude Code が使えるようになります。

4.1 Claude Code の起動

任意のディレクトリ（プロジェクトフォルダが望ましい）でターミナルを開き、以下のコマンドを実行します。

# Claude Code を起動します
# プロジェクトのルートディレクトリで実行するのがおすすめです
claude

4.2 認証方法

Claude Code には 3 つの認証方法があります。状況に応じて最適な方法を選択してください。

方法 1: ブラウザ認証（推奨）

最も簡単な方法です。初回起動時にブラウザが自動で開くので、画面の指示に従ってログインするだけです。

# ブラウザ認証（自動）
# ターミナルで claude を実行すると、ブラウザが自動的に開きます
claude
# → ブラウザが開くのでログインしてください
# → ログイン完了後、ターミナルに戻ると使用可能になっています

方法 2: API キーで認証

CI/CD 環境やサーバーなど、ブラウザが使えない環境では API キーを使います。Anthropic Console で API キーを発行してください。

# 環境変数に API キーを設定してから起動します
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"
claude

方法 3: 起動時に API キーを直接渡す

一時的に使用する場合や、テスト目的で使用する場合に便利です。

# 起動時にキーを渡します
claude --api-key "sk-ant-xxxxxxxxxxxxx"

# ~/.bashrc（Bash の場合）または ~/.zshrc（Zsh の場合）に追記
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

# 設定を反映します
source ~/.bashrc

4.3 初回起動の画面説明

認証が完了すると、ターミナルに Claude Code の対話画面が表示されます。主な要素は以下の通りです。

基本操作

Claude Code が起動したら、さっそく基本的な操作を試してみましょう。Claude Code は自然言語（日本語 OK）で指示を出すだけで、さまざまな作業を実行できます。

5.1 質問する

最もシンプルな使い方です。コードについて質問すると、Claude が回答してくれます。

> この関数は何をしていますか？
> このエラーメッセージの原因を教えてください
> React の useEffect フックの使い方を説明してください

5.2 ファイルを読む・編集する

Claude Code はプロジェクト内のファイルを直接読み書きできます。ファイルパスを指定して指示するだけです。

# ファイルの内容を確認する
> src/index.ts を読んで内容を教えてください

# ファイルを編集する
> src/utils.ts の calculateTotal 関数にエラーハンドリングを追加してください

# 新しいファイルを作成する
> src/helpers/validation.ts にメールアドレスのバリデーション関数を作成してください

5.3 コマンドを実行する

テストの実行やビルドなど、ターミナルコマンドの実行も Claude Code に任せられます。

# テストを実行する
> npm test を実行してください

# ビルドする
> npm run build を実行してください

# lint を実行する
> eslint で src/ 配下をチェックしてください

5.4 Git 操作

Claude Code は Git 操作もサポートしています。ブランチの作成、コミット、差分の確認などを自然言語で指示できます。

# 変更の確認
> git diff を見せてください

# コミット
> 現在の変更を「ログイン機能のバリデーションを追加」というメッセージでコミットして

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

# 差分の要約
> main ブランチとの差分を要約してください

5.5 スラッシュコマンド

Claude Code にはスラッシュ（/）で始まる組み込みコマンドがあります。よく使う操作を素早く実行できます。

5.6 終了方法

Claude Code を終了するには、以下のいずれかの方法を使います。

# 方法 1: スラッシュコマンドで終了
/exit

# 方法 2: キーボードショートカットで終了
# Ctrl+C を押す（2回押す場合もあります）

# 方法 3: 自然言語で終了
> 終了してください

スターターキットの使い方（任意）

Claude Code Starter Kit は、チームですぐに Claude Code を使い始められるテンプレート集です。CLAUDE.md やルール、カスタムコマンドなどがあらかじめ整備されており、クローンして起動するだけで使えます。

クローンから起動まで

# 1. リポジトリをクローンします
# このコマンドは GitHub からスターターキットのソースコード一式をダウンロードします
git clone https://github.com/sas-dx/claude-code-starter-kit.git

# 2. クローンしたディレクトリに移動します
cd claude-code-starter-kit

# 3. Claude Code を起動します
# .claude/CLAUDE.md が自動的に読み込まれ、ルールが適用されます
claude

ディレクトリ構成

スターターキットの .claude/ ディレクトリには、以下のような構成でファイルが配置されています。各ディレクトリの役割を理解しておくと、カスタマイズがスムーズに進みます。

.claude/
├── CLAUDE.md          # プロジェクト指示書（最も重要な設定ファイル）
├── settings.json      # 権限・環境の設定
├── rules/             # トピック別のルールファイル
│   ├── coding-standards.md   # コーディング規約
│   ├── git-workflow.md       # Git ワークフロー
│   ├── security.md           # セキュリティルール
│   ├── testing.md            # テストルール
│   └── review-process.md     # コードレビュールール
├── commands/          # カスタムスラッシュコマンド
│   ├── code-review.md        # /code-review コマンド
│   ├── dev-issue.md          # /dev-issue コマンド
│   └── ...
├── agents/            # サブエージェント定義
│   ├── code-reviewer.md      # コードレビュー専門エージェント
│   └── ...
└── skills/            # スキル定義
    └── ...            # 専門知識の形式知化

起動後に試せること

スターターキットには、すぐに試せるカスタムコマンドやサブエージェントが含まれています。

# カスタムコマンドを試す
/code-review #1          # PR やコードのレビューを実行します
/explain-code src/app.ts  # 指定したファイルのコードを解説します
/dev-issue #42            # GitHub Issue に基づいて実装を行います

# CLAUDE.md を自分のプロジェクト用にカスタマイズ
/init                     # 現在のプロジェクトに合わせて CLAUDE.md を自動生成します

既存プロジェクトへの導入手順

スターターキットを参考に、既存のプロジェクトに Claude Code の設定を導入する手順です。

# 1. 自分のプロジェクトのルートディレクトリに移動
cd /path/to/your-project

# 2. スターターキットの .claude ディレクトリをコピー
cp -r /path/to/claude-code-starter-kit/.claude .

# 3. CLAUDE.md をプロジェクトに合わせて編集
#    技術スタック、開発コマンド、ディレクトリ構造を自分のプロジェクトの情報に書き換えます
vi .claude/CLAUDE.md

# 4. .claude ディレクトリを Git に追加（チーム共有のため）
git add .claude/
git commit -m "Claude Code の設定ファイルを追加"

# 5. Claude Code を起動して動作確認
claude

IDE 連携（任意）

Claude Code はターミナル（CLI）から使うだけでなく、普段使っている IDE（統合開発環境）の拡張機能としても利用できます。CLI と IDE 拡張は同じ設定ファイルを共有するため、どちらから使っても同じルールが適用されます。

7.1 VS Code

VS Code で Claude Code を使うには、拡張機能をインストールします。

方法 1: コマンドラインからインストール

# このコマンドは VS Code の拡張機能をターミナルからインストールします
code --install-extension anthropic.claude-code

方法 2: VS Code のマーケットプレイスからインストール

1. VS Code を開きます
2. 左サイドバーの拡張機能アイコン（四角が4つ並んだマーク）をクリックします
3. 検索バーに「Claude Code」と入力します
4. Anthropic が提供する拡張機能を見つけて「インストール」をクリックします

7.2 JetBrains（IntelliJ, WebStorm 等）

JetBrains 系の IDE（IntelliJ IDEA, WebStorm, PyCharm, PhpStorm 等）でも Claude Code を使用できます。

1. IDE を開きます
2. Settings（Ctrl+Alt+S / Cmd+,）を開きます
3. Plugins > Marketplace に移動します
4. 「Claude Code」で検索し、インストールします
5. IDE を再起動します

よくあるトラブルと対処法

導入時によく遭遇するトラブルとその対処法をまとめました。問題が発生した場合は、まずこの一覧を確認してください。

次のステップ

Claude Code の導入が完了しました。ここからは、チームの開発ワークフローに合わせて Claude Code をカスタマイズしていきましょう。以下のページで各機能の詳細を学べます。