claude code学习路径

软件工程师
AI编程
Author

jdragon

Published

February 2, 2026

Claude Code 完整学习路径

从零基础到专家级,掌握 Anthropic 官方 AI 编程助手的完整指南


目录


序言:为什么是 Claude Code

什么是 Claude Code

Claude Code 是 Anthropic 官方推出的 AI 编程助手(AI Coding Assistant),直接在终端中运行,帮助开发者通过自然语言交互完成软件工程任务。它能够理解整个代码库、执行多步骤任务,并在复杂项目中保持上下文连贯性。

简单来说,Claude Code 是你终端里的「AI 结对编程伙伴」——通过对话就能让它分析代码、实现功能、修复 Bug、重构项目,甚至完成完整的端到端开发任务。

使用 Claude Code 的好处

1. 显著提升开发效率

  • 秒懂陌生代码库:几分钟内理解项目结构和核心逻辑,无需逐行阅读
  • 自然语言编程:用日常语言描述需求,AI 自动生成高质量代码
  • 智能重构:安全地重构代码,提升可维护性而不破坏功能
  • 快速 Debug:系统化定位问题根因,提供修复建议

2. 降低认知负担

  • 一站式开发:无需在编辑器、文档、搜索引擎间频繁切换
  • 上下文记忆:AI 自动记住项目细节,无需重复说明背景
  • 全流程覆盖:从需求分析到测试验证,一个界面完成

3. 提升代码质量

  • 实时最佳实践建议:内置丰富的编码规范和设计模式
  • 持续代码审查:AI 即时发现问题并提供改进建议
  • 自动化测试生成:根据代码逻辑生成全面的测试用例

4. 支持团队协作

  • 知识沉淀:通过 CLAUDE.md 固化项目规范和架构知识
  • 新人快速上手:新成员通过 Claude Code 快速理解项目
  • 一致的工作流:团队共享配置,统一开发方式

Claude Code 的核心优势

1. 原生 Claude 模型集成

Claude Code 深度集成 Anthropic 的 Claude 系列模型:

模型 推荐场景 特点
Claude 4 Opus 复杂架构设计、深度分析 最强推理能力,适合高难度任务
Claude 4 Sonnet 日常开发、代码审查 平衡性能与成本,响应快速
Claude 3.5 Sonnet 快速原型、简单任务 高性价比,适合常规开发

优势:专为 Claude 模型优化的交互体验,充分发挥模型潜力。

2. Plan 模式工作流

Claude Code 支持 Plan Mode(规划模式)

  • Plan 模式:只读分析,适合代码理解、方案设计、架构规划
  • 执行模式:读写执行,适合功能实现、Bug 修复、代码重构

优势:避免 AI 贸然修改代码,先规划再动手,大幅降低返工率。

3. 深度代码库理解

Claude Code 能够:

  • 分析整个项目的架构和依赖关系
  • 追踪跨文件的函数调用和数据流
  • 理解复杂的设计模式和业务逻辑
  • 在大型代码库中保持上下文连贯

优势:专业级的代码理解能力,如同资深工程师在指导工作。

4. 丰富的扩展生态

  • Skills 系统:从 skills.sh 安装专业领域技能包
  • 自定义 Commands:创建一键触发的自定义命令
  • MCP 集成:连接外部工具和服务
  • IDE 扩展:支持 VS Code、JetBrains 等主流编辑器

优势:生态丰富,可根据需求灵活扩展功能。

5. 官方品质保障

作为 Anthropic 官方产品:

  • 与 Claude 模型同步更新,始终使用最新能力
  • 官方技术支持和服务保障
  • 企业级安全和隐私保护
  • 持续迭代和功能增强

优势:官方背书,稳定可靠,长期支持有保障。

6. 多平台支持

  • 终端:原生 CLI 体验
  • Web 版:浏览器中直接使用
  • 桌面版:独立应用程序
  • IDE 插件:VS Code、JetBrains 集成

优势:随时随地,选择最适合你的工作方式。

Claude Code vs OpenCode:如何选择

