329 lines
5.5 KiB
Markdown
329 lines
5.5 KiB
Markdown
# Claude Code 高级开发指南文档索引
|
||
|
||
## 文档概览
|
||
|
||
### README.md
|
||
**文件:** `README.md`
|
||
**行数:** 9,594 行
|
||
**语言:** 中文
|
||
|
||
这是一份极其详细和全面的 Claude Code 学习指南，涵盖从基础到高级的所有内容。
|
||
|
||
## 主要章节
|
||
|
||
### 1. 快速导航与参考
|
||
- 即时命令参考
|
||
- 功能快速参考
|
||
- 高级用户快捷方式
|
||
- 任务状态参考
|
||
- 常见工作流卡片
|
||
|
||
### 2. 核心智能系统
|
||
- Claude 工具的关键发现
|
||
- 高级 REPL 协同模式
|
||
- 专用内核架构集成
|
||
- 元待办事项系统
|
||
- 高级协同实现
|
||
|
||
### 3. 核心概念
|
||
- 7 个核心工具详解
|
||
- 权限系统
|
||
- 项目上下文
|
||
- 内存管理
|
||
- 文件操作
|
||
|
||
### 4. 斜杠命令系统
|
||
- 系统命令
|
||
- 自定义命令
|
||
- 命令模板
|
||
- 命令组织
|
||
|
||
### 5. 钩子系统
|
||
- 钩子类型
|
||
- 事件触发
|
||
- 安全模式
|
||
- 自动化工作流
|
||
|
||
### 6. MCP 集成
|
||
- MCP 服务器配置
|
||
- OAuth 认证
|
||
- 外部系统集成
|
||
- 子代理使用
|
||
|
||
### 7. 开发工作流
|
||
- 文件分析工作流
|
||
- 算法验证工作流
|
||
- 数据探索工作流
|
||
- 任务管理模式
|
||
|
||
### 8. 质量保证
|
||
- 自动化测试
|
||
- 代码审查
|
||
- 多代理协作
|
||
- 验证策略
|
||
|
||
### 9. 错误恢复
|
||
- 常见错误模式
|
||
- 渐进式修复
|
||
- 调试技巧
|
||
- 问题诊断
|
||
|
||
### 10. 实用示例
|
||
- 数据分析
|
||
- 文件处理
|
||
- API 集成
|
||
- 可视化创建
|
||
- 测试自动化
|
||
|
||
### 11. 高级模式
|
||
- 研究系统
|
||
- Smart Flows
|
||
- 认知方法
|
||
- 多代理编排
|
||
|
||
### 12. 最佳实践
|
||
- 开发原则
|
||
- 工具使用
|
||
- 性能优化
|
||
- 代码质量
|
||
|
||
### 13. 故障排除
|
||
- 常见问题
|
||
- 解决方案
|
||
- 诊断步骤
|
||
- 工具调试
|
||
|
||
### 14. 安全考虑
|
||
- 沙箱模型
|
||
- 权限管理
|
||
- 安全审计
|
||
- 最佳安全实践
|
||
|
||
### 15. 工具协同掌握
|
||
- 工具组合模式
|
||
- 高级集成
|
||
- 性能优化
|
||
- 实战案例
|
||
|
||
## 核心工具详解
|
||
|
||
### 1. REPL (JavaScript 运行时)
|
||
- 完整 ES6+ 支持
|
||
- 预加载 5 个库：
|
||
- D3.js (数据可视化)
|
||
- MathJS (数学计算)
|
||
- Lodash (实用工具)
|
||
- Papaparse (CSV 解析)
|
||
- SheetJS (Excel 处理)
|
||
- 异步支持 (async/await)
|
||
- BigInt 支持
|
||
- WebAssembly 支持
|
||
- 文件读取能力
|
||
|
||
### 2. Artifacts (可视化输出)
|
||
- React 组件
|
||
- Three.js 3D 渲染
|
||
- HTML/SVG 生成
|
||
- 图表和可视化
|
||
- 交互式界面
|
||
|
||
### 3. Web Search (网络搜索)
|
||
- 搜索网络内容
|
||
- 域名过滤
|
||
- 仅美国可用
|
||
|
||
### 4. Web Fetch (内容获取)
|
||
- 获取网页内容
|
||
- HTML 转 Markdown
|
||
- 内容提取
|
||
|
||
### 5. Conversation Search (对话搜索)
|
||
- 搜索历史对话
|
||
- 上下文检索
|
||
|
||
### 6. Recent Chats (最近对话)
|
||
- 访问最近会话
|
||
- 对话历史管理
|
||
|
||
### 7. End Conversation (结束对话)
|
||
- 会话清理
|
||
- 对话总结
|
||
|
||
## 大文件分析方法论
|
||
|
||
指南提供系统化的大文件处理方法：
|
||
|
||
### 第一阶段：定量评估
|
||
使用 `wc` 命令确定文件规模
|
||
|
||
### 第二阶段：结构分析
|
||
使用 `grep` 提取结构信息
|
||
|
||
### 第三阶段：内容提取
|
||
使用 `Read` 工具战略性采样
|
||
|
||
## REPL 高级用法
|
||
|
||
### 数据科学能力
|
||
- 处理 100,000+ 元素数组
|
||
- 统计分析
|
||
- 数据转换
|
||
- 可视化准备
|
||
|
||
### 预加载库示例
|
||
```javascript
|
||
// Lodash
|
||
_.chunk([1,2,3,4], 2)
|
||
|
||
// MathJS
|
||
math.sqrt(16)
|
||
|
||
// D3.js
|
||
d3.range(10)
|
||
|
||
// Papaparse
|
||
Papa.parse(csvData)
|
||
|
||
// SheetJS
|
||
XLSX.read(data)
|
||
```
|
||
|
||
## 工作流模式
|
||
|
||
### 文件分析工作流
|
||
探索 → 理解 → 实现
|
||
|
||
### 算法验证工作流
|
||
设计 → 验证 → 实现
|
||
|
||
### 数据探索工作流
|
||
检查 → 分析 → 可视化
|
||
|
||
### 质量保证工作流
|
||
测试 → 审查 → 优化
|
||
|
||
## MCP 集成详解
|
||
|
||
### 配置文件位置
|
||
`~/.config/claude/mcp_config.json`
|
||
|
||
### MCP 服务器类型
|
||
- API 集成服务器
|
||
- 数据库连接服务器
|
||
- 文件系统服务器
|
||
- 自定义工具服务器
|
||
|
||
### 认证方式
|
||
- API 密钥
|
||
- OAuth 2.0
|
||
- 环境变量
|
||
- 配置文件
|
||
|
||
## 钩子系统
|
||
|
||
### 钩子触发时机
|
||
- 工具使用前/后
|
||
- 用户提示提交
|
||
- 文件修改
|
||
- 命令执行
|
||
|
||
### 钩子用途
|
||
- 代码格式化
|
||
- 自动测试
|
||
- Git 操作
|
||
- 日志记录
|
||
- 通知发送
|
||
|
||
## 高级模式
|
||
|
||
### 多代理协作
|
||
- 主代理编排
|
||
- 子代理专门化
|
||
- 结果聚合
|
||
- 任务分解
|
||
|
||
### 智能任务管理
|
||
- 任务创建
|
||
- 状态追踪
|
||
- 进度报告
|
||
- 优先级管理
|
||
|
||
### 认知增强
|
||
- 记忆利用
|
||
- 上下文管理
|
||
- 知识整合
|
||
- 推理优化
|
||
|
||
## 最佳实践总结
|
||
|
||
### 开发原则
|
||
1. 清晰优先
|
||
2. 渐进实现
|
||
3. 持续验证
|
||
4. 适当抽象
|
||
|
||
### 工具使用原则
|
||
1. 选择正确工具
|
||
2. 组合工具能力
|
||
3. 最小化权限
|
||
4. 处理错误
|
||
|
||
### 性能优化原则
|
||
1. 批量操作
|
||
2. 增量处理
|
||
3. 缓存结果
|
||
4. 异步优先
|
||
|
||
## 安全注意事项
|
||
|
||
### 沙箱隔离
|
||
每个工具在独立沙箱中运行
|
||
|
||
### 权限管理
|
||
- 自动授予权限的工具
|
||
- 需要授权的工具
|
||
- 权限最小化原则
|
||
|
||
### 敏感数据处理
|
||
- 不要共享 API 密钥
|
||
- 不要提交密码
|
||
- 使用环境变量
|
||
- 定期审计配置
|
||
|
||
## 快速链接
|
||
|
||
- **GitHub**: https://github.com/karminski/claude-code-guide-study
|
||
- **原始版本**: https://github.com/Cranot/claude-code-guide
|
||
- **Star 数**: 444+
|
||
- **Fork 数**: 174+
|
||
|
||
## 使用建议
|
||
|
||
这份指南内容极其丰富（9,594 行），建议：
|
||
|
||
1. **初学者**: 从核心概念开始
|
||
2. **中级用户**: 关注开发工作流
|
||
3. **高级用户**: 深入高级模式
|
||
4. **问题解决**: 查看故障排除章节
|
||
|
||
## 特色内容
|
||
|
||
### 系统化大文件分析
|
||
详细的三阶段方法论
|
||
|
||
### REPL 深度解析
|
||
超越基础的高级用法
|
||
|
||
### MCP 完整指南
|
||
从配置到实战
|
||
|
||
### 多代理编排
|
||
高级协作模式
|
||
|
||
### 认知增强策略
|
||
提升 Claude 能力的方法
|
||
|
||
---
|
||
|
||
**这是目前最全面的 Claude Code 中文学习资源！**
|