Claude Code 完全指南：使用方式、技巧与最佳实践

程序员聪Sir
16 阅读6分钟

最近在深度使用 Claude Code，发现真的很香！整理了一份全面的指南，从零开始逐步了解 Claude Code 的核心功能、高级特性和最佳实践。

目录

  1. Claude Code 简介
  2. 安装与配置
  3. 核心概念详解
  4. 高级功能
  5. 实用技巧与快捷操作
  6. 最佳实践
  7. 实战案例
  8. 常见问题与解决方案
  9. 高级集成与扩展

一、Claude Code 简介

1.1 什么是 Claude Code?

Claude Code(CC) 是由 Anthropic 开发的系统级 AI Agent，它不仅是一个代码编写工具，更是一个可以通过自然语言指令完成各种电脑任务的智能助手。

核心特性:

特性说明
全功能访问拥有系统级权限，可执行文件操作、运行命令、管理进程等
超大上下文支持 200K token 上下文窗口，可处理大型项目
高度可扩展支持 MCP、Skills、Plugins、Hooks 等多种扩展方式
多代理协作支持子代理 (Subagents) 并行处理复杂任务
自然交互支持自然语言指令，无需学习复杂命令语法

二、安装与配置

2.1 前置准备

必需工具:

工具用途安装地址
Node.js运行环境nodejs.org
Git版本控制git-scm.com
API Key模型服务智谱 GLM/月之暗面 K2/阿里 Qwen 等

2.2 安装 Claude Code

npm install -g @anthropic-ai/claude-code
claude --version

2.3 配置模型

常用国内模型配置:

模型API 地址模型名称
智谱 GLM-4.7open.bigmodel.cn/api/anthrop…glm-4.7
Kimi K2api.moonshot.cn/anthropickimi-k2-turbo-preview
通义千问dashscope.aliyuncs.com/apps/anthro…qwen-coder-plus
DeepSeekapi.deepseek.com/anthropicdeepseek-chat

配置方式 (macOS/Linux):

export ANTHROPIC_BASE_URL=模型 API 地址
export ANTHROPIC_AUTH_TOKEN=你的 API 密钥
export ANTHROPIC_MODEL=模型名称

三、核心概念详解

3.1 Skills(技能包)

Skills 是预封装的工作流，就像游戏中的"技能包"，用完即走，不占用上下文。

官方 Skills 库: github.com/anthropics/… (32k+ Stars)

常用官方 Skills:

# 前端设计技能
npx skills-installer install @anthropics/claude-code/frontend-design

# 文档协同技能
npx skills-installer install @anthropics/claude-code/doc-coauthoring

# PDF 处理技能
npx skills-installer install @anthropics/claude-code/pdf

3.2 Hooks(钩子)

Hooks 是在特定事件触发时自动执行的脚本，用于自定义工作流、拦截危险操作、自动格式化代码等。

Hook 事件类型:

事件类型触发时机典型用途
user-prompt-submit用户提交提示词前验证、修改提示词
tool-use工具使用前权限检查、参数验证
after-tool-use工具使用后日志记录、结果处理
permission-request权限请求时拦截危险操作

3.3 Plugins(插件)

Plugins 是打包在一起的扩展集合，可以包含：

  • 5 个 Skills
  • 10 个斜杠命令
  • 3 个 MCP 服务器配置
  • 2 个 SubAgent 定义
  • 若干 Hooks

3.4 MCP Servers(模型上下文协议服务器)

MCP (Model Context Protocol) 是 AI 的扩展接口标准，通过添加 MCP 服务器可以扩展 Claude Code 获取外部工具、资源、服务的能力。

常用 MCP 服务器:

MCP Server功能Star 数
chrome-devtools-mcp浏览器自动化，26 个工具18.5k
github-mcpGitHub API 集成10k+
postgres-mcpPostgreSQL 数据库操作5k+

安装示例:

claude mcp add chrome-devtools npx chrome-devtools-mcp@latest

3.5 Subagents(子代理)

Subagents 是可以并行处理任务的独立 AI 代理，每个子代理拥有独立的 200K 上下文窗口。

3.6 CLAUDE.md(项目记忆文件)

CLAUDE.md 是 Claude Code 的"项目记忆文件"，记录项目结构、构建命令、代码规范、架构决策等信息。