OpenCode 是开源的 AI 编程工具,与 Claude Code 有许多相似之处。以下是两者的对比:

功能对比

特性 Claude Code OpenCode
模型支持 仅 Claude 系列(深度优化) 多模型(Claude、GPT、DeepSeek、GLM 等)
费用 Claude Pro/API 订阅 自主选择模型,灵活控制成本
国内访问 需要网络配置 支持国产模型直连
开源 闭源,官方维护 完全开源,可自由定制
官方支持 Anthropic 官方支持 社区驱动
集成深度 与 Claude 模型深度集成 通用接口,适配多种模型
Skills 生态 支持 skills.sh 生态 同样支持 skills.sh
企业功能 企业版完善 社区版本

适用场景建议

选择 Claude Code,如果你:

  • 信任 Anthropic 的 Claude 模型能力
  • 需要官方直接支持和服务保障
  • 追求与 Claude 模型的最佳集成体验
  • 企业环境需要合规和安全保障
  • 愿意为官方品质支付相应费用

选择 OpenCode,如果你:

  • 希望灵活切换多种 AI 模型
  • 需要国产模型直连,不想折腾网络
  • 重视开源,希望深度定制工具
  • 希望灵活控制成本和模型选择
  • 是中文用户,需要本地化支持

两者并非对立

实际上两者可以互补:

  • Claude Code 适合:对代码质量要求高、需要官方支持的场景
  • OpenCode 适合:需要灵活性、多模型对比、深度定制的场景
  • 技能互通:skills.sh 上的 Skill 可以在两者中使用
  • 学习成本复用:Plan/Build 工作流概念相通

谁适合使用 Claude Code

开发者

  • 全栈工程师:快速实现功能,端到端开发
  • 前端开发者:UI/UX 实现、组件库开发
  • 后端工程师:API 开发、数据库设计、系统架构
  • 算法工程师:算法实现、数据分析、模型部署

技术管理者

  • 架构师:系统设计、技术决策、代码审查
  • 技术负责人:团队规范、项目初始化、质量管控
  • CTO/VP:技术选型、团队效率、知识沉淀

其他技术人员

  • DevOps 工程师:CI/CD、自动化脚本、基础设施
  • 数据工程师:数据处理、ETL、报表生成
  • 产品经理:快速原型、需求验证
  • 技术写作者:文档编写、教程制作

学习路径概述

本文档分为三个部分,循序渐进地帮助你掌握 Claude Code:

第一部分:初级篇 - 快速上手

  • 安装配置、基础操作、基础工作流
  • 目标:能在日常开发中使用 Claude Code 辅助工作

第二部分:进阶篇 - 效率提升

  • 高级功能、Skills 系统、自动化工作流、定制配置
  • 目标:掌握高级工作流,显著提升开发效率

第三部分:高级篇 - 专家级别

  • 高级定制、团队配置、企业级工作流
  • 目标:深度定制 Claude Code,构建团队级解决方案

预计学习时间:2-4 周(视个人基础和投入时间而定)

开始之前

使用 Claude Code 需要:

  • 基本的终端/命令行操作知识
  • 一定的编程基础(至少一种编程语言)
  • Anthropic API Key(或 Claude Pro 订阅)
  • 开放的心态,愿意尝试新的工作方式

不需要

  • 深厚的 AI 知识(Claude Code 帮你封装了复杂性)
  • 昂贵的硬件(普通电脑即可运行)
  • 复杂的配置(开箱即用)

准备好了吗?让我们开始这段学习旅程!


第一部分:初级篇

目标:30 分钟内完成安装并成功对话,掌握基础操作和日常开发流程


第 1 章:安装与起步

学习目标

  • 理解 Claude Code 是什么以及能做什么
  • 成功安装 Claude Code 且不报错
  • 完成 Anthropic 认证配置
  • 完成第一次 “Hello World” 对话

学习内容

1.1 Claude Code 简介

Claude Code 是一款 AI 编程助手,能够:

  • 理解代码并辅助开发
  • 自动完成文件操作和代码重构
  • 执行终端命令并分析输出
  • 提供 Plan 模式进行方案设计
  • 通过 Skills 扩展专业能力

