← すべての記事

Claude Code CLI セットアップ 2026：5分で始めるクイックスタート

2分で読めます
From the guide: Claude Code Comprehensive Guide

Claude Codeのセットアップ方法は？ npm install -g @anthropic-ai/claude-codeでCLIをグローバルインストールし、ブラウザ経由で認証を行い、プロジェクトルートにCLAUDE.mdファイルを作成してスタック情報とコーディング規約を記述します。.claude/settings.jsonで権限を設定し、編集のたびにスタイルを自動修正するフォーマットフックを追加します。セットアップ全体は5分以内で完了します。 {.answer-block}

ServiceNowでは29,000人を超える開発者が日常的にClaude Codeを使用しており1、Allianzは2026年初頭に全社的に導入しました2。このツールの採用曲線はあるパターンを示しています。ターミナル内でエージェント型コーディングを一度試すと、チャットウィンドウからのコピペには戻れなくなるのです。このクイックスタートは、AIエンジニアリングシリーズの一部であり、Claudeを使って開発する方向けの実践的ガイドとなっています。以下のウォークスルーでは、ゼロから約5分でClaude Codeセッションを動かすところまで、後々も使える実践的な設定とともにご案内します。

TL;DR： npm install -g @anthropic-ai/claude-codeでClaude Codeをインストールし、ブラウザ経由で認証、プロジェクトのコンテキストを記載したCLAUDE.mdファイルを作成、.claude/settings.jsonで権限を設定します。ファイル編集のたびに自動フォーマットを実行するPrettierフックを追加しましょう。セットアップ全体は5分以内で、設定はセッションをまたいで永続化されます。

重要ポイント

  • 個人開発者： CLAUDE.mdとフォーマットフックで必要な作業の80%をカバーできます。まずはデフォルト権限で始め、信頼を築きながらツールを事前承認していきましょう。
  • チームリード： .claude/settings.jsonをリポジトリにコミットすることで、チーム全員が同じ権限許可リストとフックを共有できます。
  • セキュリティエンジニア： 3段階の権限モデル4（Ask、Allowlisted、--dangerously-skip-permissions）は信頼レベルに直接対応します。Askモードではすべての書き込みとコマンド実行に明示的な承認が必要となります。

前提条件

Claude Codeをインストールする前に、3つのものが必要です。

Node.js 18以降。 Claude Codeはnpmパッケージとして提供されています3。バージョンを確認しましょう。

node --version
# v18.0.0 or higher

Node.jsのインストールやアップグレードが必要な場合は、nvmを利用するか、nodejs.orgから直接ダウンロードしてください。

APIアクセス権付きのAnthropicアカウント。 console.anthropic.comにアクセスし、Settings > API KeysからAPIキーを作成します。Claude CodeはAPI残高に対してトークン単位で課金されますが、Maxサブスクリプションプラン（2026年3月時点で個人$100/月、チーム$200/月）も利用できます6。キーは認証ステップで使用するため手元に置いておきましょう。

ターミナル。 Claude Codeはあらゆるターミナルエミュレータで動作します。Terminal.app、iTerm2、Windows Terminal、Alacritty、VS Codeの統合ターミナルなどが利用可能です。Claude Codeはファイル差分やツール出力を表示するため、横幅を活かせる120カラム以上のターミナルをおすすめします。

インストール

npm経由でClaude Codeをグローバルインストールします。

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

インストールが成功したことを確認しましょう。

claude --version

バージョン番号がstdoutに出力されるはずです。「command not found」エラーが出た場合、npmのグローバルbinディレクトリがPATHに含まれていません。npm config get prefixを実行し、その/binサブディレクトリをシェルのPATHに追加してください。HomebrewでNodeをインストールしたmacOSの場合、プレフィックスは通常/usr/localなので、まだ追加されていなければ/usr/local/binを追加します。

よくあるインストール時の問題： npm install -gでEACCES権限エラーが発生しても、sudoは使わないでください。代わりに、ユーザーが書き込み可能なディレクトリを使うようnpmを設定します7。

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# Add to your shell profile (~/.zshrc or ~/.bashrc):
export PATH="$HOME/.npm-global/bin:$PATH"

初回起動時、Claude CodeはOAuth認証のためブラウザでAnthropicコンソールを開きます。ログインして承認すると、Claude Codeはトークンを~/.claude/にローカル保存します。あるいは、起動前にANTHROPIC_API_KEY環境変数を設定することもできます。いずれの方法でも、認証情報はマシン上に留まり、APIリクエストの認証にのみ使用されます。

