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

Claude Code 是 Anthropic 推出的 AI 编程助手，能够理解整个代码库、执行命令、管理 Git 工作流。本文将从安装配置到高级技巧，全面介绍如何高效使用 Claude Code。

一、快速开始

什么是 Claude Code

Claude Code 是一个智能编程助手，具备以下核心能力：

能力	描述
代码理解	读取整个代码库，理解项目结构和依赖
代码编辑	跨多文件编辑、重构、实现新功能
命令执行	运行终端命令、测试、构建脚本
Git 操作	提交代码、创建分支、发起 PR
MCP 集成	连接外部工具和数据源
子代理	并行执行独立任务，提高效率

最新版本：Claude Code 2.1（截至 2026年5月），支持 Fast Mode 使用 Opus 4.6 模型实现更快响应。

安装方式

根据你的操作系统选择安装方式：

平台	命令
macOS / Linux	curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell	irm https://claude.ai/install.ps1 | iex
Homebrew (macOS)	brew install --cask claude-code
WinGet (Windows)	winget install Anthropic.ClaudeCode

安装完成后，在项目目录运行 claude 即可启动交互会话。

---

二、核心命令速查

启动与恢复

claude                    # 启动新会话
claude --continue         # 继续上次会话
claude --resume           # 选择历史会话恢复
claude -p "任务描述"      # 非交互模式执行

会话内斜杠命令

命令	功能
/help	查看帮助
/clear	清除对话历史
/compact	压缩对话历史
/bug	报告问题
/config	打开设置
/init	初始化 CLAUDE.md
/memory	管理记忆
/permissions	管理权限
/review	审查 PR
/mcp	管理 MCP 服务器

实用技巧

# 分析日志文件
tail -200 app.log | claude -p "检查是否有异常"

# CI 自动化
claude -p "运行测试并修复失败的用例"

# 批量审查
git diff main --name-only | claude -p "审查这些文件的安全问题"

# 使用 Fast Mode（更快响应）
/fast

Fast Mode 快速模式

Fast Mode 使用 Claude Opus 4.6 模型实现更快输出，适合需要快速响应的场景：

• 启用方式：输入 /fast 命令
• 特点：不降级到更小的模型，保持 Opus 4.6 的能力
• 适用场景：快速问答、简单任务、需要即时反馈

---

三、配置详解

CLAUDE.md 文件

在项目根目录创建 CLAUDE.md 文件，为 Claude 提供项目上下文：

# 项目概述

这是一个 Next.js 博客系统，使用 TypeScript 和 Tailwind CSS。

## 技术栈

- Next.js 14
- TypeScript
- Tailwind CSS
- marked (Markdown 渲染)

## 代码规范

- 使用函数组件和 Hooks
- 文件命名：小写kebab-case
- 组件命名：PascalCase

## 常用命令

- `npm run dev` - 启动开发服务器
- `npm run build` - 构建生产版本
- `npm test` - 运行测试

settings.json 配置

配置文件位置：

• 项目级：.claude/settings.json
• 用户级：~/.claude/settings.json

常用配置示例：