1.2 安装步骤

方式一:npm 安装(推荐)

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

# 验证安装
claude --version

方式二:Homebrew 安装(macOS)

# 添加 Anthropic tap
brew tap anthropic/claude

# 安装 Claude Code
brew install claude-code

方式三:下载二进制文件

访问 Claude Code 发布页面 下载对应平台的二进制文件。

1.3 认证配置

获取 API Key

  1. 访问 Anthropic Console
  2. 注册/登录账户
  3. 创建 API Key
  4. 新用户可获得免费试用额度

配置认证

# 方式一:使用登录命令
claude auth login

# 方式二:环境变量
export ANTHROPIC_API_KEY="your-api-key-here"

# 方式三:配置文件
# 编辑 ~/.claude/settings.json
{
  "anthropicApiKey": "your-api-key-here"
}

1.4 第一次对话

# 进入项目目录
cd ~/my-project

# 启动 Claude Code
claude

# 输入测试
你好,请介绍一下你自己

Claude Code 会自动

  • 分析当前目录的项目结构
  • 识别技术栈和框架
  • 读取已有的 CLAUDE.md(如果存在)

练习题目

  1. 安装验证:运行 claude --version,确认安装成功
  2. 认证配置:完成 API Key 配置并成功认证
  3. 首次对话:成功发送 “Hello World” 并收到回复
  4. 项目分析:进入一个项目目录,观察 Claude Code 如何识别项目

参考资料


第 2 章:基础操作

学习目标

  • 熟悉 Claude Code 的界面和核心操作
  • 掌握 @! 语法
  • 学会使用斜杠命令
  • 了解 Plan 模式的切换

学习内容

2.1 界面导览

Claude Code 采用简洁的终端界面:

  • 对话区域:显示用户输入和 Claude 回复
  • 输入框:底部输入命令或问题
  • 状态指示:显示当前模式、上下文信息

2.2 核心语法

@ - 引用文件/代码

@src/main.ts 请分析这个文件
@src/utils.ts#L10-20 解释这几行代码
@README.md 总结文档内容

! - 执行命令

!npm install
!git status
!python test.py

Claude Code 会自动

  • 执行命令并获取输出
  • 分析命令结果
  • 根据输出继续对话

2.3 斜杠命令

Claude Code 支持丰富的斜杠命令:

命令 功能
/help 显示帮助信息
/clear 清空对话历史
/new 新建对话会话
/plan 切换到 Plan 模式
/exit 退出 Claude Code

使用示例

/plan 我要添加用户认证功能,请先帮我设计方案

2.4 Plan 模式详解

什么是 Plan 模式

  • 只读分析模式,不会修改文件
  • 适合代码理解、方案设计、架构规划
  • 避免 AI 贸然修改代码

如何进入 Plan 模式

/plan

Plan 模式使用场景

  • 理解陌生代码库
  • 设计新功能方案
  • 代码审查和分析
  • 技术决策讨论

练习题目

  1. 文件引用练习:使用 @文件名 引用项目中的文件并提问
  2. 命令执行练习:使用 !命令 执行一个简单的 bash 命令
  3. Plan 模式练习:切换到 Plan 模式分析项目结构
  4. 斜杠命令练习:尝试 /help/clear 命令

参考资料


第 3 章:基础工作流

学习目标

  • 理解 Plan 模式和工作模式的区别
  • 掌握标准开发流程
  • 学会创建和编辑 CLAUDE.md
  • 能够在日常开发中运用 Claude Code

学习内容

3.1 Plan 模式 vs 工作模式

Plan 模式(规划模式)

  • 特点:只读分析,不会修改文件
  • 用途:代码理解、方案设计、架构规划
  • 触发方式:输入 /plan 或在提示中明确要求规划

工作模式(默认)

  • 特点:可以读写文件、执行命令
  • 用途:功能实现、Bug 修复、代码重构
  • 触发方式:直接输入需求

工作流建议

理解代码(Plan) → 制定方案(Plan) → 实现功能(工作模式) → 验证测试

