Claude コード チートシート：開発者向け完全初心者ガイド

Anthropic社の強力なAI搭載コーディングアシスタントであるClaude Codeを使いこなすには、明確なリファレンスが不可欠です。このClaude Codeチートシートは、セットアップ、ワークフロー、設定、高度なヒントを網羅した、実用的で初心者向けのガイドを求める開発者を対象としています。読み終える頃には、ローカル環境やCI/CDプロセスの一部としてClaude Codeをより自信を持って使えるようになるでしょう。

Claude Codeとは？

Claude CodeはAnthropicが開発したCLIベースのAIコーディングツールです。開発者はClaudeの高度なモデルを使用して、コードの生成、リファクタリング、テスト、ドキュメント化を行うことができます。単なるチャットインターフェースではなく、Claude CodeはAI IDEのように振る舞います。リポジトリ構造を理解し、設定ファイルで定義されたガードレールを適用し、bashコマンドを実行でき、Gitワークフローと統合します。

Claude Codeをインストールする:

# MacOS/Linux:
curl -fsSL https://claude.ai/install.sh | bash

# Windows:
irm https://claude.ai/install.ps1 | iex

# NPM:
npm install -g @anthropic-ai/claude-code

# Homebrew:
brew install --cask claude-code

Claude Codeを使い始める:

cd your-project
claude

Claude Codeの主要コンポーネント — チートシート

Claude Codeを使い始める際に知っておきたい、不可欠な構成要素と機能は以下の通りです。

1. CLAUDE.md — エージェントマニフェスト

• `CLAUDE.md`ファイルはエージェントの「憲法」であり、リポジトリ内でのClaudeの動作を定義します。
• 承認されたツール、一般的なワークフロー、制約を文書化するために使用します。
• ベストプラクティス：短く保ち、主要なガードレールに焦点を当て、非常に大きなドキュメントの埋め込みは避けてください。

# MyProject CLAUDE.md

## Project Overview  
This is a Node.js + Express REST API for a task management application.  

## Technology Stack  
- Backend: Node.js (ES6), Express  
- Database: PostgreSQL  
- Testing: Jest  
- Linting & Style: ESLint, Prettier

## Development Commands  
- `npm install` — Install dependencies  
- `npm run dev` — Start development server  
- `npm run test` — Run all tests  
- `npm run lint` — Run linter  

## Coding Standards  
- Use 2-space indentation.  
- Always use `async / await` instead of `.then()` chains.  
- Functions must have JSDoc comments.  
- Prefer composition over inheritance.

## Git Workflow  
- Feature branches must follow this pattern: `feature/FOO`  
- Use `git rebase` instead of `merge` for updating branches.  
- When committing: write descriptive commit messages that follow the Conventional Commits format.

## File Structure Guidance  
- `src/` — Your main application code  
- `tests/` — Test files  
- `scripts/` — Utility or setup scripts  
- `migrations/` — Database migrations  

## Known Issues / Workarounds  
- `db.connect()` sometimes times out; in that case, retry twice.  
- For large JSON payloads, use streaming to avoid memory issues.

## Memory / Style Preferences  
- Always ask for clarification if the request is ambiguous.  
- Do not generate new `.md` files unless explicitly instructed.  
- Include a `co-authored-by Claude` line in generated commits.

2. コンテキスト管理

a. **`/context`**を使用して、現在のClaudeセッションのトークン使用量を検査します。

b. コンテキストを再起動または縮小するためのコマンド:

• `/clear` + `/catchup`：すべての会話をクリアし、コミットまたはブランチからファイルを再読み込みします。
• 「ドキュメント化＆クリア」フロー：Claudeに計画をMarkdownファイルにダンプさせ、メモリをクリアした後、そのファイルから再読み込みします。

3. スラッシュコマンド

• スラッシュコマンドは、事前に定義されたプロンプトへのショートカットです。
• 例:

• スラッシュコマンドは最小限に抑え、目的に集中させます。すべてのタスクに頼らないようにしてください。

4. 計画モード

