← すべての記事

Claude CodeのCLI方法:5分クイックスタート

From the guide: Claude Code Comprehensive Guide

ServiceNowでは29,000人以上の開発者がClaude Codeを毎日使用しており、Allianzは2026年初頭に全社展開を行いました。このツールの普及曲線にはあるパターンがあります。開発者が自分のターミナルでエージェントコーディングを一度体験すると、チャットウィンドウからのコピー&ペーストには戻れなくなるのです。このクイックスタートでは、ゼロから動作するClaude Codeセッションまで約5分で到達でき、その後も使い続けられる実用的な設定を行います。

要約: npm install -g @anthropic-ai/claude-codeでClaude Codeをインストールし、ブラウザで認証を行い、プロジェクトのコンテキストを記載したCLAUDE.mdファイルを作成し、.claude/settings.jsonでパーミッションを設定します。さらにPrettierフックを追加して、編集のたびにファイルを自動フォーマットします。セットアップ全体は5分以内に完了し、設定はセッション間で永続化されます。

重要ポイント

  • 個人開発者: CLAUDE.mdとフォーマットフックで必要なことの80%はカバーできます。デフォルトのパーミッションから始めて、信頼性を確認しながらツールを事前承認していきましょう。
  • チームリーダー: .claude/settings.jsonをリポジトリにコミットすれば、チーム全体で同じパーミッション許可リストとフックを共有できます。
  • セキュリティエンジニア: 3段階のパーミッションモデル(デフォルト、事前承認、スキップ)は信頼レベルに直接対応します。デフォルトモードでは、すべての書き込みとすべてのコマンドに明示的な承認が必要です。

前提条件

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

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

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サブスクリプションプランに対して課金されます。認証ステップで使用するため、キーを手元に保管しておいてください。

ターミナル。 Claude Codeはどのターミナルエミュレータでも動作します:Terminal.app、iTerm2、Windows Terminal、Alacritty、またはVS Codeの統合ターミナルなど。Claude Codeはファイルのdiffやツール出力を表示するため、横幅に余裕があると見やすくなります。最低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に追加してください。

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

最初のセッション

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

cd ~/Projects/my-app
claude

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

  1. ディレクトリ構造をスキャンしてプロジェクトのレイアウトを把握します
  2. 設定ファイルを読み取りpackage.jsonpyproject.tomlCargo.tomlなど)、技術スタックを特定します
  3. プロジェクトルートのCLAUDE.mdファイルを探し、プロジェクト固有の指示を読み込みます

すべてが正常に動作することを確認するため、簡単なプロンプトを試してみてください:

> Explain the structure of this project

Claudeがファイルを読み取り、アーキテクチャを分析して、ターミナルに応答します。ツールコール(各ファイルの読み取り、各コマンドの実行)がリアルタイムで表示され、書き込み操作の前にはパーミッションの確認が求められます。

CLAUDE.mdのセットアップ

CLAUDE.mdはClaude Codeを効果的に使用するための最も重要なファイルです。プロジェクトルートに配置し、Claudeがセッション開始時に読み込む指示を記載します。AIコラボレーターのためのREADMEと考えてください。

ファイルを作成します:

touch CLAUDE.md

実用的なテンプレートの例を示します:

# My App

## Project Context
Express.js API with React frontend. PostgreSQL database.

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

## Code Standards
- Use async/await, never raw Promises
- 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がプロジェクトでESMを使用しているのにCommonJSを使い続ける場合は、CLAUDE.mdに記載してください。特定のテストコマンドやデータベースのセットアップ手順がある場合は、それを文書化してください。Claudeは毎セッションCLAUDE.mdを読み込むため、記載した内容はすべて永続的な指示になります。

ホームディレクトリ(~/.claude/CLAUDE.md)にCLAUDE.mdを配置すれば、すべてのプロジェクトに適用されるグローバルな指示を設定することもできます。また、サブディレクトリに配置すれば、モノレポの特定の部分にのみ適用されるコンテキストを設定できます。

パーミッションの基本

Claude Codeは、エージェントに与える自律性の度合いを決める3段階のパーミッション階層で動作します:

デフォルトモードでは、ファイルの書き込み、コマンドの実行、破壊的なアクションの前に毎回パーミッションを確認します。Claudeが意図する操作を正確に確認し、各ステップを承認または拒否できます。まずはこのモードから始めることをお勧めします。

