登录立即选购
Claude Code 完整教程：从安装到 MCP 扩展的 35 个实战技巧（2026）
AI 工具教程教程入门18 分钟阅读
学习路径：Claude Code 从入门到实战

Claude Code 完整教程：从安装到 MCP 扩展的 35 个实战技巧（2026）

系统掌握 Claude Code 的完整路线：安装配置、CLAUDE.md 项目记忆、Plan Mode 规划编码、MCP 外部工具扩展、Hook 自动化，以及费用控制和常见问题排解。基于官方文档和社区 35 个高赞技巧整理，读完即可上手。

适合人群

  • 首次接触 Claude Code，需要一份从零开始的系统教程的开发者
  • 已在用 Claude Code，但感觉只用了"冰山一角"的工程师
  • 想了解 MCP（Model Context Protocol）如何让 Claude Code 连接外部工具的用户
  • 遇到过配置卡壳、费用失控、代码质量不稳定等问题的团队
  • 前端、后端、全栈以及 DevOps 工程师

准备清单

  • Node.js 18+ 环境（官方下载）
  • 一个 Anthropic 账号（console.anthropic.com）
  • 基本的终端操作能力
  • 了解 npm/npx 基本用法
  • 建议：macOS 或 Linux 环境（Windows 用户需安装 WSL2）

前言：为什么你需要这份教程

Claude Code 是 Anthropic 推出的终端原生 AI 编程助手。它不是 VS Code 插件，也不是浏览器里的聊天框——它在命令行里运行，能读取整个代码库、写代码、跑测试、提 PR，是一个真正的 AI Agent。

2026 年 4 月，开发者 Khairallah AL-Awady 发布了一条整理了 35 个 Claude Code 实战技巧的推文，获得了超过 490 万次曝光，登上 AttentionVC 排行榜第 2 名。这些技巧覆盖了从上下文管理到 MCP 扩展再到 Hook 自动化的方方面面。

本文结合官方文档和社区经验，把这些零散的知识串成一条完整路线——从安装配置到高级技巧，读完就能上手。

安装与基础配置

1. 安装 Claude Code

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

安装完成后，终端输入 claude 即可启动。首次运行会引导你登录 Anthropic 账号并完成授权。

2. 验证安装

claude --version
# 输出版本号即安装成功

3. 配置 API 密钥

Claude Code 支持两种计费方式：

  • API Key 模式：绑定 Anthropic API Key，按 Token 用量计费，灵活可控
  • 订阅模式：通过 Claude Pro 订阅使用，独享 Opus 4.7 等全系最强模型，适合高频用户

💡 想要更省心的体验？Claude Pro 月卡 提供官方合规渠道直充，极速激活，无需自己管理 API Key 和账单。

推荐 API Key 模式起步：

# 设置 API Key（首次登录会自动引导，也可手动设置）
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxx

# 查看当前对话的 Token 消耗
claude /cost

4. 初始化项目

在项目根目录启动：

cd your-project
claude

进入交互界面后，第一件事执行 /init：

# 在 Claude Code 对话中输入
/init

这条命令会扫描代码库并生成 CLAUDE.md 文件——Claude Code 的"项目记忆"。每次启动都会自动读取，包含项目结构、技术栈、编码规范、架构决策等关键上下文。

大多数开发者装完 Claude Code 后只做基础代码生成，发挥了不到 20% 的能力。剩下的 80%——那些让 Claude Code 从"能用"变成"最好用的开发工具"的技巧——藏在文档和社区讨论里。

5. CLAUDE.md 高级配置

CLAUDE.md 是纯 Markdown 文件，你可以手动编辑来定制行为。下面是一个实际项目的配置示例：

# CLAUDE.md

## 项目概览
这是一个 Next.js 15 + Prisma + PostgreSQL 的全栈项目。

