Claude Code と ClaudeKit を始める

Claude Codeとは？

Claude CodeはAnthropicのagentic コーディング環境です。質問に答えるだけのチャットボットではなく、ファイルの読み込み、コマンドの実行、コードの修正、問題の自律的な解決ができるAIです。あなたは見守るだけで、他の作業に集中できます。

他のツールとの違い

Context Window — 最も重要なリソース

Claude Codeにはcontext windowがあり、会話全体（メッセージ、読み込んだファイル、コマンド出力）を保持します。コンテキストが満杯になるとパフォーマンスが低下します——これが管理すべき最も重要な制約です。

解決策：関連のないタスク間で /clear を頻繁に使用する。

ClaudeKitとは？

ClaudeKitはClaude Code用のワークフローテンプレート集で、2つのkitで構成されています：

Engineer Kit（claudekit-engineer）はClaude CodeをAIアシスタントから開発パートナーへと変えます。独立したアプリではなく、.claude/ フォルダをプロジェクトにドロップするだけです。

哲学：YAGNI + KISS + DRY

インストールと設定

ステップ1：ClaudeKit CLIをインストール

まずCLIをインストールします（1台のマシンにつき1回のみ）：

.claude/.claude\ フォルダが既に存在する場合は、init前に手動でバックアップまたはマージしてください。

project/
├── CLAUDE.md              Template (customize after)
├── AGENTS.md              Agent definitions
├── .gitignore
├── .repomixignore         Repomix ignore patterns
├── release-manifest.json  Kit version manifest
├── plans/                 Plans directory
├── .opencode/             OpenCode compatibility
└── .claude/               ClaudeKit config
    ├── .ck.json           Kit metadata
    ├── settings.json      Claude Code settings
    ├── metadata.json      Deletion patterns
    ├── statusline.cjs     Statusline config
    ├── .env.example       Environment template
    ├── .mcp.json.example  MCP config template
    ├── agents/            14+ definitions
    ├── hooks/             22+ hooks
    ├── rules/             Workflow rules
    ├── skills/            90+ commands
    ├── scripts/           Utility scripts
    ├── schemas/           JSON schemas
    ├── output-styles/     Response formats
    └── session-state/     Session tracking

ステップ2：CLAUDE.mdをカスタマイズ

ck new と ck init（デフォルト「Update everything: Yes」）は CLAUDE.md テンプレートを自動作成します。「Update everything: No」を選択してチェックを外した場合のみ、CKはこのファイルをスキップします。

CKがテンプレートを作成した後、プロジェクトに合わせてさらにカスタマイズできます：

• 生成されたテンプレートファイルを直接編集し、ビルドコマンド/コードスタイル/規約を追加
• Claude Code内で /init を実行してコードベースから再生成（CLAUDE.mdが既に存在する場合、/init は改善を提案するだけで上書きしません）
• 200行ルールに従ってLLMで生成

200行以下を維持。長いファイルはcontextを消費し、Claudeがルールを見落としやすくなります（遵守度の低下）。重要なことだけ書く：ビルドコマンド、コーディング標準、主要な規約。指示が膨らんだら、@importや.claude/rules/内のファイルに分割。

ステップ3：コーディングレベルを設定（任意）

Claude Codeセッション内で、/ck:coding-levelコマンド（引数なし）を実行してインタラクティブセレクターを開き、6つのレベルから1つを選択。または直接設定：/ck:coding-level 3。

カスタムRules — .claude/rules/

大規模なプロジェクトでは、すべてを1つのCLAUDE.mdに詰め込むのではなく、.claude/rules/内の複数の小さなファイルに指示を分割します。RulesはYAML frontmatter経由でファイルパスごとにスコープを設定可能——Claudeがパターンに一致するファイルに触れたときのみコンテキストにロードされ、コンテキストスペースを節約します。

.claude/ ディレクトリの構造

Rulesは一部にすぎません——.claude/には多くの種類の設定が含まれています。Project scope（git経由でチームと共有）とGlobal scope（個人、マシンごと）の概要：