初回セッション

任意のプロジェクトディレクトリに移動して実行します。

cd ~/Projects/my-app
claude

Claude CodeはインタラクティブなREPLセッションを開始します。新しいプロジェクトでの初回起動時、Claudeは自動的にいくつかの処理を行います。

  1. プロジェクトの構造を把握するためディレクトリ構造をスキャン
  2. package.json、pyproject.toml、Cargo.tomlなどの設定ファイルを読み込み、技術スタックを特定
  3. プロジェクト固有の指示のため、プロジェクトルートのCLAUDE.mdファイルを探索

すべてが動作していることを確認するため、シンプルなプロンプトを試してみましょう。

> Explain the structure of this project

Claudeはファイルを読み込み、アーキテクチャを統合し、ターミナル上で応答します。ツール呼び出しがリアルタイムに表示され（各ファイルの読み込みや各コマンドの実行）、書き込み操作の前には権限の確認が求められます。

初回セッションで注目すべきポイント。 2つの点に注意を払いましょう。ツール呼び出し（各アクション前にリアルタイム表示）と権限プロンプトです。ツール呼び出しからは、Claudeがコードベースをどう辿っているかがわかります。自分では確認しようと思わなかったファイルまで読み込んでおり、それが有用なコンテキストを引き出していることに気づくはずです。権限プロンプトは、ディスクに何かが書き込まれる前に、Claudeが何を変更しようとしているかを正確に示してくれます。提案された編集がおかしいと感じたら拒否して説明を追加しましょう。Claudeはセッション内でフィードバックに基づいてアプローチを調整します8。

CLAUDE.mdのセットアップ

CLAUDE.mdは、Claude Codeを効果的に使う上で最も重要な単一ファイルです。これが無いと、Claudeはファイル内容からスタックを推測し、それなりの判断を下します。一方、このファイルがあれば、Claudeは最初のプロンプトからあなたの規約に正確に従います。この違いが重要なのは、推測ベースの挙動がドリフトを起こすからです。ClaudeがESMプロジェクトでCommonJSを使ったり、誤ったテストランナーを選んだり、データベースマイグレーションのワークフローを無視したりするかもしれません。CLAUDE.mdはそうしたドリフトを解消します。

プロジェクトルートにファイルを作成しましょう。

touch CLAUDE.md

Pythonプロジェクトの実用的なスタートテンプレートはこちらです。

# My App

## Project Context
FastAPI backend with HTMX frontend. PostgreSQL database.

## Stack
- Backend: Python 3.11, FastAPI, SQLAlchemy 2.0 (async)
- Frontend: HTMX + Alpine.js, Jinja2 templates
- Database: PostgreSQL 16, Alembic migrations
- Testing: pytest with pytest-asyncio

## Code Standards
- Type hints on all function signatures
- Pydantic v2 models for request/response validation
- Async database operations only (no sync SQLAlchemy)

## Commands
- `source venv/bin/activate` before any Python command
- `uvicorn app.main:app --reload` starts the dev server
- `python -m pytest -v` runs the test suite
- `alembic upgrade head` applies database migrations

JavaScript/TypeScriptプロジェクトの場合、構造は似たようなものになります。

# My App

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit, Playwright for e2e

## Code Standards
- ESM imports only (no require())
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging

## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations

CLAUDE.mdで最も価値があるのは、繰り返されるミスを防ぐセクションです。Claudeがimportではなくrequire()でインポートし続けるなら、Code Standardsに「ESM imports only」を追加しましょう。テストコマンドで先にvirtualenvを有効化する必要があるなら、その手順をドキュメント化します。Claudeはセッション開始時にCLAUDE.mdを読み込むので、各行が永続的な指示となり、数百回のやり取りを通じて効果が積み重なっていきます。CLAUDE.mdファイルを効果的にするパターンについてはAGENTS.md Patternsで、より広い原則としてcontext is architectureで詳しく扱っています。AGENTS.mdオープン仕様9は他のエージェント型ツール向けに同様のパターンを採用していますが、CLAUDE.mdはスキルやルールディレクトリといった、より豊富な機能をサポートしています。

階層構造が重要です。 CLAUDE.mdは3つの場所に配置でき、Claudeは固有性の順でマージします。

  1. ~/.claude/CLAUDE.md：全プロジェクト共通のグローバル指示（個人のコーディング設定）
  2. ./CLAUDE.md：プロジェクトレベルの指示（リポジトリにコミットし、チームで共有）
  3. ./src/CLAUDE.md：ディレクトリレベルの指示（モノレポのモジュールやサブシステムに限定）