## 编码规范
- 使用 TypeScript 严格模式
- 所有公开函数必须写 JSDoc 注释
- React 组件使用函数组件 + hooks
- API 路由遵循 /src/app/api/* 结构
- 数据库查询使用 Prisma 的 Repository 模式

## 测试要求
- 修改 /src/core 下的文件后必须跑测试
- 新增功能必须有单元测试

## 架构约定
- 页面组件放在 /src/app/ 下
- 业务逻辑放在 /src/lib/services/ 下
- 类型定义放在 /src/types/ 下

配置好之后，Claude Code 会自动遵循这些规则，无需每次对话重复说明。

基础使用技巧

Plan Mode — 先规划后编码

这是最容易被忽略的功能。在对话中按 Shift+Tab，Claude Code 进入计划模式——只分析架构、输出方案，不写任何代码。你审查通过后再切回实现模式。

你：帮我实现用户权限管理

[按 Shift+Tab 进入计划模式]
Claude Code 会：
1. 分析当前代码库的架构
2. 提出权限管理的最佳方案
3. 列出涉及的文件和变更范围

[你批准后，切回普通模式开始实现]

这个习惯比任何技巧都能预防更多 bug。

/compact — 压缩上下文

对话进行 30-45 分钟后，上下文会变得臃肿。输入 /compact 可以将对话历史压缩为聚焦的摘要，只保留关键决策和当前状态，防止 Claude Code "遗忘"之前的讨论。

/clear — 每个功能独立会话

开始新任务时彻底清空对话。把数据库重构的上下文带到前端重构里，会产生混乱矛盾的代码。一个对话只做一件事。

/memory — 持久化规则

添加在所有对话中自动生效的规则：

/memory
"始终使用 TypeScript 严格模式"
"始终为公开函数添加 JSDoc 注释"
"修改 /src/core 下的文件后必须运行测试"

/cost — 监控 Token 消耗

/cost

显示当前对话的 Token 使用量。长对话中建议每小时检查一次。AI 辅助开发要花钱，意外账单从来不好玩。

! 前缀 — 终端集成

在消息前加 !，直接作为终端命令执行，无需离开 Claude Code：

!git status    # 查看 git 状态
!npm test      # 运行测试

MCP 配置扩展

什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 推出的开放协议，让 AI 模型能安全地连接外部工具和数据源。

打个比方：MCP 就是 Claude Code 的"USB 接口"。没有 MCP，它只能操作本地文件和终端。有了 MCP，它可以连接数据库、调用 API、操作浏览器、查询 GitHub。

配置文件位置

# 全局配置（所有项目生效）
~/.claude/settings.json

# 项目级配置（仅当前项目）
.claude/settings.json

项目级配置会覆盖全局配置。

命令行添加 MCP Server（推荐方式）

# 添加 GitHub MCP Server
claude mcp add github -s user -- npx -y @modelcontextprotocol/server-github

# 添加 PostgreSQL MCP Server
claude mcp add postgres -s user -- npx -y @modelcontextprotocol/server-postgres postgresql://user:pass@localhost:5432/dbname

# 添加 Brave Search（需 API Key）
claude mcp add brave-search -s user -e BRAVE_API_KEY=xxx -- npx -y @modelcontextprotocol/server-brave-search

# 添加文件系统 MCP
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem /home/user/projects

# 查看已配置的 MCP Server
claude mcp list

手动 JSON 配置

适合批量管理或需要精细控制的场景。在 ~/.claude/settings.json 中写入：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"],
      "env": {}
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_your_key_here"
      }
    },
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    }
  }
}

常用 MCP Server 推荐

MCP Server 功能 安装命令
GitHub PR/Issue/仓库管理 npx -y @modelcontextprotocol/server-github
Filesystem 文件系统操作 npx -y @modelcontextprotocol/server-filesystem /path
PostgreSQL 数据库查询 npx -y @modelcontextprotocol/server-postgres <连接字符串>
Brave Search 网络搜索 npx -y @modelcontextprotocol/server-brave-search
Fetch 网页抓取 npx -y @modelcontextprotocol/server-fetch
Memory 知识图谱记忆 npx -y @modelcontextprotocol/server-memory
Puppeteer 浏览器自动化 npx -y @modelcontextprotocol/server-puppeteer
Docker 容器管理 npx -y @modelcontextprotocol/server-docker
Sequential Thinking 深度推理链 npx -y @modelcontextprotocol/server-sequential-thinking

MCP 授权管理

# 查看 MCP 工具授权状态
claude config get mcpApprovedTools

# 重置所有授权（需要重新审批）
claude config set mcpApprovedTools {}

# 列出所有 MCP Server
claude mcp list

# 删除某个 Server
claude mcp remove github

高效编码工作流

引用文件法

与其口头描述想要的代码风格，不如直接指向一个已有文件：

"看看 src/auth/login.ts 中认证是怎么实现的。按照完全相同的模式实现密码重置功能。"

Claude Code 会读取参考文件并精确复制其中的模式，比口头描述一致得多。

截图调试

UI 有问题？不要写文字描述——直接截图，按 Ctrl+V 粘贴，然后说：

"按钮和输入框没有对齐。卡片之间的间距不一致。修复这两个问题。"

视觉反馈比文字描述更快、更准确。

测试先行工作流

先让 Claude Code 写测试，再写实现：

"为折扣价格计算函数编写测试。覆盖：正常折扣、零折扣、100%折扣、负数价格和字符串输入。然后实现函数让所有测试通过。"

测试在代码存在之前就定义了行为，实现自然就是正确的。

增量构建法

不要说"把整个功能做出来"。拆成小步骤：

  1. "创建数据库 schema。" → 测试
  2. "构建 API 端点。" → 测试
  3. "添加验证逻辑。" → 测试
  4. "构建前端表单。" → 测试

五步小迭代，每步中间做测试，效果远胜一个大提示词。

代码库提问

在不熟悉的代码库中做任何事之前，先问清楚：

"阅读 src/services/，解释数据如何从 API 路由流向数据库。使用了什么模式？修改这里之前我需要知道什么？"

理解了再动手，防止架构性错误。

差异审查

Claude Code 修改完代码后，让它展示所有变更：

"显示你修改的每个文件的 diff。用一句话解释每个变更。"

这能捕获意外的修改——Claude Code 有时会"好心"地改你没让它碰的文件。

错误粘贴法

出问题时，复制完整的错误信息和堆栈跟踪，不是摘要：

"我收到了这个错误：[粘贴完整错误]。一步步诊断根本原因，再建议修复方案。"

"一步步诊断"这个约束防止 Claude Code 跳到错误的结论。

撤销检查点

每次重大变更之前，先打个 Git 快照：

git add . && git commit -m "checkpoint before [变更说明]"

如果 Claude Code 搞坏了什么，几秒钟就能回退。

并行对话

对于大型功能，开两个终端窗口：一个跑后端，一个跑前端。每个对话聚焦一个领域，最后再拼合。

架构与代码质量

架构审计

新项目开始前，让 Claude Code 帮你做架构选型：

"分析我的项目需求：[列出需求]。提出 2 种不同的架构方案。每种方案包括：组件图、优缺点、预估复杂度、可能出什么问题。推荐一个并给出明确理由。"

AI 辅助的架构决策可以避免后期昂贵的重构。

依赖检查

添加任何新包之前：

"我想加 [package] 来处理 [用例]。检查：这个包是否活跃维护？有没有已知安全问题？包体积多大？有没有更轻量的替代方案？"

防止项目被不必要的或危险的依赖撑爆。

模式强制执行

在 CLAUDE.md 中添加模式模板：

## 模式模板
- API 路由遵循 src/api/example-route.ts 的结构
- 数据库查询使用 src/repositories/ 中的 Repository 模式
- React 组件遵循 src/components/ExampleComponent.tsx 的结构

Claude Code 读取后，会自动在每个新文件中匹配这些模式。

安全扫描

"扫描这个代码库的安全漏洞：SQL注入、XSS、暴露的密钥、缺少输入验证、不安全的直接对象引用、缺少速率限制。每个发现需标注严重程度、位置、原因和修复方案。"

性能分析

"分析代码库的性能问题：N+1 数据库查询、缺失索引、React 不必要重渲染、可懒加载的大包导入、应缓存的 API 端点。按预估影响排序。"

Hook 系统与自动化

Claude Code 提供 Hook 系统——在特定生命周期事件触发时自动执行脚本。

主要 Hook 类型

Hook 触发时机 典型用途
preToolCall 调用任何工具前 权限检查、日志记录
postToolCall 调用任何工具后 结果验证、通知
preConversation 对话开始前 加载上下文
postConversation 对话结束后 自动提交、摘要

配置 Hook

在项目根目录创建 .claude/hooks/ 目录，放入可执行脚本：

#!/bin/bash
# .claude/hooks/preToolCall/pre-commit-check.sh
# 在 Claude 执行 git commit 前自动运行 lint
if [[ "$TOOL_NAME" == "bash" ]] && [[ "$TOOL_INPUT" == *"git commit"* ]]; then
  npm run lint || exit 1
fi

Hook 系统让 Claude Code 的行为可编程，可以用来实现自动代码审查、权限控制、CI 触发等。

Git Hook 自动化

"创建 pre-commit hook，功能：在暂存文件上运行 linter、运行类型检查、检查生产代码中的 console.log、阻止未通过检查的提交。安装到 .husky/pre-commit。"

CI 流水线构建

"创建 GitHub Actions 工作流：每个 PR 触发、安装依赖、运行完整测试套件、运行 linter、构建项目、在 PR 上发布结果评论。使用 node_modules 缓存。"

环境一键配置脚本

"创建 setup.sh，新开发者运行一次就能设置整个开发环境：安装依赖、从 .env.example 创建 .env、设置本地数据库、运行迁移、填充测试数据、运行测试套件验证一切正常。"

常见问题

Q: 国内用户如何使用 Claude Code？

Claude Code 需要连接 Anthropic 的 API。国内用户可以配置代理或使用海外服务器。推荐方案：在海外 VPS 上运行 Claude Code，或者通过本地代理工具设置 HTTP_PROXY 环境变量。更详细的网络配置可以参考 MCP 配置完整教程。

Q: Claude Code 费用高吗？如何控制？

Claude Code 按 Token 计费。Opus 模型较贵（约 $15/百万输入 Token），Sonnet 较便宜（约 $3/百万输入 Token）。控制费用的方法：1) 长对话中定期 /compact 压缩上下文；2) 用 /cost 监控消耗；3) 规划用 Opus，实现用 Sonnet；4) 每次新功能用 /clear 清空对话。如果不想频繁操心 API 计费，也可以考虑 Claude Pro 订阅，按月付费无额外 Token 费用。详细策略参考 Claude Code 成本优化指南。

Q: 如何让 Claude Code 更懂我的项目？

三个层面：1) CLAUDE.md — 项目级上下文文档，包含技术栈、架构规范、编码风格；2) /memory 命令 — 跨项目的全局记忆规则；3) MCP Memory Server — 长期知识图谱。建议从 /init 生成 CLAUDE.md 开始，逐步完善。

Q: MCP Server 启动失败怎么办？

常见原因：Node.js 版本低于 18、npx 不在 PATH 中、网络无法下载包。排查步骤：node --version 检查版本；which npx 确认路径；内网环境设置 npm 镜像 npm config set registry https://registry.npmmirror.com/。也可用 claude mcp get <server-name> 查看详细配置。

Q: Claude Code 和 Cursor、GitHub Copilot 有什么区别？

Claude Code 是终端原生 AI Agent，能完整操作代码库——读、写、跑命令、提 PR。Cursor 是基于 VS Code 的 IDE 集成。GitHub Copilot 是编辑器内补全。Claude Code 独特之处：1) 不局限于编辑器，可在整个系统操作；2) 支持 MCP 协议扩展；3) Hook 系统可编程。更多对比参考 Cursor AI 编程终极指南。

Q: Claude Code 生成了错误代码怎么办？

使用"恢复模式"：当来回修改很久仍有问题，说："停。从 git 读取这个文件最初的工作版本：[粘贴 git show 输出]。现在看我们要达成的目标：[简述]。用不同方法重新开始。之前的方法行不通。" 有时从干净状态重启比修复累积错误更快。

日常启动流程

每次开始新项目时的推荐步骤：

  1. /init — 生成 CLAUDE.md 文件
  2. 编辑 CLAUDE.md — 添加你的编码规范和模式
  3. /memory — 添加想在每个对话中生效的持久规则
  4. Plan Mode（Shift+Tab）— 写代码之前先设计架构
  5. 增量构建 — 一次一个功能，每步都测试

这五分钟的设置会改变你后续每一小时的开发体验。

参考来源

下一步建议

100% 官方正规渠道，支持全天候自动交付。我们为您提供安全、稳定且全程质保的全球数字订阅体验。

安全支付认证正版授权保障24小时自动发货优质售后服务

官方正品保障 | 全自动秒发货 | 隐私加密交易 | 专属售后工单

学习中心工单