Claude Code：AnthropicのAIコーディングCLI完全ガイド（2026年版）

Claude Code: Anthropic公式 AI コーディング CLI 完全ガイド (2026年版)

Claude Code は、Anthropicが提供する AI 支援ソフトウェア開発用の公式コマンドラインインターフェース（CLI）です。ブラウザベースの AI チャットツールとは異なり、Claude Code はターミナル上で直接動作し、ファイルの読み書き、コマンドの実行、そしてコードベース全体のコンテキストを完全に把握した上でのナビゲーションを可能にします。

このガイドでは、インストールから高度なワークフローまで、2026年において Claude Code を最大限に活用するための決定的なリソースとして必要なすべてを網羅します。

Claude Code とは？

Claude Code は、Claude に開発環境への直接的なアクセス権を与える CLI ツールです。プロジェクトディレクトリで実行すると、以下のことが可能になります。

コードベース全体の読み取りと理解
複数ディレクトリにまたがるファイルの編集
シェルコマンドの実行（ビルド、テスト、git 操作）
コード検索とファイル構造の移動
コミットやプルリクエストの作成
ログやスタックトレースを読み取ることによるエラーのデバッグ

GitHub Copilot や Cursor といった AI コーディングツールとの違いは、ターミナル上でエージェントとして完全に動作し、単なるインラインの提案ではなく、タスク完了のために多段階のステップを実行する点にあります。

インストールとセットアップ

要件

要件	最小スペック
Node.js	18+
OS	macOS, Linux, または Windows (via WSL)
Anthropic API キー	または Claude Pro/Max サブスクリプション

インストール

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

インストールの確認

claude --version

認証

初回起動時に、Claude Code は認証を求めます。2つのオプションがあります。

オプション 1: Anthropic API キー

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
claude

オプション 2: Claude Pro/Max サブスクリプション

Claude Code を起動し、ブラウザベースの OAuth フローに従います。

claude
# 認証プロンプトに従ってください

Claude Pro サブスクリプションユーザーは、制限付きで Claude Code を利用できます。Claude Max（月額100ドルまたは200ドル）のサブスクリプションユーザーは、大幅に高い上限設定が適用されます。

サブスクリプション比較

プラン	Claude Code アクセス	月間制限
Free	なし	N/A
Pro ($20/month)	制限あり	低い使用上限
Max ($100/month)	あり	高い使用上限
Max ($200/month)	あり	非常に高い使用上限
API (従量課金)	あり	利用金額に基づく
Team/Enterprise	あり	プランに基づく

基本的な使い方

インタラクティブモード

プロジェクトディレクトリで Claude Code を起動します。

cd your-project
claude

インタラクティブセッションが開始され、自然言語で指示を入力できます。Claude Code はプロジェクト構造を読み取り、コードベースを理解した上で回答します。

ワンショットモード

インタラクティブモードに入らずに単一のプロンプトを送信します。

claude "explain what this project does"

プリントモード

インタラクティブセッションやツールの使用を行わずに回答を取得します。

claude -p "what does the main function in src/index.ts do?"

パイプ入力

stdin 経由でコンテンツを Claude Code に渡します。

cat error.log | claude "explain this error and suggest a fix"
git diff | claude "review these changes"
npm test 2>&1 | claude "fix the failing tests"

会話の再開

# 最新の会話を再開する
claude --resume

# 前回の会話を継続する
claude --continue

主要な CLI フラグ

フラグ	短縮形	説明
`--version`	`-v`	バージョンを表示
`--help`	`-h`	ヘルプを表示
`--resume`	`-r`	最新の会話を再開
`--continue`	`-c`	前回の会話を継続
`--print`	`-p`	プリントモード（インタラクティブセッションなし）
`--model`	`-m`	モデルを指定 (例: `claude-sonnet-4-20250514`)
`--max-turns`		エージェントの実行ターン数を制限
`--system-prompt`		カスタムシステムプロンプト
`--allowedTools`		使用可能なツールを制限
`--output-format`		出力フォーマット: `text`, `json`, `stream-json`
`--dangerously-skip-permissions`		すべてのツール実行を自動承認

スラッシュコマンド

インタラクティブセッション内では、クイックアクション用にスラッシュコマンドを使用できます。

コマンド	説明
`/help`	利用可能なコマンドを表示
`/compact`	コンテキストを節約するために会話を圧縮
`/clear`	会話履歴をクリア
`/cost`	トークン使用量と推定コストを表示
`/model`	会話の途中でモデルを切り替え
`/permissions`	ツールの権限を表示・管理
`/config`	現在の設定を表示
`/bug`	Anthropic にバグを報告
`/quit`	Claude Code を終了

