# claude-code-tutorial

**Repository Path**: qdphenix/claude-code-tutorial

## Basic Information

- **Project Name**: claude-code-tutorial
- **Description**: https://github.com/linjh1118/claude-code-tutorial
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code 学习教程

> 🚀 两周掌握 AI 辅助编程，让 Claude 成为你的编程搭档

[![Claude Code](https://img.shields.io/badge/Claude%20Code-Official-blue)](https://code.claude.com)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

## 📖 简介

本教程帮助你在 **2 周内** 系统学习 Claude Code，从基础使用到高级特性（Skills、Hooks、SubAgents），成为 AI 辅助编程的高手。

## 🎯 学习目标

完成本教程后，你将能够：

- ✅ 熟练使用 Claude Code CLI/VS Code/桌面端
- ✅ 编写 CLAUDE.md 定制项目规范
- ✅ 创建 Skills 扩展 Claude 能力
- ✅ 配置 Hooks 实现自动化工作流
- ✅ 使用 SubAgents 处理复杂任务

## 📚 课程大纲

### 第一周：基础篇

| Day | 主题 | 内容 |
|-----|------|------|
| 1 | [环境搭建](docs/week1/day1-setup.md) | 安装 Claude Code，完成首次登录 |
| 2 | [基础命令](docs/week1/day2-commands.md) | 掌握日常开发最常用的命令 |
| 3 | [文件编辑与 Git](docs/week1/day3-git.md) | 让 Claude 修改代码并管理版本 |
| 4 | [CLAUDE.md 入门](docs/week1/day4-claude-md.md) | 创建项目级别的配置文件 |
| 5 | [验证与调试](docs/week1/day5-verification.md) | 让 Claude 自我验证代码质量 |
| 6 | [探索优先工作流](docs/week1/day6-workflow.md) | 先探索、再计划、后执行 |
| 7 | [周末项目](docs/week1/day7-project.md) | 综合实战 |

### 第二周：进阶篇

| Day | 主题 | 内容 |
|-----|------|------|
| 8 | [Skills 系统](docs/week2/day8-skills.md) | 创建和使用 Skills |
| 9 | [Skills 高级特性](docs/week2/day9-skills-advanced.md) | 参数传递、动态上下文 |
| 10 | [SubAgents](docs/week2/day10-subagents.md) | 使用 SubAgent 处理专门任务 |
| 11 | [Hooks 自动化](docs/week2/day11-hooks.md) | 自动执行脚本 |
| 12 | [最佳实践](docs/week2/day12-best-practices.md) | 高效使用模式 |
| 13 | [MCP 与外部集成](docs/week2/day13-mcp.md) | 连接外部服务 |
| 14 | [综合项目](docs/week2/day14-project.md) | 打造个人项目模板 |

## 🚀 快速开始

### 1. 安装 Claude Code

```bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# 或使用 Homebrew (macOS)
brew install --cask claude-code
```

### 2. 首次使用

```bash
cd your-project
claude
# 按提示完成登录
```

### 3. 试一试

```
what does this project do?
```

## 📁 项目结构

```
claude-code-tutorial/
├── README.md           # 本文件
├── docs/
│   ├── week1/          # 第一周教程
│   │   ├── day1-setup.md
│   │   ├── day2-commands.md
│   │   └── ...
│   └── week2/          # 第二周教程
│       ├── day8-skills.md
│       └── ...
├── examples/           # 示例代码
│   ├── claude-md/      # CLAUDE.md 示例
│   ├── skills/         # Skills 示例
│   └── hooks/          # Hooks 示例
└── projects/           # 周末项目模板
    ├── week1/
    └── week2/
```

## 🔗 资源链接

- [Claude Code 官方文档](https://code.claude.com/docs)
- [Best Practices](https://code.claude.com/docs/en/best-practices)
- [Skills Guide](https://code.claude.com/docs/en/skills)
- [Anthropic Discord](https://www.anthropic.com/discord)

## 📅 学习时间线 (2.17 - 3.2)

本教程与 [openclaw-tutorial](https://github.com/linjh1118/openclaw-tutorial) **并行学习**。

### Week 1：基础篇 (2.17 - 2.23)

| 日期 | Claude Code 任务 | 交付物 |
|-----|------------------|--------|
| 2/17 (一) | Day1: 环境搭建 | 安装成功截图 |
| 2/18 (二) | Day2: 基础命令 | 用 Claude 探索项目截图 |
| 2/19 (三) | Day3: 文件编辑与 Git | `claude commit` 记录 |
| 2/20 (四) | Day4: CLAUDE.md | 提交 CLAUDE.md 文件 |
| 2/21 (五) | Day5: 验证与调试 | Bug 修复记录 |
| 2/22 (六) | Day6: 探索优先工作流 | 四阶段流程记录 |
| 2/23 (日) | **Day7: 周末项目** | **🎯 Week1 项目提交** |

### Week 2：进阶篇 (2.24 - 3.2)

| 日期 | Claude Code 任务 | 交付物 |
|-----|------------------|--------|
| 2/24 (一) | Day8: Skills 系统 | 创建 2 个 Skills |
| 2/25 (二) | Day9: Skills 高级 | 带参数的 Skill |
| 2/26 (三) | Day10: SubAgents | SubAgent 配置 |
| 2/27 (四) | Day11: Hooks | Hooks 配置 |
| 2/28 (五) | Day12: 最佳实践 | 学习笔记 |
| 3/1 (六) | Day13: MCP 集成 | gh CLI 截图 |
| 3/2 (日) | **Day14: 最终项目** | **🎯 最终项目 + 总结报告** |

### 🎯 关键里程碑

```
2/17          2/23              3/2
 │             │                 │
 ▼             ▼                 ▼
开始学习     Week1 项目        最终项目
(并行)        提交             + 总结报告
```

## 📝 前置要求

- 终端基础操作能力
- 基本的编程经验
- [Claude 订阅](https://claude.com/pricing)（Pro/Max/Teams/Enterprise）或 [Console 账户](https://console.anthropic.com/)

## 🤝 贡献

欢迎提交 Issue 和 PR！

## 📄 License

MIT License