3.2 标准开发工作流

步骤详解

  1. 理解代码(Plan 模式):

    /plan 请帮我梳理项目结构,分析主要模块和依赖关系
  2. 制定方案(Plan 模式):

    /plan 我要添加 XX 功能,请帮我分析:
    1. 需要修改哪些文件
    2. 推荐的实现方案
    3. 每种方案的优缺点
  3. 实现功能(工作模式):

    按照方案一实现功能,第一步先创建 XX 文件
  4. 验证测试(工作模式):

    !npm test
    请分析测试结果,如果有失败请修复

3.3 CLAUDE.md 配置

什么是 CLAUDE.md

  • 项目级的 Claude Code 配置文件
  • 位于项目根目录
  • 自动被 Claude Code 读取作为上下文

创建 CLAUDE.md

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目概述
- 项目名称:XXX
- 技术栈:React + TypeScript + Node.js
- 项目目标:简短描述

## 常用命令
- `npm run dev`:启动开发服务器
- `npm test`:运行测试
- `npm run build`:构建项目
- `npm run lint`:代码检查

## 代码规范
- 使用 2 空格缩进
- 变量使用 camelCase
- 优先使用函数组件

## 架构说明
- 前端:React + TailwindCSS
- 后端:Express.js
- 数据库:PostgreSQL

自动生成 CLAUDE.md

请分析这个代码库并创建一个 CLAUDE.md 文件,包含:
1. 常用命令(构建、测试、开发)
2. 项目架构和关键概念
3. 代码规范

3.4 文件操作技巧

读取文件

@README.md 请总结这个文档

分析多个文件

请分析 src/components 目录下的所有组件文件

搜索内容

搜索包含 "auth" 的所有文件,分析认证逻辑

练习题目

  1. 模式切换练习:在 Plan 模式和工作模式间切换
  2. 项目分析练习:用 Plan 模式分析项目结构,理解代码
  3. 功能实现练习:用 Plan → 工作模式流程实现一个小功能
  4. CLAUDE.md 练习:为你的项目创建一份 CLAUDE.md

参考资料


第二部分:进阶篇

目标:掌握 Claude Code 高级功能、Skills 系统、自动化工作流和定制配置


第 4 章:高级功能与技巧

学习目标

  • 掌握 Claude Code 的高级使用技巧
  • 学会使用 context 和记忆功能
  • 理解 Claude Code 的代码分析能力
  • 掌握多文件编辑技巧

学习内容

4.1 高级使用技巧

精准代码引用

@src/utils.ts#L10-20 请解释这段代码的逻辑

批量文件分析

分析 src/services 目录下的所有文件,总结服务层架构

上下文保持

  • Claude Code 会自动保持对话上下文
  • 在长对话中定期总结关键信息
  • 使用 /new 开启新对话重置上下文

4.2 代码分析与重构

代码审查

请审查 @src/auth.ts,检查:
1. 安全性问题
2. 代码风格
3. 性能优化建议

重构建议

请重构 @src/utils.ts:
1. 提取重复代码
2. 优化函数命名
3. 添加类型定义

4.3 调试技巧

错误分析

运行 !npm test 失败,请分析错误日志并修复问题

性能分析

分析 @src/database.ts 的数据库查询,找出性能瓶颈

4.4 Web 版和桌面版

Claude Code Web

  • 访问 claude.ai/code 使用浏览器版本
  • 无需安装,即开即用
  • 适合临时使用或无法安装 CLI 的场景

Claude Code Desktop

  • 独立的桌面应用程序
  • 更好的性能和体验
  • 支持语音交互(Voice Mode)

练习题目

  1. 代码审查练习:对项目中的一个模块进行完整代码审查
  2. 重构练习:重构一段遗留代码,提升可读性和性能
  3. 调试练习:故意引入一个 Bug,让 Claude Code 帮你定位和修复
  4. Web 版体验:尝试使用 Claude Code Web 版完成简单任务

参考资料


第 5 章:Skills 系统