設定

プロジェクトレベルの設定

プロジェクトのルートに CLAUDE.md ファイルを作成し、Claude Code に永続的なコンテキストを提供します。

# CLAUDE.md

## Project Overview
This is a Next.js 15 application using the App Router, TypeScript, and Tailwind CSS.

## Tech Stack
- Next.js 15 (App Router)
- TypeScript (strict mode)
- Tailwind CSS + shadcn/ui
- Prisma ORM with PostgreSQL
- NextAuth.js for authentication

## Conventions
- デフォルトでサーバーコンポーネントを使用すること
- API ルートは app/api/ に配置すること
- すべての入力バリデーションには Zod を使用すること
- テストは Vitest で記述すること

## Important Notes
- マイグレーションを作成せずにデータベーススキーマを変更しないこと
- コミット前に必ず `npm run typecheck` を実行すること
- 環境変数は .env.local にある（このファイルを読み取ったり変更したりしないこと）

Claude Code は、すべての会話の開始時にこのファイルを自動的に読み取ります。

設定ファイル

ツールの権限や挙動を設定するには .claude/settings.json を作成します。

{
  "allowedTools": [
    "Read",
    "Write",
    "Glob",
    "Grep",
    "Bash(npm run *)",
    "Bash(npx *)",
    "Bash(git *)"
  ],
  "ignorePatterns": [
    "node_modules",
    "dist",
    ".next"
  ]
}

ユーザーレベルの設定

すべてのプロジェクトに適用される設定については、~/.claude/settings.json または ~/.claude.md を作成してください。

一般的なワークフロー

1. 機能の実装

Add a rate limiting middleware to the API. Use Redis for the token bucket.
It should limit to 100 requests per minute per API key.
Add tests.

Claude Code は既存のミドルウェアを読み取り、プロジェクト構造を理解し、実装を作成してテストを記述します。

2. バグ修正

# エラーを直接パイプする
npm test 2>&1 | claude "fix these failing tests"

または、バグの内容を説明します。

Users are reporting that the password reset email is not being sent.
Debug the issue and fix it.

3. コードレビュー

git diff main...feature-branch | claude "review this code for bugs, security issues, and style problems"

4. リファクタリング

Refactor the user service to use the repository pattern.
Move database queries out of the route handlers and into a UserRepository class.
Update all imports and tests.

5. ドキュメント作成

Add JSDoc comments to all exported functions in the src/utils/ directory.

6. Git 操作

Create a new branch called feature/rate-limiting, commit the current changes
with a descriptive message, and push to origin.

7. ログによるデバッグ

cat server.log | claude "find the root cause of the 500 errors happening after 3pm"

高度な使い方

カスタムシステムプロンプト

特定のタスクのためにデフォルトの挙動をオーバーライドします。

claude --system-prompt "You are a security auditor. Review all code for vulnerabilities." \
  "audit the authentication module"

スクリプティングと自動化

CI/CD パイプラインやスクリプトで Claude Code を使用します。

# 最近のコミットからチェンジログを生成する
git log --oneline v1.0..HEAD | claude -p --output-format json \
  "Generate a changelog grouped by category (features, fixes, other)"

# lint エラーを自動修正する
npx eslint src/ --format json 2>&1 | claude "fix all these lint errors"

マルチモデルワークフロー

タスクに応じてモデルを切り替えます。

# 単純なタスクには高速なモデルを使用
claude -m claude-haiku-4-20250514 "rename the variable 'x' to 'userCount' in src/stats.ts"

# 複雑なタスクには最も有能なモデルを使用
claude -m claude-opus-4-20250514 "redesign the database schema to support multi-tenancy"

ツールのアクセス制限

機密性の高い操作については、Claude Code が実行できる内容を制限します。

# 読み取り専用モード
claude --allowedTools "Read,Glob,Grep" "explain the authentication flow"

# bash アクセスなし
claude --allowedTools "Read,Write,Glob,Grep" "refactor the utils"

より良い結果を得るためのヒント

