AI 工具

Claude Code 完整指南:从安装到多代理并行协作的实战手册

Claude Code 不只是聊天机器人,而是能自主读取文件、执行终端命令、部署程序的本地 AI 代理。本文涵盖安装设置、claude.md 构建、Skills 开发、MCP 集成、多代理协作与 AutoResearch 自我进化系统的完整实战指南。

Claude Code 完整指南:从安装到多代理并行协作的实战手册

当 AI 不再只是回答问题,而是直接替你写程序、执行部署、甚至在你睡觉时自我优化——这就是 Claude Code 真正改变游戏规则的地方。

Claude Code 是一个本地 AI 代理(AI Agent),直接存在于你的终端或 IDE 中,能够自主读写本地文件、执行 bash 命令、控制浏览器,甚至派遣子代理并行完成复杂任务。Vibe Coding 的概念随之流行——你不再需要复制粘贴 AI 输出,Claude Code 自己把代码写进项目并部署上线。


Claude Code 是什么?为什么它不只是「AI 聊天」?

Claude Code 是包裹在 Claude 模型外层的 Harness——赋予 AI 操控真实计算机的能力:

能力传统 AI 聊天Claude Code
生成代码✅ 输出文字✅ 直接写入文件
执行命令✅ bash / npm / git
读取本地文件✅ 读取整个代码库
部署项目✅ 自动 push 和 deploy
连接外部服务有限✅ 通过 MCP 协议
多任务并行✅ 子代理系统

环境安装:三步上手

Claude Code 需要 Anthropic 付费方案(Pro、Max、Team、Enterprise)。

# 方式一:终端全局安装
npm install -g @anthropic-ai/claude-code
# 然后:claude → /login 完成验证

# 方式二:IDE 扩展
# 在 VS Code 扩展市场搜索 "Claude Code"

构建项目大脑:claude.md 核心设计原则

claude.md 是 Claude Code 系统中最关键的单一文件。每次工作会话开始时自动加载,在任何指令执行前就读取这份简报文档。

在新项目目录执行:

/init

Claude 会扫描整个代码库,自动生成结构化的 claude.md

设计原则

原则说明❌ 反面示例
首因效应最重要的规则放第一行把重要规则埋在中段
条列式规则每条规则一行,简短精确长篇大论的段落说明
可验证性每条规则能被明确核查“要聪明”、“不要犯错”
控制长度200-500 行以内把整份 API 文档塞进去
定期修剪犯 2-3 次同样错误就新增规则写一次就忘记更新
# 项目规则(依重要性排序)

- 永远不使用相对导入路径,只用绝对路径
- 所有数据库操作必须使用事务(transaction)
- 禁止删除数据行,使用软删除(soft delete with deleted_at)
- CSS 统一使用 Tailwind,禁用 inline styles
- API 路由必须包含输入验证

开发自定义 Skills:让 Claude 重复执行你的专属工作流

Skills 是 Claude Code 最强大的功能之一,真正实现工作自动化的关键。

.claude/
└── skills/
    └── my-skill-name/
        ├── SKILL.md          # 触发条件 + 执行步骤
        └── scripts/
            ├── main.py       # 主要逻辑脚本
            └── helpers.sh    # 辅助 Shell 脚本

Skills 与 MCP 工具的成本对比:

项目MCP 工具Skills
加载时机每个 Session 全部加载只有被触发时才加载
Token 消耗20 个工具 ≈ 1-2 万 token50 个 Skills ≈ 不到 5,000 token
计费方式不论是否使用都计费只有真正使用才计费

MCP 集成:让 Claude 连接外部世界

MCP 服务器功能适用场景
Chrome DevTools MCP控制 Chrome截图测试、数据抓取、自动化表单
GitHub MCP操作 GitHub APIIssue、PR、管理 Repo
Notion MCP读写 Notion 数据库任务管理、内容发布
Slack MCP发送消息通知、报告自动化
NotebookLM MCP查询知识库RAG 系统、文档查询

四大权限模式与上下文管理

模式说明建议使用时机
询问模式每次修改前询问日常开发
自动模式自动执行所有操作信任的小型修改
计划模式只读探索,不修改代码复杂功能设计前必用
略过模式不询问直接执行熟悉的批量重复任务
/cost      # 查看当前 Session 的 Token 花费
/clear     # 切换新任务时清空对话
/compact   # 压缩冗长对话为高密度摘要

五大核心应用场景

1. 全栈应用快速开发(Vibe Coding)

2. 营销自动化工作流

一条 YouTube 视频链接自动产生:LinkedIn 帖子 + 电子报草稿 + Twitter/X 串文 + 品牌信息图——完全自动化。

3. 多代理并行协作

4. AutoResearch 自我进化系统

设定评分标准 → AI 执行 A/B 测试 → 自动评分 → 保留改进。

实际案例:开发者设定网站加载速度为指标,AutoResearch 在 67 次测试后将页面加载时间从 1,100ms 降至 67ms,改善幅度 81.3%——全程无需人工介入。

5. 日常办公与零成本知识库(RAG)

  • 个人法律助手:60 秒读取整份合同 PDF,识别高风险条款,自动生成反提案
  • NotebookLM RAG:将大型技术文档上传至 Google NotebookLM,通过 MCP 直接在终端查询——完全免费

进阶技巧

# Git Worktrees 并行开发
git worktree add ../feature-a feature-a
git worktree add ../feature-b feature-b

# 渐进式 Compaction
/compact 请保留:1) 已完成功能清单 2) 待解决 Bug 列表 3) 当前架构决策

常见问答

Claude Code 适合非工程师使用吗? 完全适合。只需用自然语言描述需求,Claude Code 就能提供实际产出——从文案撰写到数据分析皆可。

使用 Claude Code 花费高吗? 成本取决于使用量。善用 /cost 监控花费、切换任务时使用 /clear、Plan Mode 避免反复重构。Claude Pro 方案固定月费,适合个人用户。

子代理系统真的实用吗? 在复杂任务(大型代码库重构、多文档并行生成)时效果显著。简单任务建议先用单一代理。


总结

Claude Code 代表了根本性转变:AI 不再是辅助工具,而是真正的工程伙伴。

今天就能开始的三步骤

  1. 安装(npm install -g @anthropic-ai/claude-code
  2. /init 生成 claude.md
  3. 把一个重复性任务封装成第一个 Skill

参考资料

  1. Claude Code 官方文档 — Anthropic
  2. AutoResearch by Andrej Karpathy — GitHub
  3. NotebookLM MCP 集成教程 — GitHub 社区
  4. Claude Code Dispatch 功能说明 — Anthropic 官方博客
  5. V-JEPA 2 机器人规划论文 — Meta AI Research
TAG