Skip to content

Claude Code 使用教程

深入学习 Claude Code 的高级功能和最佳实践,提升您的 AI 编程体验。

基础教程

1. 第一次使用 Claude Code

完成安装后,让我们一步步学习基本操作:

  1. 验证安装
bash
claude --version
  1. 检查环境变量
bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
  1. 启动第一次对话
bash
claude "你好,请介绍一下你的功能"

2. 项目分析入门

学习如何让 Claude Code 理解你的项目:

  1. 进入项目目录
bash
cd /path/to/your/project
  1. 项目概览
bash
claude "分析这个项目的结构和主要功能"
  1. 代码解释
bash
claude "解释 src/main.js 的核心逻辑"

3. 基本代码操作

学习常见的代码操作任务:

  1. 代码生成
bash
claude "创建一个 React 用户登录组件"
  1. 代码修复
bash
claude "修复这个函数中的 bug"
  1. 代码优化
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个专业代理的全流程自动化开发支持。

📖 查看 Subagent 完整指南

核心特性:

  • 10个智能命令(implement、fix、debug、refactor等)
  • 三级处理模式(Quick、Standard、Deep)
  • 多层协作代理架构