主题
Claude Code 使用教程
深入学习 Claude Code 的高级功能和最佳实践,提升您的 AI 编程体验。
基础教程
1. 第一次使用 Claude Code
完成安装后,让我们一步步学习基本操作:
- 验证安装:
bash
claude --version
- 检查环境变量:
bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
- 启动第一次对话:
bash
claude "你好,请介绍一下你的功能"
2. 项目分析入门
学习如何让 Claude Code 理解你的项目:
- 进入项目目录:
bash
cd /path/to/your/project
- 项目概览:
bash
claude "分析这个项目的结构和主要功能"
- 代码解释:
bash
claude "解释 src/main.js 的核心逻辑"
3. 基本代码操作
学习常见的代码操作任务:
- 代码生成:
bash
claude "创建一个 React 用户登录组件"
- 代码修复:
bash
claude "修复这个函数中的 bug"
- 代码优化:
bash
claude "优化这段代码的性能"
中级教程
1. 高效的交互式会话
掌握交互模式的高级技巧:
会话管理:
bash
# 启动新会话
claude
# 继续上次对话
claude -c
# 恢复特定会话
claude --resume session-id
上下文利用:
- 在会话中,Claude Code 会记住之前的对话内容
- 可以引用之前讨论的代码或概念
- 建立连续性的开发工作流
2. 管道和自动化
学习将 Claude Code 集成到开发工作流中:
分析 Git 变更:
bash
git diff | claude -p "总结这次提交的主要变更"
git log --oneline -10 | claude -p "分析最近的提交历史"
处理构建输出:
bash
npm run build 2>&1 | claude -p "分析构建错误并提供解决方案"
npm test 2>&1 | claude -p "解释测试失败的原因"
日志分析:
bash
tail -n 100 /var/log/app.log | claude -p "分析这些日志中的问题"
3. 多项目管理
处理复杂的多模块项目:
添加工作目录:
bash
claude --add-dir ../backend ../frontend ../shared
跨项目分析:
bash
claude "比较前端和后端的 API 接口定义是否一致"
高级教程
1. MCP 外部服务集成
MCP(Module for Connecting Plugins)可扩展 Claude Code 功能。
基础命令:
bash
# 列出已安装的 MCP 服务
claude mcp list
# 添加新的 MCP 服务
claude mcp add <名称> <命令>
# 移除 MCP 服务
claude mcp remove <名称>
常用集成:
Git 集成:
bash
npm install -g git-mcp-server
claude mcp add git "git-mcp-server"
claude mcp add github "github-mcp-server --token $GITHUB_TOKEN"
数据库集成:
bash
npm install -g postgres-mcp-server
export POSTGRES_URL="postgresql://user:pass@localhost:5432/db"
claude mcp add postgres "postgres-mcp-server --url $POSTGRES_URL"
2. 思考模式调整
控制 Claude Code 的思考深度和质量:
深度 | 关键词 |
---|---|
基础 | think |
中等 | think deeply, megathink |
深度 | ultrathink, think very hard |
使用示例:
bash
claude -p "这个并发漏洞很棘手,ultrathink 并提出修复方案。"
3. 配置系统详解
配置文件位置:
- 全局配置:
~/.claude.json
- 项目配置:项目根目录下
settings.json
配置文件示例:
json
{
"model": "claude-sonnet-4",
"verbose": true,
"outputFormat": "text",
"allowedTools": ["Edit", "View", "Bash(git:*)"]
}
4. 自定义工具权限
精确控制 Claude Code 的操作权限:
权限级别:
级别 | 描述 | 风险 |
---|---|---|
交互模式 | 每次操作确认 | 低 |
允许列表模式 | 仅批准的工具可用 | 中 |
危险模式 | 跳过权限检查 | 高 |
权限配置示例:
bash
# 允许特定工具
claude --allowedTools "Edit" "View" "Bash(git:*)"
# 禁用特定工具
claude --disallowedTools "Edit" "Write" "Bash(rm *)"
# 计划模式(仅制定计划,不执行)
claude --permission-mode plan "重构这个模块的架构"
# 危险模式(跳过所有权限检查)
claude --dangerously-skip-permissions
5. 项目记忆管理(CLAUDE.md)
持久化项目记忆:
bash
# 初始化项目记忆
claude /init
# 查看项目记忆
claude /memory
claude /memory view
通过 /init
命令生成的 CLAUDE.md
文件保存项目架构、目标和规范,帮助 Claude Code 更好地理解项目上下文。
6. 团队协作与 Git 自动化
GitHub Actions 集成: 在 .github/workflows/claude-review.yml
配置 CI/CD 自动审查。
本地 Pre-commit Hook: 在 .git/hooks/pre-commit
添加脚本,提交前自动检查代码安全。
示例 Pre-commit 脚本:
bash
#!/bin/bash
# Claude Code 自动代码审查
claude -p "检查即将提交的代码是否存在安全漏洞" --output-format json > security-check.json
if [ $? -ne 0 ]; then
echo "代码安全检查失败,请修复问题后重新提交"
exit 1
fi
7. 输出格式化和脚本化
将 Claude Code 集成到自动化脚本中:
JSON 输出:
bash
claude -p "检查代码质量" --output-format json > quality-report.json
流式处理:
bash
claude -p "生成大量测试用例" --output-format stream-json
批处理脚本示例:
bash
#!/bin/bash
# 自动代码审查脚本
echo "开始代码审查..."
result=$(claude -p "审查最近的提交,重点关注安全性和性能" --output-format json)
echo $result | jq '.suggestions[]' > review-report.txt
echo "审查完成,报告已保存到 review-report.txt"
3. 复杂项目工作流
处理大型项目的完整开发流程:
功能开发流程:
bash
# 1. 分析需求
claude "分析这个用户故事的技术实现方案"
# 2. 生成代码结构
claude "创建实现这个功能的代码架构"
# 3. 实现细节
claude "实现用户认证的具体逻辑"
# 4. 测试用例
claude "为这个功能生成完整的测试用例"
# 5. 文档生成
claude "为这个功能生成 API 文档"
代码审查流程:
bash
# 审查变更
git diff main..feature-branch | claude -p "审查这个功能分支的代码"
# 安全检查
claude "检查这段代码是否存在安全漏洞"
# 性能分析
claude "分析这个算法的时间复杂度并提出优化建议"
专业技巧
1. 提示词优化
编写更有效的提示词:
具体明确:
bash
# ❌ 模糊
claude "优化这个代码"
# ✅ 具体
claude "优化这个数据库查询函数,重点关注减少查询次数和提高缓存效率"
提供上下文:
bash
claude "这是一个电商网站的订单处理模块,请帮我重构这个函数以支持批量处理订单"
2. 错误处理和调试
高效的问题解决策略:
系统性调试:
bash
# 1. 收集信息
claude "分析这个错误的可能原因"
# 2. 生成假设
claude "基于错误信息,列出可能的解决方案"
# 3. 测试验证
claude "为每个解决方案生成测试代码"
3. Subagent 子代理
Claude Code 集成了强大的 Subagent 智能代理系统,提供10个智能命令和13个专业代理的全流程自动化开发支持。
核心特性:
- 10个智能命令(implement、fix、debug、refactor等)
- 三级处理模式(Quick、Standard、Deep)
- 多层协作代理架构