From aaf9e27025d904fdee95bc609a5ea9e3404624df Mon Sep 17 00:00:00 2001 From: Zane Date: Wed, 10 Jun 2026 01:11:53 +0800 Subject: [PATCH] =?UTF-8?q?Add=20Milky=20note:=20[Milky]=20=E4=B8=BA?= =?UTF-8?q?=E6=82=A8=E6=95=B4=E7=90=86=E3=80=8AClaude=20Code=E5=88=9B?= =?UTF-8?q?=E5=A7=8B=E4=BA=BA:=E6=95=99=E4=BD=A0=E6=AD=A3=E7=A1=AE?= =?UTF-8?q?=E5=86=99=E5=87=BAAI=E6=8F=90=E7=A4=BA=E8=AF=8D=EF=BC=8C?= =?UTF-8?q?=E8=BF=98=E6=9C=89=E6=90=AD=E5=BB=BA=E8=87=AA=E5=B7=B1=E7=9A=84?= =?UTF-8?q?Agent=E6=99=BA=E8=83=BD=E4=BD=93=E3=80=8B=E7=AC=94=E8=AE=B0=20|?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...示è¯_还有æ­å»ºè‡ªå·±çš„Agent智能体_BV1BpEh6YEDU_笔记.md | 441 +++++++++++++++++ InBox/milky_BV1BpEh6YEDU.md | 444 ++++++++++++++++++ 2 files changed, 885 insertions(+) create mode 100644 InBox/Claude_Code创始人_教你正确写出AIæç¤ºè¯_还有æ­å»ºè‡ªå·±çš„Agent智能体_BV1BpEh6YEDU_笔记.md create mode 100644 InBox/milky_BV1BpEh6YEDU.md diff --git a/InBox/Claude_Code创始人_教你正确写出AIæç¤ºè¯_还有æ­å»ºè‡ªå·±çš„Agent智能体_BV1BpEh6YEDU_笔记.md b/InBox/Claude_Code创始人_教你正确写出AIæç¤ºè¯_还有æ­å»ºè‡ªå·±çš„Agent智能体_BV1BpEh6YEDU_笔记.md new file mode 100644 index 0000000..8f788e8 --- /dev/null +++ b/InBox/Claude_Code创始人_教你正确写出AIæç¤ºè¯_还有æ­å»ºè‡ªå·±çš„Agent智能体_BV1BpEh6YEDU_笔记.md @@ -0,0 +1,441 @@ +# 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 +# 1. 设置终端(获得 Shift+Enter æ¢è¡ŒåŠŸèƒ½ï¼‰ +/terminal setup + +# 2. 切æ¢ä¸»é¢˜ +/slash themes # å¯é€‰æ‹© light/dark/zen 主题 + +# 3. 安装 GitHub App(å¯é€‰ï¼‰ +# åœ¨ä»»æ„ GitHub issue 或 PR 中 @Claude) +/install github-app +``` + +### 工具æƒé™è‡ªå®šä¹‰ + +```bash +# 自定义å…许使用的工具集,é¿å…æ¯æ¬¡éƒ½å¼¹å‡ºç¡®è®¤ +# 这样设置åŽä¸éœ€è¦æ¯æ¬¡éƒ½æ‰‹åŠ¨æ‰¹å‡†å·¥å…·è°ƒç”¨ +``` + +### 语音输入(Mac 用户) + +1. 进入系统设置 → Accessibility → Dictation +2. å¯ç”¨å¬å†™åŠŸèƒ½ +3. **åŒå‡»å¬å†™é”®**å³å¯è¯­éŸ³è¾“å…¥æç¤ºè¯ + +> 这对于编写详细的æç¤ºè¯éžå¸¸æœ‰å¸®åŠ©ï¼Œå¯ä»¥åƒä¸Žå¦ä¸€ä¸ªå·¥ç¨‹å¸ˆå¯¹è¯ä¸€æ ·è‡ªç„¶åœ°æè¿°éœ€æ±‚。 + +--- + +## 第一步: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 拥有一个å°åž‹å·¥å…·é›†ï¼Œå®ƒä¼šè‡ªåЍ䏲è”使用这些工具: + +1. **Edit files** - 编辑文件 +2. **Run bash commands** - è¿è¡Œå‘½ä»¤ +3. **Search files** - æœç´¢æ–‡ä»¶ + +### 推è的代ç ç¼–è¾‘å·¥ä½œæµ + +``` +1. 让 Claude å…ˆæ€è€ƒå’Œè§„划 +2. 让它å‘你展示计划 +3. å¾å¾—ä½ åŒæ„åŽå†å†™ä»£ç  +``` + +**推èæç¤ºè¯æ¨¡æ¿**: + +```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 工具,å¯ä»¥é›†æˆå›¢é˜Ÿå·²æœ‰çš„å„ç§å·¥å…·ï¼š + +1. **告诉 Claude 关于工具的æè¿°** +2. **添加 MCP æœåС噍é…ç½®** +3. 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) | + +### 常用技巧 + +**1. 自动接å—编辑模å¼** +```bash +# 适åˆåœºæ™¯ï¼š +# - çŸ¥é“ Claude åœ¨åšæ­£ç¡®çš„事 +# - è¿è¡Œå•元测试并迭代 +# - ä¸éœ€è¦æ¯æ¬¡éƒ½æ‰‹åŠ¨æ‰¹å‡† +``` + +**2. 让 Claude è®°ä½å好** +```text +# 如果 Claude 没有正确使用æŸä¸ªå·¥å…· +# 输入: +#remember always use --verbose flag when running this tool + +# Claude 会自动更新 quilMD +``` + +**3. 批é‡å‘½ä»¤è¿›å…¥ä¸Šä¸‹æ–‡** +```bash +# 输入 ! åŽè·Ÿå‘½ä»¤ +!docker build -t myapp . +# 命令和输出都会进入 Claude çš„ä¸Šä¸‹æ–‡çª—å£ +# 适åˆï¼š +# - é•¿æ—¶é—´è¿è¡Œçš„命令 +# - éœ€è¦ Claude 分æžå‘½ä»¤è¾“出 +``` + +**4. ä¼šè¯æ¢å¤** +```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: 两个原因** + +1. **通用性**:Anthropic 员工使用å„ç§ IDE(VS Codeã€Neovimã€Xcodeã€JetBrains 等),终端是共åŒçš„åˆ†æ¯ +2. **未æ¥è¶‹åŠ¿**: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 通过以下方å¼å¹³è¡¡å®‰å…¨æ€§å’Œæ•ˆçŽ‡ï¼š + +1. **åªè¯»å‘½ä»¤è¯†åˆ«**:识别哪些命令是åªè¯»çš„ +2. **陿€åˆ†æž**:分æžå“ªäº›å‘½ä»¤å¯ä»¥å®‰å…¨ç»„åˆ +3. **分层æƒé™**: + - ä¼ä¸šçº§ï¼šç»Ÿä¸€é…ç½®æƒé™ + - 项目级:特定项目é…ç½® + - 用户级:个人å好设置 +4. **黑åå•**:å¯ä»¥é˜»æ­¢å±é™©å‘½ä»¤æˆ– 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 å…ˆæ€è€ƒå’Œè§„划 +- 给予å馈工具让它迭代改进 +- 投入时间é…置,回报是巨大的 \ No newline at end of file diff --git a/InBox/milky_BV1BpEh6YEDU.md b/InBox/milky_BV1BpEh6YEDU.md new file mode 100644 index 0000000..bc5aa90 --- /dev/null +++ b/InBox/milky_BV1BpEh6YEDU.md @@ -0,0 +1,444 @@ +--- +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 \ No newline at end of file