Claude 从入门到实战:一篇真正能用的完整教程

Claude 是 Anthropic 公司推出的大语言模型,擅长长文本、代码和复杂推理,在写作、编程、科研等场景表现突出。本教程将带你从零上手 Claude,掌握核心功能与实战技巧。

在这里插入图片描述

🧠 一、Claude 模型家族概览

1. 模型迭代路线

  • 2023年:初代 Claude 及 Claude 2 系列,主打长上下文(约100K token)。
  • 2024年:Claude 3 系列(Opus/Sonnet/Haiku),全面支持多模态,Opus 在多项基准上对标甚至超越 GPT-4。
  • 2025年:Claude 3.7 Sonnet 成为首款"混合推理模型";同年推出 Claude 4 系列(Opus 4 / Sonnet 4),支持连续工作数小时,并引入多智能体系统提升复杂任务性能。
  • 2026年:发布 Claude Sonnet 4.6 / Opus 4.6,提供完整的 100万 token 上下文窗口,并统一了输入/输出定价。

2. 当前主力模型对比 (4.x 系列)

模型 定位 适用场景 上下文窗口 相对价格 (输入/输出)
Opus 4.x 旗舰款,最强推理 复杂项目规划、科研、高难度代码重构 100万 token 较高 / 较高
Sonnet 4.x 主力款,性能均衡 日常编程、文档写作、多轮分析 100万 token 中等 / 中等
Haiku 4.x 极速款,成本最低 高频小任务、脚本生成、快速问答 100万 token 最低 / 最低

如何选择?

  • 日常主力:选 Sonnet 4.x,性价比最高。
  • 攻坚难题:选 Opus 4.x,推理深度更佳。
  • 高频轻量:选 Haiku 4.x,速度最快,成本最低。

3. 核心能力

  • 长上下文处理:支持百万级 token,能一次性处理数百页的文档或大型代码库。
  • 多模态理解:可分析图片、图表、UI截图、手绘草图等,并据此生成代码或解释说明。
  • 代码能力:支持代码生成、调试、重构、测试编写,对 TypeScript、Python、Java 等主流语言支持良好。
  • 工具使用 (MCP):可通过 MCP 协议连接外部工具(如数据库、API、浏览器),实现联网搜索、自动操作网页等高级功能。

🚀 二、如何注册与使用 Claude

1. 官方渠道 (适合有海外支付方式的用户)

  1. 访问 https://claude.ai,使用邮箱或 Google 账号注册。
  2. 按提示完成邮箱验证和手机号验证(建议使用海外号)。
  3. 登录后即可在网页端使用。可订阅 Claude Pro / Max 获取更高限额和 Claude Code 权益。

2. 国内直连 / 镜像站 (无需海外支付)

  • 优点:国内网络直接访问,支持微信/支付宝,无需折腾网络环境。
  • 缺点:价格可能有溢价,需自行评估服务商的隐私政策和稳定性。
  • 建议:选择运营时间长、有备案、支持合同发票的平台。

3. API 调用 (适合开发者)

  • 官方 API:在 console.anthropic.com 获取 API Key,通过 HTTP 接口调用。适合构建自己的应用或工具。
  • 第三方中转平台:提供兼容 OpenAI 格式的 API,设置 base_urlapi_key 即可接入。对国内用户更友好。

4. 多端入口

  • 网页端https://claude.ai
  • 移动端:官方 iOS / Android App
  • 桌面端:部分第三方打包的桌面客户端
  • 开发者工具Claude Code (终端/IDE 插件)

✨ 三、Claude 核心功能详解

1. 通用聊天与写作

  • 多轮对话:支持长时间、多轮次对话,能很好地保持上下文。
  • 内容创作:撰写文章大纲、润色文案、翻译、改写、头脑风暴等。
  • 学习与解释:解释复杂概念、推导公式、辅助学习外语。

2. 长文档与资料处理

  • 核心优势:得益于百万级 token 上下文,可一次性上传并分析整本书、长篇报告或整个代码仓库。
  • 典型用法
    • 总结数百页的文档或论文。
    • 对比不同版本的合同或需求文档。
    • 从大量材料中提取关键信息和数据。

