Chapter 22: Claude Code セットアップ

22.1 Claude Code とは

Claude Code は Anthropic が提供する CLI（コマンドラインインターフェース）形式の AI 開発アシスタントです。ターミナル上で Claude と対話しながら、プロジェクト全体にわたる開発作業を自律的に進めることができます。

VS Code の拡張機能としても動作しますが、本章ではターミナルからの利用を中心に説明します。

Claude Code は Node.js で動作します。まず Node.js をインストールします。

# Node.js のバージョン確認（18 以上が必要）
node --version

Node.js がインストールされていない場合は nodejs.org からインストールしてください（LTS 版を推奨）。

npm でグローバルインストールします。

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

インストール後、バージョンを確認します。

claude --version

Claude Code は Anthropic のアカウントで認証します。

claude

初回起動時に認証フローが開始されます。

TODO: あとで実際のスクリーンショットに置き換え - claude コマンド初回起動時の認証フロー画面

Anthropic API キーを使う場合:

既に API キーを持っている場合は環境変数で設定できます。

export ANTHROPIC_API_KEY="sk-ant-..."

または .env ファイルに記載してプロジェクトで管理します（.gitignore に追加することを忘れずに）。

# 対話モードで起動（プロジェクトディレクトリで実行）
cd /path/to/your/project
claude

# 1回だけ質問して終了（-p オプション）
claude -p "このプロジェクトの構造を説明してください"

# 前のセッションを再開
claude --resume

Claude Code との対話中に使える特殊コマンドがあります。

# テキスト入力中に @ でファイルを参照
@src/index.ts を読んで、何をしているか説明してください

# 画像も参照可能（スクリーンショットなど）
このエラー画像を見て原因を教えてください
# → 画像ファイルをドラッグ＆ドロップまたはパスを入力

Claude Code はファイルの読み書きやコマンド実行を行うため、何ができるかを制御する権限モデルがあります。

コマンド実行やファイル書き込み時には確認が求められます。

Claude wants to run: npm test

Do you want to proceed?
> Yes  No  Always allow this command

信頼できるプロジェクトで素早く作業したい場合、--dangerously-skip-permissions オプション（または --yes-always）を使うと確認をスキップできます。

注意: 自動承認は信頼できるプロジェクト内でのみ使用してください。外部から取得したコードやスクリプトに使うのは危険です。

# 確認を自動承認して実行（注意して使用）
claude --dangerously-skip-permissions

セットアップが完了したら、実際に Claude Code を使ってみましょう。

mkdir my-first-project
cd my-first-project

claude

Hello! このディレクトリに、簡単な Python スクリプトを作成してください。
ユーザーから名前を入力してもらい、「こんにちは、{名前}さん！」と出力するスクリプトです。

Claude Code はファイルの作成を提案し、確認後にファイルを作成します。

# greeting.py（Claude Code が生成する例）
def main():
    name = input("お名前を入力してください: ")
    print(f"こんにちは、{name}さん！")

if __name__ == "__main__":
    main()

このスクリプトを実行してください

Claude Code が python greeting.py を実行し、結果を確認します。

TODO: あとで実際のスクリーンショットに置き換え - Claude Code がファイルを作成してコマンドを実行している様子