作用:

  • 📚 项目知识库
  • 🚀 快速启动
  • 🤝 团队协作
  • 🔄 持续迭代

四、高级功能

4.1 Plan 模式 (规划模式)

"先规划、后执行"的工作模式，Claude 会先分析项目架构再起草实现方案。

进入方式: 按两次 Shift+Tab 或输入 /plan

适合场景:

  • ✅ 复杂功能开发
  • ✅ 架构重构
  • ✅ 性能优化
  • ✅ 代码迁移

4.2 Sandbox 模式 (沙箱模式)

通过定义允许的操作范围，拦截危险操作，提高安全性。

4.3 Headless 模式 (无头模式)

非交互式运行方式，可集成到 Shell 脚本或 CI/CD 流程中。

git diff | claude -p "解释这些更改"
cat file.txt | claude -p "总结这个文件"

4.4 Slash Commands(自定义命令)

命令功能
/clear清空对话历史
/compact清空对话但保留摘要
/context可视化上下文使用
/model切换模型
/cost显示费用统计
/doctor诊断环境

五、实用技巧与快捷操作

5.1 基础操作

  • @提及: 引用文件，如 @src/auth.ts
  • !前缀: 即时执行 Bash 命令，如 !git status
  • 双击 ESC: 回退操作

5.2 效率提升

  • Ctrl+R: 搜索历史提示词
  • Ctrl+S: 暂存当前提示词
  • claude --continue: 恢复上一次对话
  • claude --resume: 显示历史会话列表

5.3 会话管理

/rename api-migration      # 给当前会话命名
/resume api-migration      # 按名称恢复会话

六、最佳实践

6.1 项目组织

project/
├── .claude/          # 配置目录
├── src/              # 源代码
├── tests/            # 测试代码
├── CLAUDE.md         # 项目配置
└── README.md

6.2 工作流

  1. 探索阶段 - 理解项目
  2. 规划阶段 - 使用 Plan 模式
  3. 编码阶段 - 实施计划
  4. 提交阶段 - 使用 commit skill

6.3 模型选择

任务类型推荐模型理由
简单查询DeepSeek-Coder极低成本
中文项目GLM-4.7中文理解最强
大型重构Kimi K2超长上下文 (2M+)
高质量要求Sonnet 4.5平衡性能

6.4 验证闭环

永远给 Claude 验证自己工作的方法，代码质量可提升 2-3 倍。

七、实战案例

  1. 批量文件重命名 - 拖拽文件夹后描述需求
  2. 自动化数据抓取 - 使用 Chrome DevTools MCP
  3. 代码质量审查 - 使用 code-reviewer agent
  4. 自动化测试生成 - 使用 test-writer agent
  5. CI/CD 集成 - GitHub Actions 自动审查

八、常见问题与解决方案

npm install 失败

# 使用 nvm (推荐)
nvm install --lts
npm install -g @anthropic-ai/claude-code

claude 命令未找到

export PATH=$(npm config get prefix)/bin:$PATH

上下文超出限制

/context
/compact "保留关键信息"
/clear

MCP 服务器无法连接

claude mcp test chrome-devtools

九、高级集成与扩展

9.1 LSP 集成

通过 LSP，Claude Code 达到 IDE 级别的代码理解能力：

  • 实时报错和警告
  • 跳转到定义
  • 查看类型信息

9.2 Agent SDK

用几十行代码构建自定义智能体。

总结

核心能力清单

  • ✅ Skills: 预封装的工作流
  • ✅ Hooks: 事件驱动的自动化
  • ✅ Plugins: 完整解决方案
  • ✅ MCP Servers: 外部服务集成
  • ✅ Subagents: 并行处理复杂任务
  • ✅ CLAUDE.md: 项目记忆系统
  • ✅ Plan 模式: 先规划后执行
  • ✅ Slash Commands: 复杂工作流一键执行

顶级开发者的秘诀

  1. 并行处理 - 效率提升可达 1900%+
  2. AI 进化 - 自动将教训写入 CLAUDE.md
  3. 验证闭环 - 代码质量提升 2-3 倍
  4. 选择合适工具 - 按任务选模型
  5. 先规划后执行 - 90% 时间使用 Plan 模式

本文整理自博客园文章

avatar
文章
阅读
粉丝