3. 代码能力 (开发者重点)

  • 代码生成:根据需求生成函数、类、模块甚至整个项目脚手架。
  • 调试与修复:根据报错信息和代码片段,定位问题并提供修改建议。
  • 代码重构:执行跨文件、跨模块的重构任务,如抽取公共组件、优化设计模式。
  • 测试生成:为现有代码生成单元测试、集成测试,覆盖边界条件。

4. Artifacts 与 Projects

  • Artifacts:在对话旁生成一个独立的"作品区",适合展示代码、文档、图表等,便于迭代和导出。
  • Projects:将相关的对话、文档、Artifacts 组织在一起,形成项目知识库,适合长期跟踪一个项目。

5. 文件上传与多模态

  • 支持上传 PDF、Word、PPT、图片、代码压缩包等多种格式的文件进行分析和处理。
  • 结合多模态能力,可直接分析 UI 截图、手绘草图,并生成前端代码或操作指南。

6. Claude Code (终端/IDE 编程 Agent)

Claude Code 是一个能理解整个项目、直接修改代码并执行命令的终端 Agent,更像一位"实习生工程师"。

  • 安装方式

    • 脚本安装 (macOS/Linux/WSL):

      curl -fsSL https://claude.ai/install.sh | bash
      
    • NPM 安装:

      npm install -g @anthropic-ai/claude-code
      
  • 登录方式

    • 订阅账号:运行 claude 命令,在终端内完成浏览器登录。
    • API Key:设置 ANTHROPIC_API_KEY 环境变量后使用。
  • 常用命令

    claude                # 启动交互模式
    claude "fix error"    # 执行一次性任务
    /model               # 切换模型
    /compact             # 压缩对话上下文
    /clear               # 清空对话
    
  • IDE 集成:官方提供 VS Code 和 JetBrains 全家桶的插件,可在编辑器侧边栏直接使用 Claude Code 的功能。


🧩 四、Claude MCP 从入门到实战

1. MCP 是什么?

Model Context Protocol (MCP) 是 Anthropic 提出的一种开放标准,用于连接大语言模型与外部工具和数据源。你可以将其理解为 AI 的"USB-C"或"中枢神经系统",它让 Claude 能够:

  • 读写文件:访问本地或远程文件系统。
  • 调用 API:连接 GitHub、Jira、Notion、数据库等。
  • 执行操作:在浏览器中自动操作、抓取网页、运行测试等。

核心价值

  • 告别复制粘贴:Claude 直接在你的环境中操作,无需手动搬运上下文。
  • 统一工具生态:一套 MCP 配置,即可连接数百种服务,如数据库、监控、设计稿等。

2. 核心概念解析

作用域 (Scope)

MCP 配置按作用域划分,优先级从高到低为:local > project > user。同名服务器,高优先级会覆盖低优先级。

作用域 存储位置 适用场景
local ~/.claude.json 个人开发、实验性配置、敏感凭据。
project 项目根目录 .mcp.json 团队共享、项目特定工具,可纳入 Git 管理。
user ~/.claude.json 跨项目个人常用服务。
传输方式 (Transport)
  • stdio:通过标准输入输出与本地进程通信。安全、高效,适合访问本地文件、数据库等。(新手推荐)
  • http:通过 HTTP/HTTPS 与远程服务通信。适合对接云端 API、企业服务等。

新手口诀:本地用 stdio,远程用 http

MCP 服务器 (Server)

一个实现了 MCP 协议的程序,为 Claude 提供具体能力,如文件系统 (@modelcontextprotocol/server-filesystem)、GitHub (@modelcontextprotocol/server-github) 等。

3. 环境准备与安装

前提:已安装 Node.js ≥ 18 (确保 npx 可用)。

核心命令claude mcp add

参数说明

  • add <name>: 添加名为 <name> 的服务器。
  • -s, --scope <scope>: 指定作用域 (local/project/user)。
  • --transport <type>: 指定传输方式 (stdio/http)。
  • -e, --env KEY=VALUE: 设置环境变量 (如 API Key)。
  • --: 分隔符,其后的内容将作为子进程命令传递给 MCP 服务器。