プロジェクトレベルのCLAUDE.mdがバージョン管理にコミットすべきものです。Claude Codeを使うチームメンバーは、あなたの規約を自動的に継承できます。

権限の基本

Claude Codeは3つの権限階層で動作し4、それぞれエージェントにどの程度の自律性を与えるかを決定します。選択する階層は根本的なトレードオフを制御します。自律性が高いほどセッションは速くなりますが、何が変更されるかの可視性は下がります。

Askモード（デフォルト）では、すべてのファイル書き込み、コマンド実行、破壊的アクションの前に承認が必要となります。Claudeが何をしようとしているか正確に確認し、各ステップを承認または拒否できます。承認プロンプトがClaude Codeの動作を理解する助けになるため、まずはここから始めることをおすすめします。数セッションを経るうちに、どの操作が事前承認しても安全で、どの操作は毎回精査すべきかの直感が身についていきます。

Allowlisted権限では、特定のツールやパターンを事前承認しておくことで、Claudeが毎回尋ねないようにできます。プロジェクトの.claude/settings.jsonで設定します。

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(python -m pytest*)",
      "Bash(alembic upgrade head)"
    ]
  }
}

上記の設定では、Claudeがファイルを読み込み、コードベースを検索し、テストやマイグレーションコマンドを確認なしに実行できます。ただし、ファイルの書き込みやその他のbashコマンドの実行前には依然として確認があります。パターンに注目してください。読み取り操作や安全とわかっているコマンドは許可リストに入れます。書き込み操作は、Claudeが書き込む内容をディスクに反映される前に確認したいため、Askモードに留めておきます。

Dangerously skip permissions（--dangerously-skip-permissions）はすべての確認プロンプトを無効にします。このフラグは、承認する人間が存在しないCI/CDパイプラインや自動化ワークフロー専用です。大切にしているコードベースでのインタラクティブセッションでは絶対に使わないでください。

権限システムにより、Claude Codeは実際のプロジェクトで安全に使えるようになっています。段階的な進行には意図があります。まずAskモードで理解を深め、繰り返し行う操作を許可リストに追加し、書き込み操作はゲートしたままにすることで、変更が反映される前に必ずレビューできるようになります。

最初のフック

フックは、Claude Codeのライフサイクル内の特定のポイントで実行されるシェルコマンドです5。ゼロから5つのプロダクションフックを構築するフックチュートリアルを執筆していますし、次のレベルの自動化についてはbuilding custom skillsでカバーしています。フックはLLMベースのツールが抱える根本的な問題を解決します。モデルは大抵の場合フォーマットルールに従いますが、「大抵の場合」というのは10回に1回はスタイルの不整合が発生することを意味します。モデルが確率的な保証しか提供できないところに、フックは決定論的な保証をもたらします。フォーマットフックは、モデルが何を決めたかに関わらず、毎回、ファイル書き込みのたびにフォーマッタを実行します。実用的な最初のフックはこちらです。Claudeがファイルを編集した後に自動フォーマットを行うものです。

プロジェクト内の.claude/settings.jsonを作成または編集します。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

PostToolUseフック5は、EditまたはWriteツール呼び出しの後に発火します。Claude Codeは変更されたファイルのパスを$FILE_PATHにセットします。Prettierがそれを上書きフォーマットし、|| trueによって、Prettierが未インストールだったりファイルタイプが非対応だったりしても、非ゼロ終了コードでClaudeをブロックしないようにします5。

その他のおすすめ実践的スターターフックはこちらです。

  • PreToolUse on Bash：rm -rf /やgit push --forceなどの危険なコマンドをブロック
  • SessionStart：現在の日付、アクティブなgitブランチ、環境変数をコンテキストに注入（SessionStartフックのstdoutがClaudeのコンテキストに投入されます）
  • Stop：Claudeがタスクを完了したときに自動的にテストスイートを実行

フックはClaude Codeを会話型ツールから、統制された開発環境へと変貌させます。1つか2つ、選び抜かれたフックだけでも、まるごと一つのカテゴリのミスを排除できます。

トラブルシューティング

Claude Code利用の最初の1週間で繰り返し発生する状況が3つあります。事前に知っておくとデバッグ時間の節約になります。