ヒント	例
ファイルを具体的に指定する	「ログインを修正して」ではなく「`src/auth/login.ts` を編集して」
試したことを伝える	「X を試したがエラー Y が出た」
大きなタスクはステップに分ける	1つの会話につき1つの機能
長いセッションでは `/compact` を使う	コンテキストウィンドウの問題を防ぐ
エラーメッセージを含める	スタックトレースをすべて貼り付ける
「理由」を明示する	単に「キャッシュを追加して」ではなく「API 呼び出しを減らすためにキャッシュを追加して」
プロジェクトコンテキストに `CLAUDE.md` を活用	毎回セットアップの説明を繰り返す手間を省く

コスト管理

使用状況の監視

/cost

現在のセッションで使用されたトークン量と推定コストが表示されます。

コストを抑える方法

こまめに /compact を使用し、長い会話を圧縮する。
プリントモード (-p) を使用し、ツールの使用を必要としない迅速な質問に答える。
ツールを制限し、編集ではなくコードの読み取りのみが必要な場合に対応する。
Haiku モデルを使用し、名前変更やフォーマットなどの単純なタスクを処理する。
タスクを絞ったセッションに分割し、1つの長い会話を避ける。

トラブルシューティング

問題	解決策
"API key not found"	`ANTHROPIC_API_KEY` 環境変数を設定してください
回答が遅い	ネットワーク接続を確認してください。または `/compact` を試してください
コンテキストウィンドウエラー	新しい会話を開始してください
権限拒否 (Permission denied)	`.claude/settings.json` の `allowedTools` を確認してください
Claude Code がループに陥った	Escape キーを押し、より明確な指示を与えてください
"Rate limit exceeded"	数分待つか、プランをアップグレードしてください
特定のファイルが読み込めない	`.gitignore` および `ignorePatterns` を確認してください

おわりに

Claude Code は、ターミナルで利用可能な中で最も有能な AI コーディングアシスタントです。明確な指示を与え、CLAUDE.md を通じてプロジェクトのコンテキストを維持し、複雑なタスクを焦点の絞ったセッションに分割することで、最高のパフォーマンスを発揮します。新機能の構築、本番環境のバグ修正、レガシーコードのリファクタリングなど、Claude Code は開発者が主導権を握ったまま、面倒な作業を肩代わりしてくれます。

画像、動画、音声などの AI 生成メディアを含むアプリケーションを構築している場合は、Hypereal AI が Claude Code のようなツールとシームレスに連携する開発者フレンドリーな API を提供しています。シンプルな API 呼び出しを通じて、画像の生成や動画の作成などを行うことが可能です。

Claude Code: Anthropic公式 AI コーディング CLI 完全ガイド (2026年版)

Claude Code とは？

コードベース全体の読み取りと理解
複数ディレクトリにまたがるファイルの編集
シェルコマンドの実行（ビルド、テスト、git 操作）
コード検索とファイル構造の移動
コミットやプルリクエストの作成
ログやスタックトレースを読み取ることによるエラーのデバッグ

インストールとセットアップ

要件

要件	最小スペック
Node.js	18+
OS	macOS, Linux, または Windows (via WSL)
Anthropic API キー	または Claude Pro/Max サブスクリプション

インストール

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

インストールの確認

claude --version

認証

初回起動時に、Claude Code は認証を求めます。2つのオプションがあります。

オプション 1: Anthropic API キー

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
claude

オプション 2: Claude Pro/Max サブスクリプション

Claude Code を起動し、ブラウザベースの OAuth フローに従います。

claude
# 認証プロンプトに従ってください

サブスクリプション比較

プラン	Claude Code アクセス	月間制限
Free	なし	N/A
Pro ($20/month)	制限あり	低い使用上限
Max ($100/month)	あり	高い使用上限
Max ($200/month)	あり	非常に高い使用上限
API (従量課金)	あり	利用金額に基づく
Team/Enterprise	あり	プランに基づく

基本的な使い方

インタラクティブモード

プロジェクトディレクトリで Claude Code を起動します。

cd your-project
claude

ワンショットモード

インタラクティブモードに入らずに単一のプロンプトを送信します。

claude "explain what this project does"

プリントモード

インタラクティブセッションやツールの使用を行わずに回答を取得します。

claude -p "what does the main function in src/index.ts do?"

パイプ入力

stdin 経由でコンテンツを Claude Code に渡します。

cat error.log | claude "explain this error and suggest a fix"
git diff | claude "review these changes"
npm test 2>&1 | claude "fix the failing tests"

会話の再開

# 最新の会話を再開する
claude --resume

# 前回の会話を継続する
claude --continue

主要な CLI フラグ