• 複雑なタスクを開始する際は、計画モードを使用してください。Claudeはコードを書く前に計画の概要を説明します。
• その後、Claudeに実行を依頼する前に、その計画を確認、編集、または承認できます。
• 大規模な機能開発、リファクタリング、またはアーキテクチャの変更に最適です。

5. サブエージェントとタスク委任

• Claude Codeは**サブエージェント**をサポートしており、メインエージェントの「クローン」に作業の一部を委任できます。
• Shrivuは「マスター-クローン」アーキテクチャを推奨しています。これは、厳密な専門サブエージェントを使用するのではなく、メインエージェントが`Task(...)`を介してクローンを生成する方法です。
• これにより、コンテキストの断片化を避けつつ、柔軟性を保ちます。
• スラッシュコマンド`/agents`を使用してClaude Codeのサブエージェントにアクセスします。

6. Claude SkillsとMCP — その違いとは？

a. **Claude Skills**は、Claudeに特定のタスクを*どのように*実行するかを教える、事前に構築された「モジュール」です。これらはMarkdownまたはコードで書かれており、必要なときにのみロードされます。Skillsを使用して、レポートのフォーマット、データの要約、チームのスタイルの強制などのワークフローを定義できます。

b. 一方、**モデルコンテキストプロトコル（MCP）**は、データベース、コードベース、ビジネスシステムなどの外部データやツールにClaudeを接続するためのプロトコルです。これは、カスタムのツールごとの統合なしに、Claudeが外部リソースにアクセスしてアクションを実行できるようにする「ユニバーサルアダプター」のようなものです。

c. 主な違い:

1. 目的:

• Skillsは*手続き的知識*をエンコードします。
• MCPは*ツールとデータの接続*を扱います。

2. トークンの効率:

• Skillsは必要なときにのみロードされ、比較的少ないトークンを使用します。
• MCPのツール定義は、多くが有効になっている場合、かなりのトークン空間を占める可能性があります。

d. ユースケース:

• **Skills**を使用して、Claudeにドメイン固有のワークフローを教えます（例：「進捗レポートを作成する際は、必ずX、Y、Zを含める」）。
• Claudeが*データを読み書き*したり、APIを呼び出したり、Gitやデータベースなどの外部システムにアクセスする必要がある場合は、**MCP**を使用します。

実際には、この2つは連携して最も効果を発揮します。**MCP**はClaudeにデータへのアクセスを提供し、**Skills**はClaudeにそのデータを構造化された再現可能な方法で使用する方法を教えます。

6. フック

a. フックは、ルールを自動的に強制するための方法です。

b. 2つの一般的なタイプ:

• 送信時にブロック: 例えば、`PreToolUse`フックは、テストが合格しない限り`git commit`をブロックできます。
• ヒントフック: 非ブロック型で、実行を停止せずにガイダンスや提案を提供します。

c. 「書き込み時にブロック」フックは避けてください — Claudeに計画を完了させてから検証する方が安定しています。

# Example Hook in .claude/settings.toml

[[hooks]]
# The event that triggers the hook.
event = "PostToolUse" 

# (Optional) Conditions for the hook to run.
[hooks.matcher]
tool_name = "edit_file"
file_paths = ["*.py", "api/**/*.py"]

# The shell command to execute.
command = "ruff check --fix $CLAUDE_FILE_PATHS && black $CLAUDE_FILE_PATHS"

# (Optional) Whether to run the command in the background.
run_in_background = false 

7. CLI SDK

• **Claude Code SDK**を使用すると、Claudeのインタラクションをスクリプト化できます。これは、バッチ処理、内部ツールの構築、エージェントのプロトタイプ作成に役立ちます。
• これを使用して、並行リファクタリングを実行したり、テンプレートからコードを生成したり、CI/CDワークフロー内の軽量エージェントとして使用したりできます。

インストール:

# Typescript:
npm install @anthropic-ai/claude-agent-sdk

# Python:
pip install claude-agent-sdk

8. Claude Code GitHub Actions (GHA)

