开始使用 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（每台机器只需一次）：

如果 .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 只会建议改进，不会覆盖）
• 使用 LLM 按照200行规则生成

保持在 200 行以下。文件过长会消耗 context 并导致 Claude 遗漏规则（遵循度下降）。只写关键内容：构建命令、编码标准、主要规范。如果指令膨胀，可拆分到 @import 或 .claude/rules/ 中的文件。

步骤 3：设置编码级别（可选）

在 Claude Code session 中，运行 /ck:coding-level 命令（无参数）来打开交互式选择器，选择 6 个级别之一。或直接设置：/ck:coding-level 3。

自定义 Rules — .claude/rules/

对于大型项目，将指令拆分为 .claude/rules/ 中的多个小文件，而不是把所有内容塞进一个 CLAUDE.md。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 的最佳实践

常见使用场景

加载顺序

打开 session 时，Claude 按从上到下的顺序读取 memory 文件，然后将所有内容拼接（concatenate）到上下文中——互不覆盖。

带 paths frontmatter 的 rules 仅在 Claude 接触匹配模式的文件时激活——不在启动时加载。这样你可以为每个目录编写特定 rule，而不会使 CLAUDE.md 膨胀。

高级文件加载机制

对于大型项目或想在多个 repo 之间共享 rules 时，你有 4 种上下文扩展机制。下面的图表显示了每种机制如何将额外文件拉入基础 CLAUDE.md。

初学者必知的 7 个核心命令

真实使用案例

最佳实践

做：给 Claude 提供验证结果的方法

影响最大的单一建议。

做：头脑风暴 → 计划 → Cook

/ck:cook 已包含测试。需要测试特定文件夹时才单独使用 /ck:test [path]。

做：提供具体上下文

做：频繁清空上下文

何时使用 /clear：

• 切换到完全不同的任务
• Claude 在同一问题上出错超过 2 次
• Claude 开始「忘记」指令

不良实践（避免！）

常见工作流模式

常见工作流模式

此速查表仅列出 14 个常用命令。查看所有命令的完整参考表、详细语法和实际示例：vividkit.dev/guides/commands。

速查表