学习目标

  • 理解 Skills 的概念和价值
  • 学会从 skills.sh 安装 Skills
  • 掌握常用 Skills 的使用
  • 了解 Skill-creator 工具

学习内容

5.1 Skills 简介

什么是 Skills

  • Skills 是封装复杂指令的模块
  • 提供专业领域知识和最佳实践
  • 扩展 Claude Code 的能力边界

Skills 生态系统

  • 官方仓库:skills.sh
  • 社区贡献的各类专业技能包
  • 支持 Claude Code、OpenCode、Cursor 等工具

5.2 安装 Skills

安装方式

# 安装 skill-creator(创建 Skill 的工具)
npx skills add https://github.com/anthropics/skills --skill skill-creator

# 安装 remotion-best-practices(视频开发)
npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices

# 安装 superpowers 系列
npx skills add https://github.com/obra/superpowers --skill brainstorming
npx skills add https://github.com/obra/superpowers --skill systematic-debugging

5.3 常用 Skills 介绍

1. skill-creator(Anthropic 官方)

  • 指导如何创建有效的 Skills
  • 包含设计原则和最佳实践
  • 使用场景:创建自定义 Skill 时

2. superpowers 系列(obra)

14 个开发工作流增强 Skill:

Skill 用途
brainstorming 创意工作前的头脑风暴
systematic-debugging 系统化调试
test-driven-development 测试驱动开发
writing-plans 编写实施计划
requesting-code-review 请求代码审查
verification-before-completion 完成前验证

3. remotion-best-practices(Remotion 团队)

  • React 视频开发的最佳实践
  • 动画、音频、转场等专业指导
  • 周安装量 58.7K

4. 其他常用 Skills

Skill 用途
git-master Git 操作专家
frontend-ui-ux UI/UX 设计能力
pdf PDF 操作
docx Word 文档处理
pptx PPT 制作

5.4 使用 Skills

Skill 触发方式

  • Skills 会根据对话内容自动触发
  • 也可以在提示中明确引用 Skill

示例

使用 test-driven-development 的方式,为这个功能编写测试

练习题目

  1. 安装练习:安装 3 个常用的 Skills
  2. 使用练习:使用 brainstorming Skill 进行项目设计
  3. debugging 练习:使用 systematic-debugging Skill 定位 Bug
  4. TDD 练习:使用 test-driven-development Skill 完成 TDD 流程

参考资料


第 6 章:自定义 Commands

学习目标

  • 理解自定义 Commands 的概念
  • 学会创建自定义 Commands
  • 掌握 Commands 的高级用法
  • 了解 Commands 的管理和分享

学习内容

6.1 什么是自定义 Commands

概念

  • 将常用的提示词封装为斜杠命令
  • 一键触发复杂任务
  • 提高重复性工作的效率

存储位置

~/.claude/commands/     # 全局 Commands
.claude/commands/       # 项目级 Commands

6.2 创建自定义 Commands

步骤

  1. 创建目录
mkdir -p ~/.claude/commands
  1. 编写 Command 文件
# 创建文件 ~/.claude/commands/security-review.md
cat > ~/.claude/commands/security-review.md << 'EOF'
审查这段代码的安全性,重点关注:
1. SQL 注入风险
2. XSS 漏洞
3. 权限控制缺陷
4. 敏感信息泄露

输出格式:
- 严重问题(必须修复)
- 建议改进(可选)
- 正面反馈
EOF
  1. 使用 Command
/security-review

6.3 常用 Commands 示例

代码审查 Command

# 文件:~/.claude/commands/code-review.md
请审查当前代码变更,检查:
1. 代码风格一致性
2. 潜在 Bug
3. 性能问题
4. 缺少测试的情况
5. 错误处理完整性

输出详细的审查报告。

提交信息生成 Command

# 文件:~/.claude/commands/commit-msg.md
根据当前的 git diff,生成符合 Conventional Commits 规范的提交信息。

要求:
- 类型准确(feat/fix/docs/style/refactor/test/chore)
- 描述简洁清晰
- 必要时添加 body 说明

6.4 Commands 高级用法