4. 实战:配置 Filesystem MCP

以最常用的文件系统 MCP 为例,让 Claude 安全读写指定目录。

macOS / Linux

# 添加 User 作用域
claude mcp add filesystem -s user \
  --transport stdio \
  -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Desktop

# 添加 Project 作用域 (会生成 .mcp.json)
claude mcp add filesystem -s project \
  --transport stdio \
  -- npx -y @modelcontextprotocol/server-filesystem ./data

Windows (PowerShell)

# 添加 User 作用域
claude mcp add filesystem -s user `
  --transport stdio `
  -- cmd /c "npx -y @modelcontextprotocol/server-filesystem E:\claude"

# 添加 Project 作用域
claude mcp add filesystem -s project `
  --transport stdio `
  -- cmd /c "npx -y @modelcontextprotocol/server-filesystem E:\claude"

管理 MCP 服务器

# 列出所有服务器
claude mcp list

# 测试连接
claude mcp test filesystem

# 删除服务器
claude mcp remove filesystem -s user

在 Claude Code 中使用
配置成功后,直接在对话中下达自然语言指令:

  • “读取 E:\claude 目录下所有 .md 文件,并总结要点。”
  • “在 ./docs 目录新建 api.md,写入 API 设计规范。”
  • “修改 main.py 第 42 行的函数,增加异常处理。”

5. 常用 MCP 服务器推荐

分类 服务器名称 核心功能 安装示例
开发工具 filesystem 安全读写本地文件和目录。 -- npx -y @modelcontextprotocol/server-filesystem ~/projects
git 管理 Git 仓库(查看 diff, 创建分支, 提交 PR 等)。 -- npx -y @modelcontextprotocol/server-git
github 深度集成 GitHub API(管理 Issues, PRs, 仓库分析)。 -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github
playwright / puppeteer 浏览器自动化(UI 测试, 网页截图, 表单填写)。 -- npx -y @playwright/mcp
数据 & 搜索 postgresql / sqlite 查询和分析数据库(执行 SQL, 优化查询)。 -e POSTGRES_CONNECTION_STRING=... -- npx -y @modelcontextprotocol/server-postgres
brave-search / firecrawl 联网搜索 (Brave) 或高级网页抓取 (Firecrawl)。 -e BRAVE_API_KEY=xxx -- npx -y @modelcontextprotocol/server-brave-search
设计 & 协作 figma 读取 Figma 设计稿,辅助前端实现。 (参考官方或社区文档)
notion / slack / jira 集成 Notion, Slack, Jira 等,实现跨工具自动化。 --transport http notion https://mcp.notion.com/mcp

💻 五、Claude Code 实战技巧

1. Claude Code 是什么?

Claude Code 是 Anthropic 推出的终端/IDE 级 AI 编程助手,能直接在你的项目环境中工作:

  • 读取、修改项目文件。
  • 执行 Shell 命令和 Git 操作。
  • 通过 MCP 调用外部工具。

2. 启动与快捷操作

启动方式

# 交互模式
claude

# 带问题启动
claude "解释这个函数的作用"

# 管道输入
cat error.log | claude "分析报错"

# 一次性执行并打印
claude -p "生成 .gitignore 文件"

会话管理

# 继续上一次对话
claude -c

# 恢复指定会话
claude --resume

# 清屏
Ctrl+L

权限控制

  • Shift + TAB: 在当前对话中临时切换权限级别。
  • Shift + TAB (连按两次): 进入 Plan 模式,AI 只分析并提供计划,不执行操作。
  • --dangerously-skip-permissions: 生产环境严禁使用,会跳过所有权限确认。

3. 核心功能与实战工作流

代码审查 (/review)

在项目根目录运行 /review,Claude 会自动审查改动,指出潜在问题(如变量命名、异常处理、性能等),是提交 PR 前的有力助手。

文件引用 (@)

使用 @ 符号直接引用文件,无需复制粘贴代码。

@src/utils/auth.ts 这个鉴权逻辑有没有安全隐患?

项目说明书 (CLAUDE.md)

在项目根目录创建 CLAUDE.md 文件,Claude 会在每次启动时读取,从而理解项目规范,生成风格一致的代码。

