diff --git a/AI工程/ClaudeCode完全研究.md b/AI工程/ClaudeCode完全研究.md new file mode 100755 index 0000000..cfae570 --- /dev/null +++ b/AI工程/ClaudeCode完全研究.md @@ -0,0 +1,481 @@ +# Claude Code 完全研究 + +> 全面解析 Anthropic Claude Code：安装、配置、最佳实践 +> +> 归档：2026-04-22 + +--- + +## 📊 项目概览 + +| 项目 | 数据 | +|------|------| +| **仓库** | https://github.com/anthropics/claude-code | +| **Stars** | ⭐ 116,974 | +| **Forks** | 19,474 | +| **定位** | 终端 AI 编程助手 | +| **更新** | 2026-04-22 | + +--- + +## 🎯 核心定位 + +Claude Code 是一个**代理式（Agentic）编程工具**，能： +- 读取代码库、理解结构 +- 编辑文件和执行命令 +- 处理 Git 工作流 +- 集成开发工具 +- 通过自然语言驱动 + +--- + +## 📦 安装方式 + +### macOS / Linux（推荐） +```bash +curl -fsSL https://claude.ai/install.sh | bash +``` + +### Windows PowerShell +```powershell +irm https://claude.ai/install.ps1 | iex +``` + +### Windows CMD +```batch +curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd +``` + +### Homebrew +```bash +brew install --cask claude-code # 稳定版（约滞后1周） +brew install --cask claude-code@latest # 最新版 +``` + +### Winget（Windows） +```powershell +winget install Anthropic.ClaudeCode +``` + +### npm 全局安装 +```bash +npm install -g @anthropic-ai/claude-code +``` + +--- + +## 🔐 认证要求 + +| 账户类型 | 支持 | +|---------|------| +| Pro / Max / Team / Enterprise | ✅ 支持 | +| 免费 Claude.ai 账户 | ❌ 不支持 | + +**第三方提供商**： +- Amazon Bedrock +- Google Vertex AI +- Microsoft Foundry + +--- + +## 🏗️ 核心架构 + +### 子代理（Sub-agents） + +Claude Code 内置三类子代理： + +| 子代理 | 模型 | 工具 | 用途 | +|--------|------|------|------| +| **Explore** | Haiku | 只读 | 代码搜索、分析 | +| **Plan** | 继承主对话 | 只读 | 规划模式研究 | +| **General** | 继承主对话 | 全部 | 复杂多步任务 | + +### 自定义子代理 + +创建位置： +- `~/.claude/agents/` — 个人，所有项目可用 +- `.claude/agents/` — 项目级别，仅当前项目 +- 插件目录 — 通过插件分发 + +```markdown +--- +name: code-reviewer +description: 代码审查助手 +tools: Read, Glob, Grep +model: sonnet +--- + +你是一个高级代码审查员。专注于代码质量、安全性和最佳实践。 +``` + +--- + +## 🛠️ 核心命令 + +| 命令 | 用途 | +|------|------| +| `/add-dir ` | 添加工作目录访问 | +| `/agents` | 管理子代理配置 | +| `/batch ` | 并行大规模代码修改 | +| `/branch [name]` | 创建对话分支 | +| `/btw ` | 快速侧问 | +| `/clear` | 清空上下文开始新对话 | +| `/compact [instructions]` | 压缩上下文 | +| `/config` | 打开设置界面 | +| `/context` | 可视化上下文使用 | +| `/copy [N]` | 复制回复 | +| `/cost` | 显示 token 费用统计 | +| `/debug [description]` | 调试模式 | +| `/diff` | 查看未提交变更 | +| `/help` | 帮助 | +| `/history` | 查看历史消息 | +| `/install` | 安装/更新 Claude Code | +| `/join ` | 加入他人会话 | +| `/kill ` | 终止子代理 | +| `/load` | 加载文件到上下文 | +| `/linter` | 代码检查配置 | +| `/loop ` | 循环执行直到完成 | +| `/model [model]` | 切换模型 | +| `/mcp` | MCP 服务器管理 | +| `/memory` | 内存管理 | +| `/mcp` | MCP 工具管理 | +| `/new` | 新会话 | +| `/opinion [question]` | 询问观点 | +| `/pause` | 暂停子代理 | +| `/permissions` | 权限管理 | +| `/plan` | 规划模式 | +| `/preview` | 预览修改 | +| `/prompt` | 改进提示词 | +| `/reject` | 拒绝修改 | +| `/resume [session]` | 恢复会话 | +| `/review` | 代码审查 | +| `/search ` | 搜索 | +| `/share` | 分享会话 | +| `/shortcuts` | 快捷键 | +| `/simplify` | 简化回复 | +| `/status` | 状态 | +| `/steer ` | 引导代理 | +| `/style [style]` | 调整输出风格 | +| `/table` | 生成表格 | +| `/test` | 测试相关 | +| `/undo` | 撤销 | +| `/upgrade` | 升级订阅 | +| `/web` | 网页搜索 | + +--- + +## 📁 目录结构 + +``` +.claude/ # 项目级配置 +├── agents/ # 子代理定义 +├── commands/ # 自定义命令（已被 skills 取代） +├── skills/ # 技能定义 +├── settings.json # 项目设置 +└── CLAUDE.md # 项目说明文档 + +~/.claude/ # 用户级配置 +├── agents/ # 个人子代理 +├── skills/ # 个人技能 +└── settings.json # 用户设置 +``` + +--- + +## 🔧 CLAUDE.md 最佳实践 + +### 基础结构 +```markdown +# 项目名称 + +简短描述。 + +## 技术栈 +- Node.js 18+ +- Express 框架 + +## 代码规范 +- 使用 async/await +- 错误优先回调 + +## Git 流程 +- 从 main 创建分支 +- PR 需要代码审查 +``` + +### 最佳实践要点 + +| 要点 | 说明 | +|------|------| +| **简洁具体** | 避免冗长，用具体示例 | +| **分块组织** | 按主题分组，用标题 | +| **优先级** | 最重要放最前面 | +| **包含例外** | 说明特殊情况和边界 | +| **定期更新** | 随项目演进更新 | + +--- + +## ⚡ Skills 系统 + +Skills 扩展 Claude 的能力，通过 `SKILL.md` 文件定义。 + +### 目录结构 +``` +my-skill/ +├── SKILL.md # 主指令文件（必需） +├── template.md # 模板 +├── examples/ # 示例 +└── scripts/ # 可执行脚本 +``` + +### SKILL.md 格式 +```yaml +--- +name: my-skill +description: 技能的描述，用来说明何时使用 +disable-model-invocation: true # 禁止自动调用 +allowed-tools: Read, Grep # 允许的工具 +--- + +技能的具体指令内容... +``` + +### 内置 Skills + +| Skill | 用途 | +|-------|------| +| `/simplify` | 简化回复 | +| `/batch` | 大规模并行修改 | +| `/debug` | 调试模式 | +| `/loop` | 循环执行直到完成 | +| `/claude-api` | Claude API 参考 | + +--- + +## 🔀 并行与大规模操作 + +### /batch 命令 +适合大规模重构： +```text +/batch migrate all components from Angular to React +``` + +自动分解任务，并行执行，创建 PR。 + +### Git Worktrees +Claude Code 使用 Git Worktrees 实现并行会话隔离。 + +--- + +## 🛡️ 权限与安全 + +### 权限模式 +- **allow** — 允许所有操作（默认） +- **ask** — 每次询问 +- **deny** — 拒绝所有 + +### 工具级控制 +```json +{ + "permissions": { + "allow": ["Read", "Glob", "Grep"], + "deny": ["Bash"] + } +} +``` + +--- + +## 📊 上下文管理 + +### 上下文压缩 +```text +/compact +``` + +### 上下文可视化 +```text +/context +``` + +显示： +- Token 使用分布 +- 优化建议 +- 容量警告 + +### 内存系统 +```text +/memory +``` + +- 跨会话持久化 +- 自动总结 +- 搜索功能 + +--- + +## 🌐 网络配置 + +### 代理设置 +```json +{ + "env": { + "HTTP_PROXY": "http://proxy:8080", + "HTTPS_PROXY": "http://proxy:8080" + } +} +``` + +### 访问要求 +- api.anthropic.com +- claude.ai +- github.com +- 模型提供商 API + +--- + +## 💡 最佳实践 + +### 1. 项目初始化 +```bash +cd project +claude +# 首次：创建 CLAUDE.md +``` + +### 2. 任务分解 +- 大任务用 `/batch` 分解 +- 复杂调试用 `/debug` +- 重复任务创建 Skills + +### 3. 权限控制 +- 生产环境用 `ask` 模式 +- 信任的开发目录用 `allow` +- 危险操作（rm, push -f）始终确认 + +### 4. 子代理使用 +- 代码探索 → Explore +- 复杂修改 → General +- 创建自定义子代理处理重复任务 + +### 5. 上下文管理 +- 定期 `/compact` +- 保持 CLAUDE.md 更新 +- 大项目创建项目级 Skills + +--- + +## 🔄 工作流示例 + +### 新功能开发 +```bash +# 1. 开启会话 +claude + +# 2. 描述任务 +帮我实现用户认证功能 + +# 3. Claude 自动规划并执行 +# - 创建分支 +# - 编写代码 +# - 编写测试 +# - 提交 PR + +# 4. 代码审查 +/review + +# 5. 合并后 +/compact # 清理上下文 +``` + +### 大规模重构 +```bash +# 使用 batch 命令 +/batch migrate database layer from SQLAlchemy to Prisma + +# Claude 自动： +# 1. 研究代码库 +# 2. 分解成独立任务 +# 3. 并行处理 +# 4. 创建多个 PR +``` + +--- + +## 📱 多端支持 + +| 平台 | 方式 | +|------|------| +| **终端** | `claude` 命令 | +| **桌面 App** | macOS/Windows 原生应用 | +| **VS Code** | 插件市场安装 | +| **JetBrains** | IntelliJ/PyCharm/WebStorm 插件 | +| **浏览器** | Claude Code on the Web | + +--- + +## 🔮 高级功能 + +### MCP（Model Context Protocol）支持 +```text +/mcp +``` +管理 MCP 服务器，扩展工具能力。 + +### Agent Teams +多代理协作模式，适合复杂项目。 + +### Web Search +```text +/web +``` +直接搜索网页。 + +--- + +## ❌ 常见问题 + +| 问题 | 解决方案 | +|------|---------| +| 安装失败 | 检查 Node.js 18+ | +| 权限错误 | 使用 `claude doctor` 诊断 | +| 上下文溢出 | `/compact` 压缩 | +| 更新失败 | Homebrew/WinGet 需手动更新 | + +### 诊断命令 +```bash +claude doctor # 完整诊断 +claude --version # 版本检查 +``` + +--- + +## 📚 学习路径 + +1. **入门**：安装 → 认证 → 基础对话 +2. **进阶**：CLAUDE.md → 子代理 → Skills +3. **高级**：batch 命令 → Agent Teams → MCP +4. **专家**：自定义子代理 → 工作流自动化 → 团队协作 + +--- + +## 🔗 相关资源 + +| 资源 | 链接 | +|------|------| +| 官方文档 | https://docs.anthropic.com/claude-code | +| GitHub | https://github.com/anthropics/claude-code | +| Skills 市场 | https://agentsskills.io | +| API 文档 | https://docs.anthropic.com/api | + +--- + +## AI工程索引 + +相关笔记： +- [[INDEX_AI工程]] - AI工程知识索引 +- [[Claudian插件]] - Obsidian 嵌入 Claude Code + +--- + +*整理：知识库管理员 | 归档：2026-04-22* \ No newline at end of file