带参数的 Commands

# 使用变量
分析 {{file}} 的性能,找出优化点

项目级 Commands

  • 将 Commands 放在项目目录 .claude/commands/
  • 版本控制 Commands,团队共享

练习题目

  1. 创建练习:创建 3 个自定义 Commands
  2. 使用练习:使用自定义 Command 完成代码审查
  3. 项目级练习:为项目创建项目级 Commands 并提交到 Git
  4. 分享练习:与团队成员分享你的 Commands

参考资料


第 7 章:扩展任务与自动化

学习目标

  • 掌握 AI 辅助写作工作流
  • 学会使用 Claude Code 进行内容创作
  • 掌握办公效率提升技巧
  • 了解自动化工作流

学习内容

7.1 文档写作工作流

核心思路

需求描述 → 大纲生成 → 内容创作 → 迭代优化

步骤详解

  1. 生成大纲

    我要写一篇关于"微服务架构"的技术文章,目标读者是有 2 年经验的后端开发者。
    请帮我:
    1. 确定文章结构
    2. 列出每个部分的要点
    3. 建议一个吸引人的标题
  2. 创作内容

    按照刚才讨论的大纲,写出完整的文章
  3. 迭代优化

    开头部分可以增加一个实际案例引入吗?
    第三部分的技术细节需要更详细一些

7.2 办公效率提升

文件整理

分析当前目录的文件结构,建议整理方案:
1. 按文件类型分类
2. 重命名规范化
3. 删除冗余文件

数据处理

分析这个 CSV 文件:
1. 数据统计 summary
2. 生成可视化建议
3. 发现异常数据点

7.3 自动化工作流

结合 Git Hooks

  • 在提交前自动运行代码审查
  • 生成提交信息
  • 检查代码规范

结合 CI/CD

  • GitHub Actions 集成
  • GitLab CI 集成
  • 自动化测试和部署

练习题目

  1. 写作练习:用 Claude Code 完成一篇技术文章
  2. 数据分析练习:分析一个数据文件并生成报告
  3. 自动化练习:设置 Git 钩子,提交前自动审查代码
  4. CI/CD 练习:配置 GitHub Actions 调用 Claude Code

参考资料


第 8 章:进阶工作流与最佳实践

学习目标

  • 掌握高效的工作流技巧
  • 了解 Claude Code 最佳实践
  • 学会使用进阶技巧
  • 掌握问题排查方法

学习内容

8.1 核心工作流

推荐工作流程

进入项目目录 → Claude 自动读取 CLAUDE.md → 
明确需求 → 必要时使用 /plan → 审阅方案 → 实施 → 验证

关键原则

  • 好的 CLAUDE.md 是成功的一半
  • 复杂任务先用 Plan 模式
  • 分步骤实施,及时验证
  • 保持对话聚焦,避免发散

8.2 13 条高级使用技巧

技巧清单

  1. 创建完善的 CLAUDE.md
    • 包含项目架构、常用命令、代码规范
    • 定期更新维护
  2. 善用 @ 引用精确代码
    • @文件名#L行号 引用特定代码行
    • @文件名 引用整个文件
  3. 活用 ! 执行命令
    • 在对话中直接执行命令
    • 查看输出并继续对话
  4. 使用 Plan 模式
    • 复杂任务先用 Plan 分析
    • 确认方案后再实施
  5. 创建自定义 Commands
    • 封装重复性工作
    • 团队共享最佳实践
  6. 使用 Skills 增强能力
    • 从 skills.sh 安装专业 Skills
    • 针对特定领域任务
  7. 保持上下文聚焦
    • 一个对话专注一个主题
    • 使用 /new 开启新话题
  8. 定期总结关键信息
    • 长对话中确认理解一致
    • 保存重要结论
  9. 利用代码分析能力
    • 让 Claude 分析项目架构
    • 发现潜在问题
  10. 配置全局规则
    • 在 CLAUDE.md 中定义代码规范
    • 统一代码风格
  11. 结合版本控制
    • 重要修改前先 commit
    • 方便回滚
  12. 多平台使用
    • 终端、Web、桌面版灵活切换
    • 选择最适合的场景
  13. 持续学习和调整
    • 根据实际使用调整工作流
    • 关注新功能和最佳实践