# 项目概述
基于 Spring Boot + Vue3 的企业级低代码平台。

# 技术栈
- 后端:JeecgBoot 3.7, JDK 17, Maven
- 前端:Vue 3.4, Vite 5, Ant Design Vue 4
- 数据库:MySQL 8.0, Redis 7

# 开发规范
- 接口统一返回 `Result<T>` 格式。
- 异常处理使用全局 `@ExceptionHandler`。
- 所有 SQL 必须走 MyBatis-Plus,禁止手写原生 SQL。

# 注意事项
- 不要修改 `framework` 模块的代码。
- 所有日志统一使用 `logger` 对象。
记忆功能 (/memory)

使用 /memory 命令记录团队规范、API 端点等关键信息,Claude 会在后续对话中记住,实现团队知识的沉淀。

自定义命令

在项目下创建 .claude/commands/ 目录,放入 .md 文件即可注册自定义命令。例如,创建 .claude/commands/gen-api.md

根据以下接口描述,生成完整的 Controller、Service、Mapper 三层代码:
- 遵循项目的 REST 风格
- 包含 Swagger 注解
- 包含参数校验
- 生成对应的单元测试

接口描述:$ARGUMENTS

之后在对话中输入 /gen-api 用户积分查询接口,Claude 就会按模板生成代码。

4. 与 Git 结合的实战工作流

  1. 需求分析:向 Claude 描述新功能,让它提供实现方案和 API 设计。
  2. 生成代码:使用自定义命令(如 /gen-api)生成 Controller、Service 等桩代码。
  3. 本地验证:Claude 可协助编写单元测试,并提示你运行测试。
  4. 代码审查:提交前运行 /review,根据 Claude 的建议修改代码。
  5. 提交信息:让 Claude 根据改动生成符合 Conventional Commits 规范的提交信息。
  6. 迭代优化:后续需求变更时,直接让 Claude 在现有代码基础上修改。

✍️ 六、System Prompt 与自定义指令

1. System Prompt 的核心作用

System Prompt 是定义 Claude 行为模式的"系统指令",它决定了模型"是谁"、“能做什么"以及"如何表现”。在 API 调用中,它通常通过 system 参数传入。

2. 官方预设:claude_code

Claude Code SDK 提供了 claude_code 预设,它包含了完整的编码助手行为准则,如工具使用、代码风格、安全规范等。对于构建类似 Claude Code 的编码代理,建议以此为基础进行扩展。

3. 三种自定义方式对比

方式 适用场景 特点
claude_code 预设 构建 CLI/IDE 风格的编码工具。 提供完整的开箱即用体验,安全性高。
预设 + append 在官方预设基础上增加项目特定规则。 风险最低,不会覆盖官方的安全和功能指令。
完全自定义 构建非编码场景的专用 Agent(如客服、数据分析)。 灵活性最高,但需自行处理工具调用、安全等所有细节。

4. 万能 Prompt 框架

这是一个适用于 90% 专业任务的通用模板,你可以将其作为 System Prompt 或项目指令的基础:

# 角色
你是[职业身份],有[N年/特定]经验,擅长[核心专长]。

# 背景
[2-4句话描述任务背景和你的具体情况]

# 任务
[明确说明你需要什么,一件事说清楚]

# 格式要求
- 长度:[字数/段落数]
- 结构:[用列表/表格/标题/段落等]
- 风格:[正式/口语/专业/轻松]
- 输出格式:[Markdown/纯文本/JSON]

# 不要
- [列出你不想看到的内容特征]
- [列出禁止的表达方式]

# 参考示例(可选)
[如果有特定风格,粘贴1-2个例子]

# 思考要求(复杂任务可选)
在给出最终答案前,先[列举方案/分析利弊/提出关键问题]

5. 高级技巧

  • 思维链 (Chain of Thought):要求 Claude 先展示推理过程再给结论,能显著提升复杂问题的准确性。
  • Few-shot 示例:提供 1-3 个输入输出示例,引导 Claude 模仿特定的风格或格式。
  • XML 标签结构化:使用 <task>, <context>, <code> 等标签清晰划分输入,Claude 对此类结构响应良好。
  • 自我校验:让 Claude 生成内容后,立即审查其逻辑、安全性和完整性,并修正问题。