フラグ	短縮形	説明
`--version`	`-v`	バージョンを表示
`--help`	`-h`	ヘルプを表示
`--resume`	`-r`	最新の会話を再開
`--continue`	`-c`	前回の会話を継続
`--print`	`-p`	プリントモード（インタラクティブセッションなし）
`--model`	`-m`	モデルを指定 (例: `claude-sonnet-4-20250514`)
`--max-turns`		エージェントの実行ターン数を制限
`--system-prompt`		カスタムシステムプロンプト
`--allowedTools`		使用可能なツールを制限
`--output-format`		出力フォーマット: `text`, `json`, `stream-json`
`--dangerously-skip-permissions`		すべてのツール実行を自動承認

スラッシュコマンド

インタラクティブセッション内では、クイックアクション用にスラッシュコマンドを使用できます。

コマンド	説明
`/help`	利用可能なコマンドを表示
`/compact`	コンテキストを節約するために会話を圧縮
`/clear`	会話履歴をクリア
`/cost`	トークン使用量と推定コストを表示
`/model`	会話の途中でモデルを切り替え
`/permissions`	ツールの権限を表示・管理
`/config`	現在の設定を表示
`/bug`	Anthropic にバグを報告
`/quit`	Claude Code を終了

設定

プロジェクトレベルの設定

プロジェクトのルートに CLAUDE.md ファイルを作成し、Claude Code に永続的なコンテキストを提供します。

# CLAUDE.md

## Project Overview
This is a Next.js 15 application using the App Router, TypeScript, and Tailwind CSS.

## Tech Stack
- Next.js 15 (App Router)
- TypeScript (strict mode)
- Tailwind CSS + shadcn/ui
- Prisma ORM with PostgreSQL
- NextAuth.js for authentication

## Conventions
- デフォルトでサーバーコンポーネントを使用すること
- API ルートは app/api/ に配置すること
- すべての入力バリデーションには Zod を使用すること
- テストは Vitest で記述すること

## Important Notes
- マイグレーションを作成せずにデータベーススキーマを変更しないこと
- コミット前に必ず `npm run typecheck` を実行すること
- 環境変数は .env.local にある（このファイルを読み取ったり変更したりしないこと）

Claude Code は、すべての会話の開始時にこのファイルを自動的に読み取ります。

設定ファイル

ツールの権限や挙動を設定するには .claude/settings.json を作成します。

{
  "allowedTools": [
    "Read",
    "Write",
    "Glob",
    "Grep",
    "Bash(npm run *)",
    "Bash(npx *)",
    "Bash(git *)"
  ],
  "ignorePatterns": [
    "node_modules",
    "dist",
    ".next"
  ]
}

ユーザーレベルの設定

すべてのプロジェクトに適用される設定については、~/.claude/settings.json または ~/.claude.md を作成してください。

一般的なワークフロー

1. 機能の実装

Add a rate limiting middleware to the API. Use Redis for the token bucket.
It should limit to 100 requests per minute per API key.
Add tests.

Claude Code は既存のミドルウェアを読み取り、プロジェクト構造を理解し、実装を作成してテストを記述します。

2. バグ修正

# エラーを直接パイプする
npm test 2>&1 | claude "fix these failing tests"

または、バグの内容を説明します。

Users are reporting that the password reset email is not being sent.
Debug the issue and fix it.

3. コードレビュー

git diff main...feature-branch | claude "review this code for bugs, security issues, and style problems"

4. リファクタリング

Refactor the user service to use the repository pattern.
Move database queries out of the route handlers and into a UserRepository class.
Update all imports and tests.

5. ドキュメント作成

Add JSDoc comments to all exported functions in the src/utils/ directory.

6. Git 操作

Create a new branch called feature/rate-limiting, commit the current changes
with a descriptive message, and push to origin.

7. ログによるデバッグ

cat server.log | claude "find the root cause of the 500 errors happening after 3pm"

高度な使い方

カスタムシステムプロンプト

特定のタスクのためにデフォルトの挙動をオーバーライドします。

claude --system-prompt "You are a security auditor. Review all code for vulnerabilities." \
  "audit the authentication module"

スクリプティングと自動化

CI/CD パイプラインやスクリプトで Claude Code を使用します。

# 最近のコミットからチェンジログを生成する
git log --oneline v1.0..HEAD | claude -p --output-format json \
  "Generate a changelog grouped by category (features, fixes, other)"

# lint エラーを自動修正する
npx eslint src/ --format json 2>&1 | claude "fix all these lint errors"

マルチモデルワークフロー

タスクに応じてモデルを切り替えます。

