Claude Code 高效使用指南：从入门到精通

Claude Code 高效使用指南：从入门到精通

本文基于 Claude Code CLI 终端环境，总结日常开发中的高效使用技巧。适合从 Cursor / VS Code 等 IDE 迁移过来的开发者快速上手。

一、Claude Code 是什么

Claude Code 是 Anthropic 官方推出的 CLI 工具，直接在终端中运行。它不仅能写代码，还能：

• 读写文件、搜索代码库
• 执行 shell 命令
• 管理 Git 操作（提交、PR、代码审查）
• 连接 MCP 服务器扩展能力
• 记忆跨会话信息

核心优势：不依赖 IDE，纯终端操作，适合 SSH 远程开发、CI/CD 集成、多项目并行管理。

二、安装与启动

# 安装
npm install -g @anthropic-ai/claude-code

# 启动（在项目目录下）
cd your-project
claude

# 带初始提示启动
claude "帮我看看这个项目的结构"

# 非交互模式（适合脚本集成）
claude -p "列出所有 TODO 注释" --output-format json

三、核心命令速查表

3.1 Slash Commands（会话内命令）

3.2 CLI 启动参数

# 恢复最近会话
claude --resume

# 恢复指定会话
claude --resume <session-id>

# 指定模型
claude --model claude-sonnet-4-6

# 非交互模式 + 输出格式
claude -p "你的提示" --output-format json
claude -p "你的提示" --output-format text

# 管道输入
cat error.log | claude "分析这个错误日志"
echo "fix the bug" | claude

# 带系统提示
claude --system-prompt "你是一个 Go 语言专家"

四、会话管理：关闭终端也不丢工作

这是从 Cursor 迁移过来最需要适应的一点。

4.1 自动保存

Claude Code 每次对话都会自动保存。关闭终端不会丢失历史。

4.2 恢复会话

# 方式一：启动时恢复最近会话
claude --resume

# 方式二：启动时选择历史会话
claude --resume
# 会弹出列表让你选择

# 方式三：会话内恢复
/resume

4.3 多会话并行

# 终端 1：项目 A
cd ~/project-a && claude

# 终端 2：项目 B
cd ~/project-b && claude

# 终端 3：专门跑长任务
claude "帮我重构整个 auth 模块"

每个终端窗口独立运行，互不干扰。

五、上下文管理：让对话不"失忆"

5.1 什么时候需要压缩

• 对话超过 20 轮以上
• Claude 开始"忘记"之前讨论的内容
• 响应明显变慢

5.2 手动压缩

# 基础压缩
/compact

# 带提示词压缩（推荐）
/compact 保留项目架构设计和数据库 schema 的讨论
/compact 保留所有关于 API 接口的决策

5.3 CLAUDE.md：项目级"记忆"

# 初始化项目文档
/init

这会在项目根目录生成 CLAUDE.md，内容包括：

• 项目结构
• 技术栈
• 常用命令
• 代码规范

关键点：每次启动 Claude Code 都会自动读取 CLAUDE.md，相当于持久化的上下文。

5.4 Memory 系统：跨会话记忆

Claude Code 有记忆系统，存在 ~/.claude/ 或项目目录下。你可以主动让它记住：

记住：这个项目用 pnpm 不用 npm
记住：数据库迁移文件在 prisma/migrations/ 下

六、高效工作流

6.1 代码搜索与导航

# 直接提问
"UserService 在哪个文件里定义的？"
"找出所有调用 sendEmail 的地方"
"这个项目的 API 路由是怎么组织的？"

# Claude 会自动使用 Glob、Grep 等工具搜索

6.2 Git 工作流

# 提交
"帮我提交当前改动，commit message 用中文"

# PR
"创建一个 PR，标题是 'feat: 添加用户认证'"

# 审查
/review

# 查看历史
"最近 5 次提交改了什么？"

6.3 批量操作

"把所有 .js 文件里的 var 替换成 const"
"给所有 API 端点加上请求日志"
"把整个项目的 TypeScript 严格模式打开"

6.4 调试流程

# 粘贴错误信息
"运行 npm test 报错了：[粘贴错误]"

# 分析日志
cat app.log | claude "找出所有 ERROR 级别的日志并分析原因"

# 逐步排查
"这个函数返回 undefined，帮我看看为什么"

6.5 架构设计

"我想给这个项目加一个缓存层，Redis 还是内存缓存好？"
"帮我设计一个消息队列的方案"
"这个微服务之间的通信应该用 gRPC 还是 REST？"

Claude 会先分析现有代码，再给出建议。

七、进阶技巧

7.1 MCP 服务器扩展

MCP（Model Context Protocol）让你连接外部工具：

// .claude/settings.json
{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    }
  }
}

常用 MCP 服务器：

• PostgreSQL/MySQL — 直接查询数据库
• GitHub — 操作 Issues、PR
• Slack — 发送消息
• Puppeteer — 浏览器自动化

7.2 Hooks（自动化钩子）

在特定事件触发时自动执行命令：

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": ["npm run lint -- --fix $CLAUDE_FILE_PATH"]
      }
    ]
  }
}

效果：每次 Claude 编辑文件后，自动运行 lint。

7.3 权限管理

# 在会话中授予权限
# Claude 会询问你是否允许执行某些操作
# 选择 "Always allow" 可以跳过后续确认

# 或在 settings.json 中预配置
{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(git *)",
      "Read",
      "Write"
    ]
  }
}

7.4 非交互模式集成

# 在 CI/CD 中使用
claude -p "审查这个 PR 的改动" --output-format json > review.json

# 在脚本中使用
result=$(claude -p "这个文件有没有安全问题？" --output-format text)
echo "$result"

# 管道组合
git diff | claude "生成 commit message" | xargs git commit -m

八、从 Cursor 迁移对照表

九、常见问题

Q: 终端太小，输出看不全？

# 使用 tmux 或 screen
tmux new -s claude
claude
# Ctrl+B, D 断开，tmux attach -t claude 重新连接

Q: 如何在 WSL 中使用？

# WSL 中安装
npm install -g @anthropic-ai/claude-code
# 和 Linux 一样使用

Q: 对话太长变慢了？

/compact
# 或者重新开始
/clear

Q: 如何让它不那么"啰嗦"？

记住：回答简洁，不要解释 obvious 的事情，直接给代码

Q: 支持哪些模型？

# 启动时指定
claude --model claude-opus-4-7
claude --model claude-sonnet-4-6
claude --model claude-haiku-4-5-20251001

# 或在 /config 中切换

十、效率倍增的工作习惯

1. 项目初始化：每个新项目先跑 /init，生成 CLAUDE.md
2. 及时压缩：对话超过 20 轮就 /compact
3. 善用管道：git diff | claude "..." 比复制粘贴高效
4. 多终端并行：一个跑主任务，一个查资料，一个跑测试
5. 记忆习惯：让 Claude 记住你的偏好，减少重复沟通
6. 非交互模式：重复任务写成脚本，用 claude -p 批量处理

最后更新：2026-05-23
适用于：Claude Code CLI 最新版本