8.3 问题排查

常见问题

问题 解决
Claude 不理解项目 完善 CLAUDE.md
回复不够准确 提供更具体的上下文
修改不符合预期 使用 Plan 模式先讨论
对话过长 使用 /new 开启新对话
权限问题 检查 API Key 和额度

练习题目

  1. 工作流实践:完整走一遍推荐的核心工作流程
  2. Commands 实践:创建一套完整的自定义 Commands
  3. 最佳实践检查:对照 13 条技巧检查自己的工作流
  4. 问题排查练习:故意制造问题并学会排查

参考资料


第三部分:高级篇

目标:深度定制 Claude Code,构建个人专属工作流,实现团队协作


第 9 章:高级定制

学习目标

  • 掌握 Claude Code 的完整配置系统
  • 能够创建和管理复杂配置
  • 掌握高级设置和优化
  • 了解企业级配置

学习内容

9.1 配置系统详解

配置文件位置

~/.claude/settings.json       # 全局配置
.claude/settings.json         # 项目级配置
CLAUDE.md                     # 项目上下文

全局配置示例

{
  "anthropicApiKey": "your-api-key",
  "defaultModel": "claude-4-sonnet",
  "theme": "dark",
  "autoExecute": false,
  "contextWindow": 200000
}

9.2 高级设置

模型选择

{
  "defaultModel": "claude-4-opus",
  "planModel": "claude-4-opus",
  "codeModel": "claude-4-sonnet"
}

权限控制

{
  "autoExecute": false,
  "confirmDestructive": true,
  "maxTokens": 8192
}

9.3 CLAUDE.md 高级写法

完整示例

# CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

## 项目概述
- 名称:电商后台管理系统
- 技术栈:Next.js + TypeScript + Prisma + PostgreSQL
- 架构:前后端分离,微服务架构

## 开发环境
- Node.js 18+
- pnpm 包管理器
- Docker 运行数据库

## 常用命令

# 开发
pnpm dev          # 启动开发服务器
pnpm db:migrate   # 运行数据库迁移
pnpm db:seed      # 填充测试数据

# 测试
pnpm test         # 运行单元测试
pnpm test:e2e     # 运行 E2E 测试
pnpm test:ui      # 启动 Vitest UI

# 代码质量
pnpm lint         # ESLint 检查
pnpm typecheck    # TypeScript 类型检查
pnpm format       # Prettier 格式化

## 代码规范
- 使用 TypeScript 严格模式
- 组件使用 PascalCase 命名
- 工具函数使用 camelCase 命名
- 优先使用函数组件和 Hooks
- 复杂逻辑必须添加注释

## 数据库规范
- 表名使用小写复数形式
- 字段使用 camelCase
- 外键必须建立索引
- 敏感字段加密存储

## 测试要求
- 新功能必须包含单元测试
- API 必须包含集成测试
- 关键流程必须包含 E2E 测试

练习题目

  1. 配置练习:创建完整的全局配置和项目配置
  2. CLAUDE.md 练习:为复杂项目编写完善的 CLAUDE.md
  3. 优化练习:调整配置以优化响应速度和质量
  4. 企业配置练习:了解企业级配置选项

参考资料


第 10 章:高级工作流与团队协作

学习目标

  • 了解 Claude Code 之父的工作流
  • 掌握团队级配置管理
  • 学会团队最佳实践
  • 了解企业版特性

学习内容

10.1 Claude Code 之父的工作流

核心原则

  1. Think first, code later - 先思考,后编码
  2. Small steps, big wins - 小步快跑,积小胜为大胜
  3. Trust but verify - 信任但要验证

工作流模式

1. 深度理解需求(与 AI 充分沟通)
2. 制定详细方案(Plan 模式)
3. 分步实施(验证每一步)
4. 持续验证(测试和审查)
5. 迭代优化(根据反馈调整)

10.2 团队配置管理