./CLAUDE.md              # project instructions (hoặc ./.claude/CLAUDE.md)
./CLAUDE.local.md        # personal — gitignored
./.mcp.json              # MCP servers (team-shared)
./.worktreeinclude       # copy gitignored files vào worktree mới (optional)
./.claude/
├── settings.json        # permissions, hooks, model
├── settings.local.json  # personal — auto-gitignored
├── rules/*.md           # topic rules (path-scopable)
├── skills/<name>/       # /skill-name + bundles
├── commands/*.md        # /command (legacy — prefer skills)
├── agents/*.md          # subagents
├── agent-memory/        # project subagent memory (memory: project)
└── output-styles/*.md   # system-prompt styles

.\CLAUDE.md              # project instructions (hoặc .\.claude\CLAUDE.md)
.\CLAUDE.local.md        # personal — gitignored
.\.mcp.json              # MCP servers (team-shared)
.\.worktreeinclude       # copy gitignored files vào worktree mới (optional)
.\.claude\
├── settings.json        # permissions, hooks, model
├── settings.local.json  # personal — auto-gitignored
├── rules\*.md           # topic rules (path-scopable)
├── skills\<name>\       # /skill-name + bundles
├── commands\*.md        # /command (legacy — prefer skills)
├── agents\*.md          # subagents
├── agent-memory\        # project subagent memory (memory: project)
└── output-styles\*.md   # system-prompt styles

~/.claude.json           # app state, personal MCP, UI prefs
~/.claude/
├── CLAUDE.md            # global instructions
├── settings.json        # default settings
├── keybindings.json     # custom shortcuts
├── rules/*.md           # user-level rules
├── skills/              # personal skills
├── commands/            # personal commands
├── agents/              # personal subagents
├── agent-memory/        # subagent memory (memory: user)
├── output-styles/       # personal styles
├── plugins/             # installed plugins (auto-managed)
└── projects/<project>/memory/   # auto-memory (Claude tự ghi)

%USERPROFILE%\.claude.json  # app state, MCP, UI prefs
%USERPROFILE%\.claude\
├── CLAUDE.md            # global instructions
├── settings.json        # default settings
├── keybindings.json     # custom shortcuts
├── rules\*.md           # user-level rules
├── skills\              # personal skills
├── commands\            # personal commands
├── agents\              # personal subagents
├── agent-memory\        # subagent memory (memory: user)
├── output-styles\       # personal styles
├── plugins\             # installed plugins (auto-managed)
└── projects\<project>\memory\  # auto-memory (Claude tự ghi)

パス固有のrules——ファイルパターンでruleのスコープを指定

CLAUDE.md vs Settings：2つの異なるマージメカニズム

違い：CLAUDE.md vs rules/

Rulesを作成する際のベストプラクティス

一般的なユースケース

読み込み順序

セッションを開くとき、Claudeは上から下の順にメモリファイルを読み込み、すべてをコンテキストに連結（concatenate）します——互いに上書きしません。

paths frontmatterを持つrulesは、Claudeがパターンに一致するファイルに触れた時のみ有効になります——起動時には読み込まれません。これにより、CLAUDE.mdを肥大化させることなく、各ディレクトリに固有のruleを書くことができます。

高度なファイル読み込みメカニズム

大規模なプロジェクトや複数のリポジトリ間でrulesを共有したい場合、4つのコンテキスト拡張メカニズムがあります。以下の図は、各メカニズムがどのようにベースのCLAUDE.mdに追加ファイルを取り込むかを示しています。

初心者向け7つのコアコマンド

実際のユースケース

ベストプラクティス

DO: Claudeに結果を検証する方法を与える

最も影響力のある単一のヒント。

DO: ブレインストーム → 計画 → Cook

/ck:cookにはテストが含まれています。特定のフォルダをテストする場合のみ/ck:test [path]を個別に使用してください。

DO: 具体的なコンテキストを提供する

DO: コンテキストを頻繁にクリアする

/clear が必要なタイミング：

• 全く異なるタスクに切り替えるとき
• Claudeが同じ問題で2回以上間違えたとき
• Claudeが指示を「忘れ」始めたとき

バッドプラクティス（避けること！）

一般的なワークフローパターン

一般的なワークフローパターン

このチートシートは14の頻用コマンドのみを掲載。全コマンドの完全リファレンス、詳細構文、実例は vividkit.dev/guides/commands をご覧ください。

チートシート