• Claude CodeをGitHub Actionsに直接統合できます。
• プルリクエストの自動生成、コード標準の強制、またはCIパイプラインの一部としてCLAUDE.md駆動のチェックを実行するために使用できます。
• ログが保存されるため、エージェントの動作を監査し、時間とともに`CLAUDE.md`ファイルを改善できます。

9. 設定と構成

a. `settings.json`で、以下を設定できます。

• プロキシ (`HTTPS_PROXY`) — CLIトラフィックのデバッグに便利です。
• タイムアウト (`MCP_TOOL_TIMEOUT`, `BASH_MAX_TIMEOUT_MS`) — 長時間タスクを実行する場合は、これらの値を増やしてください。
• APIキー (`ANTHROPIC_API_KEY`) — Anthropicのキーまたはヘルパースクリプトを使用してください。
• 権限 — Claude Codeが実行を許可されているシステムツールを制御します。

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.acme.com",
    "Reminder: Code reviews required for all PRs",
    "New security policy in effect"
  ]
}

高度な機能と生産性向上ヒント

1. モデルの切り替え: タスクに応じてClaude 4 SonnetまたはOpusを選択します。Sonnetは高速で費用対効果が高く、Opusは複雑な複数ファイルの変更により適しています。
2. 思考モード（チート）: 一部のユーザーは、Claudeの推論の深さを調整するために、推論モードを`think`、`think hard`、`think harder`、または`ultrathink`に設定します。
3. カスタムコマンド: `.claude/commands`で動的なプレースホルダー (`$argument`) を使用して、再利用可能なスラッシュコマンドを定義します。テスト、ビルド、レビューに最適です。
4. セッション履歴: `claude --resume`または`claude --continue`を使用して、古いセッションを再開します。Claudeはすべてのセッション履歴をローカルに保存します。
5. フィードバックループ: GitHub Actionのログまたは過去のセッションデータを介してエージェントの動作を確認し、誤解を修正したり、より良いガードレールを強制するために`CLAUDE.md`を更新します。

よくある質問 (FAQ)

Q1. `CLAUDE.md`の目的は何ですか？
A: `CLAUDE.md`はエージェントのマニフェストとして機能します。これはClaude Codeが従うべきルール、ツール、慣例を定義します。リポジトリ全体で動作を標準化するのに役立ちます。

Q2. サブエージェントと単純なタスクのどちらを使うべきですか？
A: 厳密なモジュール式ワークフローが必要な場合は、サブエージェントを使用します。しかし、多くの人は**マスター-クローン**パターン（`Task(...)`を使用）の方が柔軟性があると感じています。これにより、サブタスクを委任しながらコンテキストを維持できます。

Q3. すべてを失わずにClaudeセッションを再起動するにはどうすればよいですか？
A: `/clear`を使用してチャットをリセットし、その後`/catchup`を使用してGitブランチからファイルをロードすることで、Claudeが完全なコンテキストを再び持てるようにします。

Q4. フックとは何ですか、なぜそれが必要なのですか？
A: フックは、Claudeが作業をコミットする際にルールやチェックを強制します。例えば、送信時にブロックするフックは、Gitコミットが許可される前にテストが合格していることを保証できます。

Q5. Claude CodeをCI/CDに統合するにはどうすればよいですか？
A: Claude Code GitHub Actionを使用して、自動化されたパイプラインでタスクの実行、コードの検証、プルリクエストの生成、または`CLAUDE.md`のガードレールの強制を行います。

結論

このClaude Codeチートシートは、Claude Codeを効果的に使用するための実践的で構造化された概要を提供します。適切に作成された`CLAUDE.md`ファイルの記述から、スラッシュコマンド、サブエージェント、フック、CI統合の活用まで、これらのパターンは、Claude Codeを信頼できるAI搭載の開発パートナーとして使用するための強固な基盤を形成します。

これらの機能を習得することで、新しい開発者は迅速にオンボーディングでき、経験豊富なエンジニアはワークフローを効率化し、ガードレールを強制し、Claudeによる生産性を向上させることができます。Claude Codeは単なるコード生成ツールではなく、チームのニーズに適応するプログラム可能なエージェントシステムです。