{
  "permissions": {
    "allow": [
      "Read(**)",
      "Edit(**)",
      "Bash(npm run *)",
      "Bash(git *)"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  },
  "env": {
    "NODE_ENV": "development"
  }
}

权限管理

Claude Code 采用权限系统控制敏感操作：

权限类型	示例
文件读取	Read(src/**)
文件编辑	Edit(**)
命令执行	Bash(npm test)
网络请求	WebFetch(**)

使用 /permissions 命令或 /update-config skill 管理权限。

---

四、高效使用技巧

1. 明确任务描述

不好的做法：

帮我改一下代码

好的做法：

在 src/components/Header.tsx 中添加一个深色模式切换按钮，
点击后切换主题，使用 localStorage 保存用户偏好

2. 提供上下文

使用 @ 符号引用文件或目录：

@src/components/Header.tsx 这个组件需要添加用户头像显示功能

3. 分步处理复杂任务

对于大型任务，使用计划模式：

重构用户认证系统，先制定计划

Claude 会先分析代码库，制定实施计划，等待你确认后再执行。

4. 利用记忆系统

让 Claude 记住重要信息：

记住：我们使用 conventional commits 规范，提交信息格式为 type(scope): description

记忆存储在 ~/.claude/projects/<project>/memory/ 目录。

5. 使用 Hooks 自动化

配置钩子自动执行操作，编辑 settings.json：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '即将执行命令'"
          }
        ]
      }
    ]
  }
}

---

五、MCP 集成

什么是 MCP

MCP (Model Context Protocol) 让 Claude Code 连接外部工具和数据源，扩展能力边界。

常用 MCP 服务器

服务器	功能
filesystem	文件系统访问
github	GitHub API 集成
postgres	PostgreSQL 数据库
slack	Slack 消息发送
linear	Linear 任务管理

配置 MCP

在 settings.json 中添加：

{
  "mcpServers": {
    "github": {
      "command": "mcp-github",
      "args": [],
      "env": {
        "GITHUB_TOKEN": "your-token"
      }
    }
  }
}

使用 /mcp 命令管理 MCP 服务器。

---

六、Git 工作流

提交代码

创建一个 git commit，包含这些更改

Claude 会：

1. 查看 git status 和 diff
2. 分析变更内容
3. 生成符合规范的提交信息
4. 执行 git add 和 git commit

创建 PR

为当前分支创建 PR，目标分支是 main

Claude 会：

1. 检查分支状态
2. 分析提交历史
3. 生成 PR 标题和描述
4. 使用 gh pr create 创建 PR

审查代码

审查当前 PR 的变更

使用 /review 命令进行全面 PR 审查。

---

七、常见场景示例

场景一：修复 Bug

用户报告登录页面点击提交按钮无反应，
请检查 src/pages/login.tsx 中的表单处理逻辑

场景二：添加功能

在博客系统添加文章分类功能：
1. 创建分类数据模型
2. 添加分类管理页面
3. 文章编辑页添加分类选择
4. 首页按分类筛选文章

场景三：代码重构

将 src/utils 目录下的工具函数重构为 TypeScript，
添加类型定义和 JSDoc 注释

场景四：编写测试

为 src/components/Button.tsx 编写单元测试，
使用 Jest 和 React Testing Library

---

八、高级功能

计划模式

对于复杂任务，Claude 会先制定计划：

重构用户认证系统

Claude 会进入计划模式，分析代码库后制定详细实施计划，等待你确认。

远程会话

启动云端运行的会话：

claude --dangerously-skip-permissions --remote

定时任务

使用桌面应用或 /schedule skill 设置定时任务：

每天早上 9 点检查 CI 失败的测试

多会话并行

桌面应用支持同时运行多个独立会话，适合：

• 并行处理多个不相关的任务
• 对比不同方案的实现
• 长时间任务与快速问答并行

---

九、最佳实践

1. 保持 CLAUDE.md 更新

定期更新项目文档，让 Claude 了解最新的项目结构和规范。

2. 合理设置权限

只授予必要的权限，避免过度开放。

3. 审查变更

Claude 提示确认时，仔细审查变更内容再接受。

4. 使用版本控制

重要变更前先创建分支，方便回滚。

5. 善用记忆系统

让 Claude 记住你的偏好和项目约定，减少重复说明。

---

十、故障排除

常见问题

问题	解决方案
无法读取文件	检查文件路径和权限设置
命令执行失败	确认命令权限已允许
MCP 连接失败	检查 MCP 服务器配置和环境变量
会话历史丢失	使用 claude --resume 恢复

获取帮助

• 使用 /help 查看内置帮助
• 使用 /bug 报告问题
• 访问 GitHub Issues

---

总结

Claude Code 是一个强大的 AI 编程助手，掌握其核心功能和最佳实践可以显著提升开发效率。关键要点：

1. 明确任务描述 - 提供清晰的上下文和期望结果
2. 善用配置 - 通过 CLAUDE.md 和 settings.json 定制行为
3. 合理授权 - 只授予必要的权限
4. 审查变更 - 确认前仔细检查代码变更
5. 持续学习 - 探索新功能和技巧

---

参考资料

• Claude Code 官方文档
• Claude Code GitHub
• MCP 协议文档
• Anthropic API 文档

更新日期：2026-05-16 | Claude Code 版本：2.1 | 推荐模型：Claude Opus 4.7 / Sonnet 4.6