事前承認パーミッションでは、特定のツールやパターンを許可リストに登録して、Claudeが毎回確認しないようにできます。プロジェクトの.claude/settings.jsonで設定します:

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm test)",
      "Bash(npx prisma migrate dev)"
    ]
  }
}

この例では、Claudeがファイルの読み取り、コードベースの検索、テストおよびマイグレーションコマンドの実行を確認なしで行えるようにしています。ファイルの書き込みやその他のbashコマンドの実行には、引き続き確認が求められます。

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

パーミッションシステムこそが、Claude Codeを実際のプロジェクトで安全に使用できる理由です。デフォルトモードから始めて、どの承認が繰り返し発生するかを観察し、それらの特定の操作だけを選択的に事前承認してください。

最初のフック

フックは、Claude Codeのライフサイクルの特定のタイミングで実行されるシェルコマンドです。LLMの確率的な動作の上に、決定論的な保証を提供します。実用的な最初のフックとして、Claudeがファイルを編集した後に自動フォーマットするフックを設定しましょう。

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

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

このフックは、EditまたはWriteツールコールのたびに起動します。Claude Codeは$FILE_PATHに変更されたファイルを設定します。Prettierがファイルをその場でフォーマットし、|| trueによってPrettierがインストールされていない場合やファイルタイプがサポートされていない場合でもClaudeがブロックされないようにしています。

その他のお勧めのスターターフック:

  • Bashに対するPreToolUserm -rf /git push --forceのような危険なコマンドをブロックします
  • SessionStart:現在の日付、アクティブなgitブランチ、環境変数をコンテキストに注入します(SessionStartフックのstdoutはClaudeのコンテキストに取り込まれます)
  • Stop:Claudeがタスクを完了したときに自動的にテストスイートを実行します

フックはClaude Codeを会話型ツールから統制された開発環境へと変化させます。適切に選ばれた1つか2つのフックだけでも、ミスのカテゴリ全体を排除できます。

次のステップ

このクイックスタートでは、インストール、最初のセッション、プロジェクト設定、パーミッション、スターターフックという要点をカバーしました。5つのコアシステム(CLAUDE.md階層、完全なパーミッションモデル、フックアーキテクチャ、カスタムスラッシュコマンド、マルチエージェントワークフロー)を網羅した完全なリファレンスについては、Claude Code完全ガイドをご覧ください。

このガイドでは、コンテキストウィンドウの管理、サブエージェントへの委譲、スキルの自動アクティベーション、そして数ヶ月間の日常的なClaude Code使用から生まれるパターンについて解説しています。このクイックスタートが役に立ったなら、完全ガイドが自然な次のステップです。

FAQ

Claude Codeの費用はどれくらいですか?

Claude Codeは2つの課金モデルに対応しています。API従量課金モデルでは、Anthropicの標準APIレートでトークン単位で課金されます。一般的な30〜60分のセッションでは、コードベースの規模と生成量に応じて$0.50〜$3.00程度です。あるいは、AnthropicのMaxプラン(個人$100/月、チーム$200/月)には、より高いレート制限付きでClaude Codeの使用が含まれます。APIの使用量はconsole.anthropic.comで確認できます。

Claude CodeはVS Codeで使えますか?

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

Claude Codeを本番コードベースで使用しても安全ですか?

Claude Codeのデフォルトパーミッションモードでは、ファイルの書き込みとコマンドの実行のたびに明示的な承認を求めます。確認なしにディスク上の内容が変更されることはありません。パーミッションシステムに加えて、フォースプッシュや破壊的なシェルコマンドなどの危険な操作をブロックできるフックを組み合わせることで、本番環境での使用が実用的になります。私は実際のユーザーにサービスを提供しているプロジェクトでClaude Codeを毎日使用しています。重要なのは、デフォルトモードから始めて、承認する前に各ツールコールが何をするかを理解し、信頼できる操作だけを段階的に事前承認することです。バージョン管理が最後のセーフティネットです。重要なClaude Codeセッションを開始する前にコミットしておけば、いつでも元に戻せます。

関連記事

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,…

12 分で読める

Codex CLI vs Claude Code in 2026: Architecture Deep Dive

Kernel-level sandboxing vs application-layer hooks, AGENTS.md vs CLAUDE.md, cloud tasks vs subagents. A technical compar…

13 分で読める

Building Custom Skills for Claude Code: A Complete Tutorial

Build a code review skill from scratch. Covers directory structure, frontmatter fields, LLM-based matching, context budg…

10 分で読める