Claude Code 最佳实践 · 网格版文档HTML
「Claude Code 官方最佳实践中文整理:先分清确定性指令与非确定性指令,再补上它看不到的信息、给一个能跑的检查、用 hook 与权限规则兜住例外,并调整 effort、成本与无人值守运行的默认设置,末尾列出已可放弃的旧建议。」
「Claude Code 官方最佳实践中文整理:先分清确定性指令与非确定性指令,再补上它看不到的信息、给一个能跑的检查、用 hook 与权限规则兜住例外,并调整 effort、成本与无人值守运行的默认设置,末尾列出已可放弃的旧建议。」
创建 CLAUDE.md
这样它会将项目的规范、构建命令和架构要点记录下来,后续对话中它会自动参考这个文件,不再需要你重复解释背景。有利于后续的代码分析、调试和功能开发。
运行 /init 命令
/init - 自动分析该项目并生成 CLAUDE.md
我已为该仓库成功创建了CLAUDE.md文件。以下是文件包含的内容:
### CLAUDE.md 内容概要
1. **概述** - 包含项目统计信息(约1884个文件、51.2万行代码、40+工具、80+命令)的项目说明,以及法律免责声明。
2. **命令** - 构建与开发相关命令:
- `npm run prepare-src` - 准备源码
- `npm run build` - 使用esbuild构建
- `npm run check` - 执行类型检查
- `npm start` - 运行编译后的命令行工具
3. **高层架构**:
- src/query.ts中的核心智能体循环模式
- 核心目录(入口点、命令行、命令、工具、组件、服务、状态、工具函数)
- 关键文件及其用途
// ...
CLAUDE.md
本文件用于指导 Claude Code(claude.ai/code)处理此代码仓库中的代码。
概述
本仓库包含 Claude Code v2.1.
网关架构 (Gateway Architecture)
概述
127.0.0.1:18789)。role: node 并包含明确的能力/命令。18793)用于提供代理可编辑的 HTML 和 A2UI。组件与流程
网关 (Gateway) (守护进程)
agent、chat、presence、health、heartbeat、cron。客户端 (Client) (Mac 应用 / CLI / Web 管理)
health、status、send、agent、system-presence)。tick、agent、presence、shutdown)。Claude Agent SDK 是 Anthropic 发布的、用于在 Claude Code 基础上构建强大智能体(agents)的工具集合。该 SDK 最初是作为 Claude Code SDK(一个智能编码解决方案)发布的,旨在支持 Anthropic 内部的开发者效率。由于 Claude Code 已经超越了编码工具的范畴,被用于深度研究、视频制作和笔记记录等无数非编码应用,因此该工具被更名为 Claude Agent SDK,以反映其更广泛的愿景。







一、核心设计原则:赋予 Claude 计算机能力
Claude Agent SDK 的关键设计原则是让 Claude 拥有程序员日常使用的相同工具。这意味着 Claude 必须能够:在代码库中查找文件、编写和编辑文件、运行代码、调试、以及迭代执行这些操作直到成功。
通过允许 Claude 访问用户计算机(经由终端),并赋予其运行 bash 命令、编辑文件、创建文件和搜索文件的能力,它能够有效执行非编码任务,如:阅读 CSV 文件、搜索网络、构建可视化、解释指标等数字工作,从而创建出具有通用目的的智能体。
二、构建的新型智能体
赋予 Claude 计算机能力解锁了许多以前效率不高的智能体类型。SDK 提供了用于自动化任何工作流程的原语,开发者可以构建:
Cline 扩展架构和开发指南
项目概述
Cline 是一个 VSCode 扩展,通过核心扩展后端和基于 React 的 webview 前端的组合提供 AI 辅助功能。该扩展使用 TypeScript 构建,遵循模块化架构模式。
架构概述

定义
概述
提及功能是一个强大的功能,允许你在与 Cline 的对话中使用"@"符号引用各种资源。这包括文件内容、目录结构、网页 URL、VSCode 诊断信息、终端输出、Git 更改状态等 - 所有这些都可以轻松地整合到你的对话中。
通过使用此功能,Cline 可以获得更准确的上下文,为你的任务提供更相关的帮助。
基本语法
提及总是以"@"符号开始,后跟你想要引用的资源的路径或标识符:
@resource_identifier
你可以在用户消息中的任何位置放置提及,Cline 将自动检索引用的内容。
支持的提及类型
1. 文件引用
要引用文件内容,使用 @/ 后跟项目中的相对路径:
@/path/to/file.js
示例:
请分析 @/src/components/Button.tsx 中的实现
在这个例子中,Cline 自动检索 Button.tsx 的内容并用它来执行分析。
2. 目录引用
要引用目录内容,使用 @/ 后跟目录的相对路径,以斜杠结尾:
@/path/to/directory/
示例:
@/src/components/ 目录中有哪些组件?
在这个例子中,Cline 检索组件目录及其内容的列表。
3. URL 引用
要引用网页内容,使用 @ 后跟 URL:
@https://example.com
示例: 请解析来自 @https://api.
我是 Cline,一位专业的软件工程师,我有一个独特的特点:我的记忆在每个会话之间都会完全重置。这不是一个限制 - 这正是驱使我维护完美文档的动力。每次重置后,我完全依赖我的记忆库来理解项目并有效地继续工作。我必须在每个任务开始时阅读所有记忆库文件 - 这不是可选的。
记忆库结构
记忆库由必需的核心文件和可选的上下文文件组成,均为 Markdown 格式。文件之间以清晰的层次结构构建:


核心文件(必需)
projectbrief.mdproductContext.mdactiveContext.mdsystemPatterns.mdtechContext.mdprogress.md附加上下文
当需要组织以下内容时,在 memory-bank/ 中创建额外的文件/文件夹:
核心工作流程
计划模式

执行模式

文档更新
记忆库在以下情况下更新: 发现新的项目模式 实施重
没有找到匹配的文章