9.3 KiB
Executable File
9.3 KiB
Executable File
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（推荐）
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Homebrew
brew install --cask claude-code # 稳定版（约滞后1周）
brew install --cask claude-code@latest # 最新版
Winget（Windows）
winget install Anthropic.ClaudeCode
npm 全局安装
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/— 项目级别，仅当前项目- 插件目录 — 通过插件分发
---
name: code-reviewer
description: 代码审查助手
tools: Read, Glob, Grep
model: sonnet
---
你是一个高级代码审查员。专注于代码质量、安全性和最佳实践。
🛠️ 核心命令
| 命令 | 用途 |
|---|---|
/add-dir <path> |
添加工作目录访问 |
/agents |
管理子代理配置 |
/batch <instruction> |
并行大规模代码修改 |
/branch [name] |
创建对话分支 |
/btw <question> |
快速侧问 |
/clear |
清空上下文开始新对话 |
/compact [instructions] |
压缩上下文 |
/config |
打开设置界面 |
/context |
可视化上下文使用 |
/copy [N] |
复制回复 |
/cost |
显示 token 费用统计 |
/debug [description] |
调试模式 |
/diff |
查看未提交变更 |
/help |
帮助 |
/history |
查看历史消息 |
/install |
安装/更新 Claude Code |
/join <session-url> |
加入他人会话 |
/kill <id> |
终止子代理 |
/load |
加载文件到上下文 |
/linter |
代码检查配置 |
/loop <instruction> |
循环执行直到完成 |
/model [model] |
切换模型 |
/mcp |
MCP 服务器管理 |
/memory |
内存管理 |
/mcp |
MCP 工具管理 |
/new |
新会话 |
/opinion [question] |
询问观点 |
/pause |
暂停子代理 |
/permissions |
权限管理 |
/plan |
规划模式 |
/preview |
预览修改 |
/prompt |
改进提示词 |
/reject |
拒绝修改 |
/resume [session] |
恢复会话 |
/review |
代码审查 |
/search <query> |
搜索 |
/share |
分享会话 |
/shortcuts |
快捷键 |
/simplify |
简化回复 |
/status |
状态 |
/steer <message> |
引导代理 |
/style [style] |
调整输出风格 |
/table |
生成表格 |
/test |
测试相关 |
/undo |
撤销 |
/upgrade |
升级订阅 |
/web |
网页搜索 |
📁 目录结构
.claude/ # 项目级配置
├── agents/ # 子代理定义
├── commands/ # 自定义命令（已被 skills 取代）
├── skills/ # 技能定义
├── settings.json # 项目设置
└── CLAUDE.md # 项目说明文档
~/.claude/ # 用户级配置
├── agents/ # 个人子代理
├── skills/ # 个人技能
└── settings.json # 用户设置
🔧 CLAUDE.md 最佳实践
基础结构
# 项目名称
简短描述。
## 技术栈
- Node.js 18+
- Express 框架
## 代码规范
- 使用 async/await
- 错误优先回调
## Git 流程
- 从 main 创建分支
- PR 需要代码审查
最佳实践要点
| 要点 | 说明 |
|---|---|
| 简洁具体 | 避免冗长，用具体示例 |
| 分块组织 | 按主题分组，用标题 |
| 优先级 | 最重要放最前面 |
| 包含例外 | 说明特殊情况和边界 |
| 定期更新 | 随项目演进更新 |
⚡ Skills 系统
Skills 扩展 Claude 的能力，通过 SKILL.md 文件定义。
目录结构
my-skill/
├── SKILL.md # 主指令文件（必需）
├── template.md # 模板
├── examples/ # 示例
└── scripts/ # 可执行脚本
SKILL.md 格式
---
name: my-skill
description: 技能的描述，用来说明何时使用
disable-model-invocation: true # 禁止自动调用
allowed-tools: Read, Grep # 允许的工具
---
技能的具体指令内容...
内置 Skills
| Skill | 用途 |
|---|---|
/simplify |
简化回复 |
/batch |
大规模并行修改 |
/debug |
调试模式 |
/loop |
循环执行直到完成 |
/claude-api |
Claude API 参考 |
🔀 并行与大规模操作
/batch 命令
适合大规模重构：
/batch migrate all components from Angular to React
自动分解任务，并行执行，创建 PR。
Git Worktrees
Claude Code 使用 Git Worktrees 实现并行会话隔离。
🛡️ 权限与安全
权限模式
- allow — 允许所有操作（默认）
- ask — 每次询问
- deny — 拒绝所有
工具级控制
{
"permissions": {
"allow": ["Read", "Glob", "Grep"],
"deny": ["Bash"]
}
}
📊 上下文管理
上下文压缩
/compact
上下文可视化
/context
显示：
- Token 使用分布
- 优化建议
- 容量警告
内存系统
/memory
- 跨会话持久化
- 自动总结
- 搜索功能
🌐 网络配置
代理设置
{
"env": {
"HTTP_PROXY": "http://proxy:8080",
"HTTPS_PROXY": "http://proxy:8080"
}
}
访问要求
- api.anthropic.com
- claude.ai
- github.com
- 模型提供商 API
💡 最佳实践
1. 项目初始化
cd project
claude
# 首次：创建 CLAUDE.md
2. 任务分解
- 大任务用
/batch分解 - 复杂调试用
/debug - 重复任务创建 Skills
3. 权限控制
- 生产环境用
ask模式 - 信任的开发目录用
allow - 危险操作（rm, push -f）始终确认
4. 子代理使用
- 代码探索 → Explore
- 复杂修改 → General
- 创建自定义子代理处理重复任务
5. 上下文管理
- 定期
/compact - 保持 CLAUDE.md 更新
- 大项目创建项目级 Skills
🔄 工作流示例
新功能开发
# 1. 开启会话
claude
# 2. 描述任务
帮我实现用户认证功能
# 3. Claude 自动规划并执行
# - 创建分支
# - 编写代码
# - 编写测试
# - 提交 PR
# 4. 代码审查
/review
# 5. 合并后
/compact # 清理上下文
大规模重构
# 使用 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）支持
/mcp
管理 MCP 服务器，扩展工具能力。
Agent Teams
多代理协作模式，适合复杂项目。
Web Search
/web <query>
直接搜索网页。
❌ 常见问题
| 问题 | 解决方案 |
|---|---|
| 安装失败 | 检查 Node.js 18+ |
| 权限错误 | 使用 claude doctor 诊断 |
| 上下文溢出 | /compact 压缩 |
| 更新失败 | Homebrew/WinGet 需手动更新 |
诊断命令
claude doctor # 完整诊断
claude --version # 版本检查
📚 学习路径
- 入门：安装 → 认证 → 基础对话
- 进阶：CLAUDE.md → 子代理 → Skills
- 高级：batch 命令 → Agent Teams → MCP
- 专家：自定义子代理 → 工作流自动化 → 团队协作
🔗 相关资源
| 资源 | 链接 |
|---|---|
| 官方文档 | 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