ClaudeがCLAUDE.mdの指示を無視する。 最もよくある原因は、編集前にClaudeが既にファイルを読み込み、その理解をキャッシュしているケースです。/clearでコンテキストをリセットするか、新しいセッションを開始しましょう。Claudeはセッション開始時にCLAUDE.mdを再読み込みしますが、プロンプトごとではありません。新しいセッションでもClaudeが指示を無視する場合、より優先度の高いCLAUDE.md（~/.claude/CLAUDE.mdのユーザーレベル）がプロジェクトレベルのファイルと競合していないか確認してください。

Claudeが承認していない変更を行う。 パターンを広く許可しすぎた場合（例：Bash(python -m pytest*)ではなくBash(*)）、Claudeは確認なしでコマンドを実行できてしまいます。許可リストのパターンを狭めましょう。最も安全な方法は、読み取り操作と特定の名前付きコマンドのみを許可リストに入れることです。Claudeが既に望まない変更を加えてしまった場合、git diffで何が変わったかを正確に確認でき、git checkout -- <file>で戻せます。

長いセッション中にコンテキストウィンドウが満杯になる。 Claude Codeは200Kのコンテキストウィンドウが満杯になると以前のメッセージを圧縮しますが、圧縮によって会話初期の重要な詳細が失われることがあります。30分を超えるセッションでは、作業中の変更を定期的にコミットし、/clearで新しいセッションを開始しましょう。新しいコンテキストはCLAUDE.mdを再読み込みし、クリーンな状態から始まります。私は完了したサブタスクごとにコミットしており、これによりロールバックポイントと自然なセッション境界の両方を得ています。

Claudeが誤ったファイルを編集する、または不要な変更を加える。 Claudeが頼んでいないコードの「改善」を始めてしまう場合、原因は大抵プロンプトのあいまいさです。「authモジュールをクリーンアップして」と言うのではなく、「app/auth/handlers.pyでverify_userをverify_user_credentialsにリネームして、すべての呼び出し元を更新して」と伝えましょう。具体性が、望まない副作用を減らします。Claudeが既に望まない編集を加えた場合、git diffで何が変わったかを正確に確認でき、git checkout -- <file>で他の作業を失うことなく個別のファイルを戻せます。

次のステップ

上記のウォークスルーでは、インストール、初回セッション、プロジェクト設定、権限、スターターフックといった本質的な部分をカバーしました。Claude Codeを他のエージェント型ツールと比較するにはClaude Code vs Codexを、5つのコアシステムすべて（CLAUDE.mdの階層、完全な権限モデル、フックアーキテクチャ、カスタムスラッシュコマンド、マルチエージェントワークフロー）を網羅した完全リファレンスとしてはThe Complete Guide to Claude Codeをお読みください。

ガイドではコンテキストウィンドウ管理、サブエージェントへの委譲、スキル自動起動、そしてClaude Codeを日常的に使用して数ヶ月経ってから見えてくるパターンを扱っています。このクイックスタートが役立ったと感じられたなら、完全ガイドが自然な次のステップとなります。すべてのコマンド、フラグ、ショートカットを素早く調べられるリファレンスとしては、Claude Code Cheat Sheetをご参照ください。

参考文献

FAQ

Claude Codeをインストールするための要件は？

Node.js 18以降（Claude Codeはnpmパッケージとして提供されています）、APIアクセス権付きのAnthropicアカウントまたはMaxサブスクリプション、そして任意のターミナルエミュレータが必要です。Claude CodeはmacOS、Linux、Windows（WSLまたはネイティブ経由）で動作します。Node.js以外に追加の依存関係、Dockerコンテナ、言語ランタイムは不要です。インストールコマンドはnpm install -g @anthropic-ai/claude-codeです。

CLAUDE.mdとは何か、なぜ必要なのか？

CLAUDE.mdは、プロジェクトルートに置くmarkdownファイルで、スタック、コーディング規約、よく使うコマンドをClaude Codeに伝えます。これが無いと、Claudeはファイル内容からセットアップを推測し、それなりの判断を下します。しかしそうした判断はセッションごとにドリフトします。CLAUDE.mdがあれば、Claudeは最初のプロンプトから、セッションごとに、あなたの規約に正確に従います。3階層の階層構造（ユーザーレベル（~/.claude/CLAUDE.md）、プロジェクトレベル（./CLAUDE.md）、ディレクトリレベル（./src/CLAUDE.md））をサポートし、固有性の順にマージされます。

Claude Codeの費用はいくら？

