Claude Code 使用指南

Claude Code 是 Anthropic 推出的终端 AI 编程助手，直接在命令行中运行，能够理解整个代码库并执行多文件操作。

什么是 Claude Code

Claude Code 是一个终端原生的 AI 编程工具：

• 在命令行中直接使用，无需打开 IDE
• 基于 Claude 3.5/3.7 模型，代码理解能力强
• 支持多文件读写、执行命令、运行测试
• 适合大规模重构和复杂任务

安装

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

# 或使用 npx（无需安装）
npx @anthropic-ai/claude-code

核心功能

1. 终端对话

在项目目录下运行 claude，进入对话模式：

claude
> 帮我找出项目中所有的 N+1 查询问题
> 把这个项目的测试覆盖率提升到 80%
> 重构 user.service.js，提取公共逻辑

2. 多文件操作

Claude Code 可以：

• 同时读取多个文件理解上下文
• 批量修改多个文件
• 执行 shell 命令（git、npm 等）
• 运行测试并修复失败的用例

3. 代码审查

# 审查当前分支的变更
claude "review my changes, focus on security issues"

# 生成 commit message
claude "generate a commit message for my changes"

4. 项目理解

Claude Code 会自动：

• 读取项目结构
• 理解依赖关系
• 参考现有代码风格
• 生成符合项目规范的代码

常用命令

claude                  # 启动对话模式
claude "task description"  # 直接执行任务
claude -p "prompt"      # 非交互模式（脚本中使用）

实用技巧

提供清晰的上下文

任务描述越具体，效果越好：

不好：修复 bug
好：用户登录时偶尔报 500 错误，
    怀疑是 Redis 连接超时导致的，
    请检查 auth.service.js 和相关配置

让 Claude 先解释再动手

不要直接改代码，先解释一下问题原因，
等我确认后再修改

结合 git 使用

# 让 Claude 帮你写 commit message
claude "write a commit message based on my staged changes"

# 让 Claude 审查 PR
claude "review the diff between main and my feature branch"

与 Cursor / Copilot 对比

功能	Claude Code	Cursor	Copilot
使用方式	终端	IDE	IDE
代码库理解	✅ 非常强	✅ 强	❌
多文件操作	✅	✅	❌
执行命令	✅	❌	❌
代码补全	❌	✅	✅
适合场景	大规模重构	日常开发	代码补全

选择建议：

• 日常编码 → Cursor 或 Copilot
• 大规模重构、代码审查 → Claude Code
• 两者结合使用效果最佳

注意事项

• Claude Code 会执行命令，注意权限控制
• 建议在 git 有提交的状态下使用，方便回滚
• 敏感项目慎用（代码会发送到 Anthropic 云端）
• 使用 -p 参数可以在 CI/CD 中集成

相关资源

• 官方网站
• Anthropic 文档
• GitHub 仓库