📊 七、Claude 与其他模型对比

1. 2026 年主流模型能力对比

模型 核心优势 适用场景
Claude 4.7 Opus 代码质量高,严谨性强,长文档理解能力出色。 核心业务逻辑、复杂代码重构、技术文档分析。
GPT-5.5 创意写作能力强,文案风格自然流畅,发散思维好。 营销文案、博客初稿、头脑风暴。
DeepSeek V4 成本极低,翻译质量接近顶级模型。 大批量翻译、数据清洗、摘要等"量大价低"的任务。
Gemini 2.5 Pro 多模态能力强,擅长分析图表、PDF 等复杂文档。 财报分析、图表解读、多模态内容理解。
通义千问 Max 中文理解地道,符合国内合规要求,易于接入。 国内业务、中文为主的场景、合规优先的项目。

2. 成本与性能考量

  • 延迟:Gemini 最快,Claude 和 GPT-5.5 次之。
  • 价格:DeepSeek V4 成本优势巨大,Claude 相对较高。

3. 实用选型策略

  • 代码/推理:首选 Claude 4.7 Opus / Sonnet 4.x
  • 内容创作:文案初稿用 GPT-5.5,再用 Claude 精修。
  • 翻译/批处理:主力使用 DeepSeek V4,关键部分用 Claude/GPT 抽检。
  • 长文档/多模态Gemini 2.5 Pro 表现突出。
  • 国内合规通义千问 Max 等国产模型是首选。

4. 多模型路由思路

在生产环境中,可以根据任务类型动态路由到不同的模型,以平衡成本与效果。

# 伪代码示例
def call_ai(task_type, messages):
    model_map = {
        "code": "claude-4.7-opus",
        "creative": "gpt-5.5",
        "translation": "deepseek-v4",
        "multimodal": "gemini-2.5-pro",
        "compliance": "qwen-max"
    }
    model = model_map.get(task_type, "claude-4.7-sonnet")
    # 调用对应模型的 API
    return call_api(model, messages)

🎯 八、实战案例

1. 学术论文写作

场景:需要分析 50 篇相关论文,撰写文献综述。
工作流

  1. 将所有 PDF 上传到 Claude。
  2. 指令:“分析这些论文,总结研究趋势、关键发现和方法论,输出 3000 字综述。”
  3. Claude 会提取每篇论文的核心观点,进行对比分析,生成结构化的综述。
  4. 根据反馈进行迭代修改。

2. 商业分析

场景:分析公司年度财报和竞争对手数据。
工作流

  1. 上传财报 PDF、Excel 数据表。
  2. 指令:“对比我们和主要竞争对手的营收、利润率、市场份额变化,指出关键差距和机会。”
  3. Claude 会从文档中提取关键数据,进行横向对比,生成分析报告。
  4. 可进一步要求生成 SWOT 分析或战略建议。

3. 前端开发

场景:根据设计稿实现 React 组件。
工作流

  1. 上传 Figma 设计稿截图。
  2. 指令:“根据设计稿生成对应的 React + Tailwind CSS 组件,包含响应式布局。”
  3. Claude 会分析设计稿的布局、颜色、间距等,生成可运行的代码。
  4. 通过 MCP 将代码直接写入项目文件。

4. 数据分析

场景:分析销售数据,找出趋势和异常。
工作流

  1. 通过 MCP 连接数据库或上传 CSV 文件。
  2. 指令:“分析销售数据,计算月度增长率,找出异常订单,生成可视化建议。”
  3. Claude 会执行 SQL 查询或处理 CSV,进行统计分析,提供洞察。
  4. 可要求生成 Python 代码用于后续自动化分析。

⚙️ 九、API 使用进阶

1. 流式输出

使用流式 API 可以实时获取 Claude 的响应,提升用户体验。

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

stream = client.messages.stream(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)

for event in stream:
    if event.type == "content_block_delta":
        print(event.delta.text, end="", flush=True)

2. 函数调用

