444 lines
13 KiB
Markdown
444 lines
13 KiB
Markdown
---
|
||
title: "[Milky] 为您整理《Claude Code创始人:教你正确写出AI提示词，还有搭建自己的Agent智能体》笔记 | BV1BpEh6YEDU"
|
||
source: "milky@4ueo.com"
|
||
date: 2026-06-10 01:11
|
||
tags: [milky, bilibili, notes]
|
||
email_id: 2633
|
||
---
|
||
|
||
Milky 为您整理了《Claude Code创始人:教你正确写出AI提示词，还有搭建自己的Agent智能体》 | BV1BpEh6YEDU 笔记。
|
||
|
||
Claude Code 官方教程：提示词编写与 Agent 智能体搭建
|
||
|
||
演讲者：Boris Cherny，Anthropic 工程师，Claude Code 创建者
|
||
|
||
Claude Code 简介
|
||
|
||
Claude Code 是一种新型的 AI 编程助手，与传统的代码补全工具（如 GitHub Copilot）不同，它是一个全功能的 Agent（智能体），可以：
|
||
|
||
构建完整的功能（features）
|
||
编写整个函数和文件
|
||
修复整个 bug
|
||
自动串联使用各种工具
|
||
|
||
核心特性
|
||
|
||
| 特性 | 说明 |
|
||
|------|------|
|
||
| 跨 IDE 支持 | 支持 VS Code、Xcode、JetBrains 等所有主流 IDE |
|
||
| 跨环境支持 | 可在本地、远程 SSH、Container 等环境中运行 |
|
||
| 通用性 | 不需要改变现有工作流程 |
|
||
| 无需索引 | 代码留在本地，不上传到远程服务器 |
|
||
| 不训练模型 | 不使用用户代码进行训练 |
|
||
|
||
|
||
入门设置
|
||
|
||
基础配置
|
||
|
||
安装 Claude Code 后，官方推荐以下设置：
|
||
|
||
`bash
|
||
设置终端（获得 Shift+Enter 换行功能）
|
||
/terminal setup
|
||
|
||
切换主题
|
||
/slash themes # 可选择 light/dark/zen 主题
|
||
|
||
安装 GitHub App（可选）
|
||
在任意 GitHub issue 或 PR 中 @Claude）
|
||
/install github-app
|
||
`
|
||
|
||
工具权限自定义
|
||
|
||
`bash
|
||
自定义允许使用的工具集，避免每次都弹出确认
|
||
这样设置后不需要每次都手动批准工具调用
|
||
`
|
||
|
||
语音输入（Mac 用户）
|
||
|
||
进入系统设置 → Accessibility → Dictation
|
||
启用听写功能
|
||
双击听写键即可语音输入提示词
|
||
|
||
这对于编写详细的提示词非常有帮助，可以像与另一个工程师对话一样自然地描述需求。
|
||
|
||
|
||
第一步：Codebase Q&A（强烈推荐入门方式）
|
||
|
||
为什么从 Q&A 开始
|
||
|
||
这是 Anthropic 新员工入职培训的第一课：
|
||
|
||
降低学习门槛：不需要了解任何复杂功能，只需要提问
|
||
了解 AI 边界：帮助理解 Claude Code 能做什么、不能做什么
|
||
无需设置：无需索引、无需配置，直接开始使用
|
||
|
||
效率提升数据
|
||
|
||
| 场景 | 传统方式 | 使用 Claude Code Q&A |
|
||
|------|---------|---------------------|
|
||
| 技术入职培训 | 2-3 周 | 2-3 天 |
|
||
|
||
可以问的问题类型
|
||
|
||
`text
|
||
代码使用问题
|
||
"How is this particular piece of code used?"
|
||
"How do I instantiate this thing?"
|
||
|
||
Git 历史问题
|
||
"Look through Git history to explain why this function has 15 arguments"
|
||
Claude Code 会自动：
|
||
查找这些参数是如何引入的
|
||
谁引入了这些更改
|
||
当时的背景情况
|
||
相关的 commit 和 issue
|
||
|
||
GitHub Issues 问题
|
||
"Fetch issues related to this feature"
|
||
可以获取 issue 的上下文信息
|
||
|
||
工作进度查询
|
||
"What did I ship this week?"
|
||
Claude Code 会查看 git log，自动总结本周的工作
|
||
`
|
||
|
||
重要提示：Claude Code 理解这些请求不是通过 System Prompt 指定的，而是模型本身能力强的体现。
|
||
|
||
|
||
代码编辑功能
|
||
|
||
Agent 工作原理
|
||
|
||
Claude Code 拥有一个小型工具集，它会自动串联使用这些工具：
|
||
|
||
Edit files - 编辑文件
|
||
Run bash commands - 运行命令
|
||
Search files - 搜索文件
|
||
|
||
推荐的代码编辑工作流
|
||
|
||
`
|
||
让 Claude 先思考和规划
|
||
让它向你展示计划
|
||
征得你同意后再写代码
|
||
`
|
||
|
||
推荐提示词模板：
|
||
|
||
`text
|
||
"Before you write code, make a plan. Answer with the plan and ask for my approval before writing code."
|
||
`
|
||
|
||
这种方式可以避免"一次性实现3000行功能但完全不是想要的结果"的情况。
|
||
|
||
常见任务提示词
|
||
|
||
`text
|
||
自动创建分支、提交代码并推送到远程
|
||
"Think for this one. This commit push here."
|
||
|
||
Claude Code 会：
|
||
自动创建新分支
|
||
分析 git history 和 git log 确定提交格式
|
||
创建符合项目规范的 commit
|
||
推送到远程
|
||
创建 Pull Request
|
||
`
|
||
|
||
|
||
工具集成
|
||
|
||
Batch 命令工具
|
||
|
||
定义自定义 CLI：
|
||
|
||
`bash
|
||
告诉 Claude Code 关于你的 CLI 工具
|
||
Claude 会使用 --help 来了解工具用法
|
||
|
||
如果频繁使用，可以添加到 quilMD 中（持久化保存）
|
||
`
|
||
|
||
MCP（Model Context Protocol）工具
|
||
|
||
Claude Code 支持 MCP 工具，可以集成团队已有的各种工具：
|
||
|
||
告诉 Claude 关于工具的描述
|
||
添加 MCP 服务器配置
|
||
Claude 会自动学习和使用这些工具
|
||
|
||
常见工作流
|
||
|
||
| 工作流 | 适用场景 | 说明 |
|
||
|--------|---------|------|
|
||
| 探索 → 规划 → 确认 → 写代码 | 复杂功能实现 | 适合需要仔细设计的功能 |
|
||
| 写代码 → 运行测试 → 迭代 | UI 开发 | Claude 可以看到测试结果并自我改进 |
|
||
| 截图/截图验证 | Web/iOS 开发 | Claude 可以用 Puppeteer 截图并迭代 |
|
||
|
||
关键技巧：给 Claude 一个反馈工具（如单元测试、截图验证），它可以自主迭代 2-3 次，通常能得到近乎完美的结果。
|
||
|
||
|
||
上下文管理（核心功能）
|
||
|
||
quilMD 文件
|
||
|
||
quilMD 是 Claude Code 的特殊配置文件，可以放在多个位置：
|
||
|
||
| 位置 | 说明 | 是否提交到 Git |
|
||
|------|------|---------------|
|
||
| 项目根目录 | 所有会话自动读取 | ✅ 应该提交 |
|
||
| 本地 .claude/ 目录 | 仅本地使用 | ❌ 不提交 |
|
||
| 嵌套子目录 | 仅在子目录工作时读取 | ✅ 应该提交 |
|
||
| 企业根目录 | 企业级配置，所有项目共享 | ✅ 企业管理 |
|
||
|
||
quilMD 内容建议
|
||
|
||
`
|
||
推荐包含的内容
|
||
常用的 batch 命令
|
||
MCP 工具配置
|
||
架构决策
|
||
重要的文件路径
|
||
代码风格指南
|
||
|
||
示例内容（Anthropic 实际使用的）
|
||
common bash commands: [...]
|
||
style guide: [...]
|
||
core files: [...]
|
||
`
|
||
|
||
保持简短：quilMD 太长会消耗大量上下文窗口，通常不太有用。
|
||
|
||
企业级配置
|
||
|
||
`yaml
|
||
企业配置文件可以包含：
|
||
全局 s 命令
|
||
批量权限配置
|
||
URL 黑名单（禁止访问的 URL）
|
||
MCP 服务器配置
|
||
权限策略
|
||
`
|
||
|
||
权限管理示例：
|
||
|
||
`yaml
|
||
允许所有员工使用某个测试命令（自动批准）
|
||
allowed_commands:
|
||
- test
|
||
|
||
禁止访问的 URL
|
||
blocked_urls:
|
||
- https://internal.company.com/confidential
|
||
`
|
||
|
||
其他上下文引入方式
|
||
|
||
| 方式 | 语法 | 说明 |
|
||
|------|------|------|
|
||
| @文件路径 | @path/to/file | 引入特定文件到上下文 |
|
||
| s 命令 | /command-name | 可在主目录或项目中定义 |
|
||
| 嵌套 quilMD | - | 在子目录中自动引入 |
|
||
| # 记住 | #remember something | 让 Claude 记住某些偏好 |
|
||
|
||
|
||
快捷键与实用技巧
|
||
|
||
核心快捷键
|
||
|
||
| 快捷键 | 功能 |
|
||
|--------|------|
|
||
| Shift+Tab | 切换到自动接受编辑模式（建议用于运行测试、迭代时） |
|
||
| Escape | 停止 Claude 当前操作（安全操作，不会破坏会话） |
|
||
| Escape + Escape | 返回历史记录 |
|
||
| ↑ + F | 查看完整输出（Claude 上下文窗口中的所有内容） |
|
||
| ! | 进入 batch 模式，输入命令并进入上下文 |
|
||
| # | 让 Claude 记住某些偏好（会自动更新 quilMD） |
|
||
|
||
常用技巧
|
||
|
||
自动接受编辑模式
|
||
`bash
|
||
适合场景：
|
||
知道 Claude 在做正确的事
|
||
运行单元测试并迭代
|
||
不需要每次都手动批准
|
||
`
|
||
|
||
让 Claude 记住偏好
|
||
`text
|
||
如果 Claude 没有正确使用某个工具
|
||
输入：
|
||
remember always use --verbose flag when running this tool
|
||
|
||
Claude 会自动更新 quilMD
|
||
`
|
||
|
||
批量命令进入上下文
|
||
`bash
|
||
输入 ! 后跟命令
|
||
!docker build -t myapp .
|
||
命令和输出都会进入 Claude 的上下文窗口
|
||
适合：
|
||
长时间运行的命令
|
||
需要 Claude 分析命令输出
|
||
`
|
||
|
||
会话恢复
|
||
`bash
|
||
会话结束后，使用 resume 恢复
|
||
/claude resume
|
||
`
|
||
|
||
|
||
Claude Code SDK
|
||
|
||
基础使用
|
||
|
||
`bash
|
||
使用 -p 参数调用 CLI SDK
|
||
claude -p "你的提示词"
|
||
|
||
可选参数：
|
||
--allowed-tools: 指定允许使用的工具
|
||
--format: 输出格式（JSON/streaming JSON）
|
||
`
|
||
|
||
使用场景
|
||
|
||
| 场景 | 示例 |
|
||
|------|------|
|
||
| CI 集成 | 在持续集成流程中使用 |
|
||
| 事件响应 | 处理生产环境问题 |
|
||
| 管道处理 | 集成到各种自动化流程 |
|
||
| 日志分析 | 读取 GCP bucket 中的日志，Claude 找出有趣的信息 |
|
||
| CLI 集成 | 结合 jq 等工具进行数据处理 |
|
||
|
||
管道示例
|
||
|
||
`bash
|
||
读取日志文件并分析
|
||
cat large-log-file.log | claude -p "找出异常模式和错误"
|
||
|
||
结合 Git 命令
|
||
git status | claude -p "帮我生成提交信息"
|
||
|
||
结合 jq 处理数据
|
||
some-api-call | jq '.data' | claude -p "分析这个数据"
|
||
`
|
||
|
||
Claude Code SDK 本质上是一个智能化的 Unix 工具，给一个提示，返回一个 JSON/文本结果。
|
||
|
||
|
||
并行工作技巧（高级用户）
|
||
|
||
普通用户 vs 高级用户
|
||
|
||
| 普通用户 | 高级用户 |
|
||
|---------|---------|
|
||
| 同时运行 1 个 Claude session | 运行多个 SSH 隧道连接的 Claude session |
|
||
| 单个仓库工作 | 多个仓库 checkout 同时运行 |
|
||
| 顺序完成任务 | 使用 Git worktrees 实现隔离并行 |
|
||
|
||
并行化方法
|
||
|
||
`bash
|
||
方法1：多个 terminal tabs
|
||
打开多个终端，每个运行不同的 Claude session
|
||
|
||
方法2：Git worktrees
|
||
git worktree add feature-branch
|
||
在不同的工作树中并行运行 Claude
|
||
|
||
方法3：SSH 隧道
|
||
连接到远程机器运行 Claude
|
||
`
|
||
|
||
建议
|
||
|
||
尽量不要同时在一个仓库中运行多个 Claude，这可能会导致冲突。使用 Git worktrees 实现真正的隔离并行。
|
||
|
||
|
||
Q&A 精选
|
||
|
||
Q: 为什么构建 CLI 工具而不是 IDE 插件？
|
||
|
||
A: 两个原因
|
||
|
||
通用性：Anthropic 员工使用各种 IDE（VS Code、Neovim、Xcode、JetBrains 等），终端是共同的分母
|
||
未来趋势：AI 模型发展迅速，年底可能人们不再使用传统 IDE，CLI 避免在 UI 层过度投资
|
||
|
||
Q: Claude Code 支持多模态吗？
|
||
|
||
A: 完全支持，从一开始就支持
|
||
|
||
使用方法：
|
||
拖拽图片到终端
|
||
提供文件路径
|
||
复制粘贴图片
|
||
|
||
典型使用场景：提供一个 UI mock 图片，告诉 Claude "实现这个界面"，然后用 Puppeteer 迭代验证。
|
||
|
||
Q: Anthropic 内部如何使用 Claude Code？
|
||
|
||
80% 的技术员工每天使用 Claude Code
|
||
包括工程师和研究员
|
||
研究人员使用 notebook 工具编辑和运行 Jupyter notebooks
|
||
|
||
Q: Bash 命令安全性如何处理？
|
||
|
||
A: 复杂的三层权限系统
|
||
|
||
Claude Code 通过以下方式平衡安全性和效率：
|
||
|
||
只读命令识别：识别哪些命令是只读的
|
||
静态分析：分析哪些命令可以安全组合
|
||
分层权限：
|
||
- 企业级：统一配置权限
|
||
- 项目级：特定项目配置
|
||
- 用户级：个人偏好设置
|
||
黑名单：可以阻止危险命令或 URL
|
||
|
||
|
||
总结：最佳实践路线图
|
||
|
||
`
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 入门阶段 │
|
||
│ 1. 安装 Claude Code │
|
||
│ 2. 运行 /terminal setup │
|
||
│ 3. 开始 Codebase Q&A（提问、提问、提问） │
|
||
│ 4. 理解 Claude 的能力和边界 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 进阶阶段 │
|
||
│ 1. 学习代码编辑：先规划 → 确认 → 写代码 │
|
||
│ 2. 使用 #remember 教 Claude 你的偏好 │
|
||
│ 3. 集成团队工具（MCP、自定义 CLI） │
|
||
│ 4. 编写项目 quilMD（共享给团队） │
|
||
└─────────────────────────────────────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 高级阶段 │
|
||
│ 1. 配置企业级策略和权限 │
|
||
│ 2. 使用 SDK 集成到 CI/CD 流程 │
|
||
│ 3. 使用并行工作流（多个 session、worktrees） │
|
||
│ 4. 构建自定义 Agent 解决方案 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
`
|
||
|
||
核心原则：
|
||
|
||
从 Q&A 开始，不要急于使用复杂功能
|
||
给予足够的上下文（quilMD、MCP、工具）
|
||
让 Claude 先思考和规划
|
||
给予反馈工具让它迭代改进
|
||
投入时间配置，回报是巨大的
|
||
|
||
──────────────────────────────
|
||
Generated by MilkyAi@Bilibili: https://space.bilibili.com/3461574540921489 |