Claude Codeは2つの課金モデルをサポートしています。APIの従量課金モデルは、標準的なAnthropic API料金でトークン単位で課金されます6。30〜60分の典型的なセッションでは、コードベースのサイズと生成量に応じて$0.50〜$3.00の費用となります。もう一つの選択肢として、AnthropicのMaxプラン6（2026年3月時点で個人$100/月、チーム$200/月）では、より高いレート制限でClaude Codeの利用が含まれます。APIの使用状況はconsole.anthropic.comでモニターできます。

VS CodeとClaude Codeを一緒に使えますか？

はい。Claude CodeはVS Codeの統合ターミナルを含む、任意のターミナルで動作します。VS Codeのターミナルパネルを開き、プロジェクトディレクトリに移動し、単独のターミナルと同じようにclaudeを実行してください。Claude Codeはディスク上のファイルを読み書きするため、変更はVS Codeのエディタタブに即座に反映されます。別途VS Code拡張機能は必要ありません。エディタの横にClaude Code専用のターミナル分割を常設している開発者もおり、変更をリアルタイムにレビューするのに便利です。

Claude Codeはプロダクションコードベースで安全に使えますか？

Claude CodeのAskモードでは、すべてのファイル書き込みとコマンド実行の前に明示的な承認が必要です。確認なしにディスク上の内容が変わることはありません。権限システムと、フォースプッシュや破壊的なシェルコマンドといった危険な操作をブロックできるフックを組み合わせることで、Claude Codeはプロダクション作業に実用的となります。私自身、実ユーザーに提供するプロジェクトでClaude Codeを日々使っています。鍵となるのは、Askモードで始めること、承認前に各ツール呼び出しが何をするかを理解すること、そして信頼できる操作のみを段階的に許可リストに入れることです。バージョン管理が最後のセーフティネットを提供します。重要なClaude Codeセッションを始める前にコミットしておけば、いつでも戻せるのです。

新規ユーザーが最もよく犯すミスは？

CLAUDE.mdに置くべきコンテキストを、プロンプトでClaudeに渡しすぎてしまうことです。新規ユーザーは、コーディング規約全体をプロンプトごとに貼り付けがちですが、これはコンテキストウィンドウを浪費し、セッション間で一貫性のない結果を生みます。繰り返しの指示はCLAUDE.mdに一度書き、プロンプトはセッション固有のリクエストに使いましょう。2番目によくあるミスは、特定のコマンドではなくBash(*)を許可リストに入れることです。ワイルドカードのBash許可リストでは、Claudeが確認なしに任意のシェルコマンドを実行できてしまい、権限システムの目的を損なってしまいます。

  1. Anthropic, “ServiceNow Customer Story.” anthropic.com/customers/servicenow ↩

  2. Anthropic, “Allianz Customer Story.” anthropic.com/customers/allianz ↩

  3. Anthropic, “Claude Code Overview.” docs.anthropic.com/en/docs/claude-code/overview. Source: github.com/anthropics/claude-code ↩

  4. Anthropic, “Claude Code Permissions.” docs.anthropic.com/en/docs/claude-code/security ↩↩

  5. Anthropic, “Claude Code Hooks.” docs.anthropic.com/en/docs/claude-code/hooks ↩↩↩

  6. Anthropic, “Pricing.” platform.claude.com/docs/en/about-claude/pricing ↩↩↩

  7. npm Documentation, “Resolving EACCES permissions errors when installing packages globally.” docs.npmjs.com/resolving-eacces-permissions-errors ↩

  8. Anthropic, “Effective usage of Claude Code.” docs.anthropic.com/en/docs/claude-code/best-practices ↩

  9. Linux Foundation Agentic AI Foundation, “AGENTS.md Specification.” github.com/anthropics/agent-instructions ↩

関連記事

Claude Code Hooks Tutorial: 5 Production Hooks From Scratch

Build 5 production Claude Code hooks from scratch with full JSON configs: auto-formatting, security gates, test runners,…

13 分で読める

Codex CLI vs Claude Code 2026: Architecture, Pricing, and China Access

Deep comparison of Codex CLI and Claude Code: kernel sandboxing vs 26-hook governance, Opus 4.7 vs GPT-5.4 benchmarks, p…

29 分で読める

Claude Code Skills: Build Custom Auto-Activating Extensions

Build custom Claude Code skills that auto-activate based on context. Step-by-step tutorial covering SKILL.md structure, …

13 分で読める