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-codeClaude Codeを使い始める:
cd your-project
claude最大限の生産性で開発チームが協力できる統合されたオールインワンプラットフォームをお探しですか？
Apidogはあなたのすべての要望に応え、Postmanをはるかに手頃な価格で置き換えます！
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. スラッシュコマンド
- スラッシュコマンドは、事前に定義されたプロンプトへのショートカットです。
- 例:
| コマンド | 説明 |
|---|---|
/catchup |
Claudeにgitブランチ内の変更されたファイルを読み込み、ロードするように依頼します |
/clear |
会話履歴をクリアします（メモリリセット） |
/add-dir |
Claudeのワークスペースにディレクトリを追加します |
/mcp |
モデルコンテキストプロトコル（MCP）サーバーを管理します |
/model |
使用するClaudeモデルを切り替えます（例：Sonnet、Opus） |
/pr |
プルリクエストを準備します（スラッシュコマンド経由で設定されている場合） |
- スラッシュコマンドは最小限に抑え、目的に集中させます。すべてのタスクに頼らないようにしてください。
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-sdk8. 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"
]
}高度な機能と生産性向上ヒント
- モデルの切り替え: タスクに応じてClaude 4 SonnetまたはOpusを選択します。Sonnetは高速で費用対効果が高く、Opusは複雑な複数ファイルの変更により適しています。
- 思考モード（チート）: 一部のユーザーは、Claudeの推論の深さを調整するために、推論モードを
think、think hard、think harder、またはultrathinkに設定します。 - カスタムコマンド:
.claude/commandsで動的なプレースホルダー ($argument) を使用して、再利用可能なスラッシュコマンドを定義します。テスト、ビルド、レビューに最適です。 - セッション履歴:
claude --resumeまたはclaude --continueを使用して、古いセッションを再開します。Claudeはすべてのセッション履歴をローカルに保存します。 - フィードバックループ: 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は単なるコード生成ツールではなく、チームのニーズに適応するプログラム可能なエージェントシステムです。
最大限の生産性で開発チームが協力できる統合されたオールインワンプラットフォームをお探しですか？
Apidogはあなたのすべての要望に応え、Postmanをはるかに手頃な価格で置き換えます！