# 単純なタスクには高速なモデルを使用
claude -m claude-haiku-4-20250514 "rename the variable 'x' to 'userCount' in src/stats.ts"

# 複雑なタスクには最も有能なモデルを使用
claude -m claude-opus-4-20250514 "redesign the database schema to support multi-tenancy"

ツールのアクセス制限

機密性の高い操作については、Claude Code が実行できる内容を制限します。

# 読み取り専用モード
claude --allowedTools "Read,Glob,Grep" "explain the authentication flow"

# bash アクセスなし
claude --allowedTools "Read,Write,Glob,Grep" "refactor the utils"

より良い結果を得るためのヒント

ヒント	例
ファイルを具体的に指定する	「ログインを修正して」ではなく「`src/auth/login.ts` を編集して」
試したことを伝える	「X を試したがエラー Y が出た」
大きなタスクはステップに分ける	1つの会話につき1つの機能
長いセッションでは `/compact` を使う	コンテキストウィンドウの問題を防ぐ
エラーメッセージを含める	スタックトレースをすべて貼り付ける
「理由」を明示する	単に「キャッシュを追加して」ではなく「API 呼び出しを減らすためにキャッシュを追加して」
プロジェクトコンテキストに `CLAUDE.md` を活用	毎回セットアップの説明を繰り返す手間を省く

コスト管理

使用状況の監視

/cost

現在のセッションで使用されたトークン量と推定コストが表示されます。

コストを抑える方法

こまめに /compact を使用し、長い会話を圧縮する。
プリントモード (-p) を使用し、ツールの使用を必要としない迅速な質問に答える。
ツールを制限し、編集ではなくコードの読み取りのみが必要な場合に対応する。
Haiku モデルを使用し、名前変更やフォーマットなどの単純なタスクを処理する。
タスクを絞ったセッションに分割し、1つの長い会話を避ける。

トラブルシューティング

問題	解決策
"API key not found"	`ANTHROPIC_API_KEY` 環境変数を設定してください
回答が遅い	ネットワーク接続を確認してください。または `/compact` を試してください
コンテキストウィンドウエラー	新しい会話を開始してください
権限拒否 (Permission denied)	`.claude/settings.json` の `allowedTools` を確認してください
Claude Code がループに陥った	Escape キーを押し、より明確な指示を与えてください
"Rate limit exceeded"	数分待つか、プランをアップグレードしてください
特定のファイルが読み込めない	`.gitignore` および `ignorePatterns` を確認してください

Hyperealで構築を始めよう

Claude Code: Anthropic公式 AI コーディング CLI 完全ガイド (2026年版)

Claude Code とは？

インストールとセットアップ

要件

インストール

インストールの確認

認証

サブスクリプション比較

基本的な使い方

インタラクティブモード

ワンショットモード

プリントモード

パイプ入力

会話の再開

主要な CLI フラグ

スラッシュコマンド

設定

プロジェクトレベルの設定

設定ファイル

ユーザーレベルの設定

一般的なワークフロー

1. 機能の実装

2. バグ修正

3. コードレビュー

4. リファクタリング

5. ドキュメント作成

6. Git 操作

7. ログによるデバッグ

高度な使い方

カスタムシステムプロンプト

スクリプティングと自動化

マルチモデルワークフロー

ツールのアクセス制限

より良い結果を得るためのヒント

コスト管理

使用状況の監視

コストを抑える方法

トラブルシューティング

おわりに

関連記事

Claude Code 入門ガイド & ベストプラクティス (2026)

Claude Code CLIコマンド：完全チートシート (2026年版)

Claude Code Cowork モードの使い方 (2026年版)

今日から構築を開始

Hyperealで構築を始めよう

Claude Code: Anthropic公式 AI コーディング CLI 完全ガイド (2026年版)

Claude Code とは？

インストールとセットアップ

要件

インストール

インストールの確認

認証

サブスクリプション比較

基本的な使い方

インタラクティブモード

ワンショットモード

プリントモード

パイプ入力

会話の再開

主要な CLI フラグ

スラッシュコマンド

設定

プロジェクトレベルの設定

設定ファイル

ユーザーレベルの設定

一般的なワークフロー

1. 機能の実装

2. バグ修正

3. コードレビュー

4. リファクタリング

5. ドキュメント作成

6. Git 操作

7. ログによるデバッグ

高度な使い方

カスタムシステムプロンプト

スクリプティングと自動化

マルチモデルワークフロー

ツールのアクセス制限

より良い結果を得るためのヒント