版本控制配置

# 将 .claude/ 和 CLAUDE.md 加入版本控制
git add .claude/ CLAUDE.md
git commit -m "Add Claude Code configuration"

配置分层策略

  • 全局配置:个人偏好(~/.claude/settings.json
  • 项目配置:团队规范(项目/CLAUDE.md.claude/
  • 本地覆盖:个人临时调整(不提交)

10.3 团队最佳实践

项目初始化清单

  1. 创建完善的 CLAUDE.md
  2. 定义项目级 Commands
  3. 配置推荐的 Skills
  4. 设置代码规范和检查
  5. 文档化团队工作流

知识共享

  • 定期分享有效的 Commands
  • 维护团队 Skills 库
  • 记录常见问题和解决方案

10.4 企业版特性

企业功能(了解):

  • 集中配置管理
  • 审计日志
  • SSO 集成
  • 高级安全策略
  • 团队协作功能

练习题目

  1. 团队配置练习:为团队创建完整的配置方案
  2. 工作流实践:完整实施 Claude Code 之父的工作流
  3. 知识共享练习:创建团队 Commands 库并分享
  4. 企业功能了解:了解企业版与社区版的区别

参考资料


第 11 章:IDE 集成与扩展

学习目标

  • 掌握 VS Code 集成
  • 了解 JetBrains 插件
  • 掌握 Chrome 扩展使用
  • 了解 MCP 扩展

学习内容

11.1 VS Code 集成

安装扩展

  • 在 VS Code 扩展商店搜索 “Claude Code”
  • 安装官方扩展

使用方法

  • 在编辑器中直接调用 Claude Code
  • 选中代码右键发送到 Claude
  • 在侧边栏与 Claude 对话

11.2 JetBrains 插件

支持的 IDE

  • IntelliJ IDEA
  • PyCharm
  • WebStorm
  • 其他 JetBrains 产品

安装方法

  • 在插件市场搜索 “Claude Code”
  • 安装并配置 API Key

11.3 Chrome 扩展

功能

  • 在浏览器中与 Claude 对话
  • 分析网页内容
  • 辅助阅读技术文档

11.4 MCP 扩展

什么是 MCP

  • Model Context Protocol
  • 连接外部工具和服务的标准协议

使用场景

  • 连接数据库
  • 集成第三方 API
  • 扩展 Claude Code 的能力边界

练习题目

  1. VS Code 集成练习:安装并配置 VS Code 扩展
  2. JetBrains 练习:在 JetBrains IDE 中使用 Claude Code
  3. Chrome 扩展练习:使用浏览器扩展辅助开发
  4. MCP 了解:了解 MCP 的概念和潜在应用

参考资料


附录

A. 快捷键速查表

快捷键 功能
Ctrl + c 取消当前操作
Tab 自动补全
/ 浏览历史输入

B. 斜杠命令速查表

命令 功能
/help 显示帮助
/plan 进入 Plan 模式
/clear 清空对话
/new 新建对话
/exit 退出

C. 核心学习资源索引

官方文档

Skills 生态

深度文章

GitHub 资源


学习路径总结

┌─────────────────────────────────────────────────────────────────┐
│                         学习路径总览                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐          │
│  │  初级篇     │ →  │  进阶篇     │ →  │  高级篇     │          │
│  │  (基础)     │    │  (效率)     │    │  (专家)     │          │
│  └─────────────┘    └─────────────┘    └─────────────┘          │
│        │                  │                  │                  │
│   安装与起步          高级功能与技巧      高级定制              │
│   基础操作            Skills 系统         团队协作              │
│   基础工作流          自定义 Commands     IDE 集成              │
│                       扩展任务                              │
│                       进阶工作流                            │
│                                                                  │
│  预计学习时间:2-4 周                                             │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

引用信息

引用本文请注明以下信息。

@article{lj_claudecode2026,
  author = {龙军},
  title = {claude code学习路径},
  year = {2026},
  url = {https://jdragonnudt.github.io/inspiraHub/myblog/posts/claudecode-learning-path/},
}
Back to top