Claude 支持工具调用(类似 OpenAI 的函数调用),可以集成外部 API。

tools = [{
    "name": "get_weather",
    "description": "获取指定城市的天气信息",
    "input_schema": {
        "type": "object",
        "properties": {
            "city": {"type": "string", "description": "城市名称"}
        },
        "required": ["city"]
    }
}]

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[{"role": "user", "content": "北京今天天气怎么样?"}],
    tools=tools
)

# 处理工具调用结果
if response.stop_reason == "tool_use":
    tool_call = response.content[0]
    if tool_call.name == "get_weather":
        weather = get_weather_api(tool_call.input["city"])
        # 将结果返回给 Claude 继续对话

3. Token 优化策略

  • 压缩上下文:对于长对话,定期使用 /compact 命令或手动总结关键信息。
  • 分块处理:超长文档分块上传,先让 Claude 了解整体结构。
  • 使用 Haiku 预处理:先用 Haiku 进行初步分析,再用 Opus 处理关键部分。
  • 缓存常用响应:对于重复性问题,缓存 Claude 的响应。

4. 错误处理与重试

import time
from anthropic import Anthropic, APIError

def call_claude_with_retry(messages, max_retries=3):
    client = Anthropic(api_key="your-api-key")
    
    for attempt in range(max_retries):
        try:
            response = client.messages.create(
                model="claude-3-5-sonnet-20241022",
                max_tokens=1024,
                messages=messages
            )
            return response
        except APIError as e:
            if e.status_code == 429:  # 速率限制
                wait_time = 2 ** attempt  # 指数退避
                time.sleep(wait_time)
            else:
                raise
    raise Exception(f"Failed after {max_retries} attempts")

🛡️ 十、常见问题与解决方案

1. 账号封禁与访问限制

原因

  • 使用 VPN 或代理访问官方服务
  • 短时间内大量请求
  • 违反使用条款

解决方案

  1. 使用合规渠道:选择国内镜像站或 API 中转平台
  2. 控制请求频率:添加延迟,避免突发大量请求
  3. 多账号轮换:对于高频率使用场景
  4. 联系客服:如果误封,提供使用场景说明

2. 额度管理

免费版限制

  • 对话次数/时间限制
  • 文件上传大小限制
  • 高峰期排队

优化策略

  1. 订阅 Pro/Max:获得更高额度
  2. 离线使用:对于非实时需求,先收集问题批量处理
  3. 使用 API:按需付费,更灵活
  4. 混合使用:免费版处理简单任务,复杂任务用付费版

3. 性能优化

响应慢

  • 切换到 Haiku 模型
  • 减少上下文长度
  • 使用流式输出

内存不足

  • 分块处理大文件
  • 定期清理对话历史
  • 使用 Projects 功能组织内容

4. 数据安全

敏感信息保护

  1. 本地处理:使用 Claude Code + MCP,数据不离开本地
  2. 脱敏处理:上传前移除敏感信息
  3. 使用私有化部署:企业级解决方案
  4. 定期审计:检查对话记录,删除敏感内容

🎯 十一、总结:如何选择与使用?

  • 普通用户:从 Claude.ai 免费版开始,体验聊天、写作和文档总结功能。
  • 开发者:重点使用 Claude CodeAPI,将其作为强大的编程助手,提升开发效率。
  • 国内用户:若访问官方不便,可选择合规的 国内镜像站API 中转平台作为替代方案。
  • 企业用户:考虑 私有化部署企业版 API,确保数据安全和合规性。

最佳实践

  1. 明确需求:清晰描述任务,提供充分上下文
  2. 分步执行:复杂任务分解为多个步骤
  3. 迭代优化:根据反馈不断改进结果
  4. 安全第一:保护敏感信息,遵守使用条款
  5. 成本控制:根据任务类型选择合适的模型和方案

Claude 作为当前最强大的 AI 助手之一,在代码、长文档、复杂推理等方面表现突出。通过本教程的学习,你应该能够充分利用 Claude 的各项功能,提升工作和学习效率。随着 AI 技术的快速发展,建议持续关注 Claude 的更新和新功能,保持学习状态。

更多推荐