Claude Codeとは何か
Claude Codeは、Anthropic社が提供するターミナルベースのAIコーディングアシスタントです。プロジェクトフォルダ内で起動すると、ファイル構造を自動で読み取り、コード生成・編集・デバッグ・Git操作までを自然言語の対話で完結できます。
GUIベースのAIエディタと異なり、ターミナル上で動作するため軽量かつ高速。既存のエディタやツールチェーンをそのまま活かせるのが大きな強みです。
インストール前に確認すること
動作環境
- OS: macOS、Linux、Windows(WSL経由またはPowerShellプレビュー対応)
- Node.js: バージョン18以上
- 認証: Anthropicアカウント(Pro/Max/Teamサブスク)またはAPIキー
Node.jsが入っていない場合は、公式サイトからLTS版をインストールしてください。ターミナルで node -v と打てばバージョンを確認できます。
3つのインストール方法
Claude Codeには3つの導入パターンがあります。目的に応じて選んでください。
- ターミナル(npm): 最も一般的。コマンド1行で完了
- デスクトップアプリ: GUIからClaude Codeセッションを起動できる
- ブラウザ(claude.ai): インストール不要でブラウザ上から利用
本記事では、最も柔軟に使えるターミナル版を中心に解説します。
インストール手順(ターミナル版)
Step 1: npmでインストール
ターミナルを開き、以下のコマンドを実行します。
npm install -g @anthropic-ai/claude-code
グローバルインストールなので、どのフォルダからでも claude コマンドが使えるようになります。
Step 2: 初回起動と認証
作業したいプロジェクトのフォルダに移動し、claude と入力します。
cd ~/my-project claude
初回起動時にAnthropicアカウントでの認証画面が表示されます。ブラウザが自動で開くので、ログインして許可するだけです。
APIキーで認証する場合は、環境変数 ANTHROPIC_API_KEY を設定します。
export ANTHROPIC_API_KEY="sk-ant-xxxxx"
Step 3: 動作確認
起動後、対話画面が表示されたら成功です。試しに以下のように入力してみましょう。
このプロジェクトの構造を教えて
フォルダ構成やファイルの役割を分析して回答してくれます。
初期設定で差がつくポイント
CLAUDE.mdを作る
プロジェクトのルートに CLAUDE.md というファイルを作ると、Claude Codeが毎回そのファイルを読み込みます。プロジェクト固有のルールやコーディング規約を書いておけば、指示するたびに同じ説明を繰り返す必要がなくなります。
実務で効果的なCLAUDE.mdには、フレームワーク名・バージョン、命名規則、テストの実行コマンド、デプロイ手順を書きます。ただし、最初から完璧を目指す必要はありません。使いながら追記していくのが現実的です。
記憶の3層構造を理解する
Claude Codeには3つの記憶階層があります。設定がうまく反映されない場合、記憶の置き場所を間違えていることがほとんどです。
- ~/.claude/CLAUDE.md: 全プロジェクト共通のルール
- プロジェクト直下のCLAUDE.md: そのプロジェクト専用のルール
- 会話内の指示: そのセッション限りの一時的な指示
「何度言っても守ってくれない」という場合は、会話内で伝えているルールをCLAUDE.mdに書き出すと解決します。会話が長くなると初期の指示が文脈から押し出されてしまうためです。
料金プランの選び方
Claude Codeは以下のプランで利用できます。
- Claude Pro(月額$20): 個人利用の標準プラン
- Claude Max(月額$100/$200): 大量のコード生成や長時間セッション向け
- API利用: 従量課金。自動化やCI連携に向く
- Team/Enterprise: 組織向け。権限管理やセキュリティ設定が充実
まずはProプランで始めて、利用量が増えたらMaxへアップグレードするのが堅実です。詳細はAnthropic公式の料金ページでご確認ください。
よくあるトラブルと対処法
- 「command not found: claude」と出る: Node.jsのグローバルパスが通っていない可能性があります。
npm config get prefixで確認し、PATHに追加してください - 認証画面が開かない: ブラウザのポップアップブロックを確認するか、APIキーでの認証に切り替えてください
- 起動が遅い: 大量のファイルがあるフォルダで起動すると初回読み込みに時間がかかります。
.gitignoreで不要なフォルダを除外すると改善します
次のステップ
インストールと初期設定が完了したら、次は基本操作を覚えましょう。ファイル操作、コード生成、Git連携など、日常的に使うコマンドの使い方を次のレッスンで解説します。