来源：Claude Code Skills

Claude Code 新手完全入门指南

概述

你可能听说过 Claude Code，知道它是一个很强大的 AI 编程助手，但不太确定从哪里开始。也许你有一定的编程基础，也许你完全是新手——这都没关系。

这篇指南的目标是：让你在 30 分钟内理解 Claude Code 的核心技能，并且知道如何把它们组合起来完成实际项目。我们不会讲太多理论，更多的是「知道这些就够了，现在开始做」。

适合人群：

第一次使用 Claude Code 的开发者
有基础编程知识但不知道如何高效使用 AI 辅助开发的人
想了解 Claude Code 技能体系全貌的人

什么是 Claude Code

Claude Code 是 Anthropic 推出的官方命令行工具，让你在终端中直接与 Claude 对话，完成编程任务。但它不只是一个聊天机器人——通过加载不同的「技能（Skills）」，你可以让它按照特定的方法论和纪律来工作。

技能是什么？ 简单来说，技能是一组预定义的规则和行为模式。当你给 Claude Code 加载一个技能后，它就会按照这个技能定义的方式工作。比如加载了「测试驱动开发」技能后，Claude 会在写代码之前先写测试，而不是生成一大段未经验证的代码。

为什么技能很重要？ 没有技能的 Claude Code 就像一个没有方法论的新手程序员——能写代码，但缺乏纪律。有了技能，它就变成了一个遵循工程最佳实践的资深工程师。

安装与配置

Claude Code 的安装非常简单。如果你还没有安装，请访问我们的安装指南页面，按照步骤操作。

基本流程：

确保你的系统安装了 Node.js（版本 18 以上）
在终端运行安装命令
配置你的 Anthropic API 密钥
验证安装是否成功

安装完成后，在任意项目目录下输入 claude 即可启动 Claude Code。

5 个核心技能

作为新手，你不需要一次学会所有技能。以下是最重要的 5 个核心技能，掌握了它们，你就能应对 80% 的开发场景。

技能1：测试驱动开发（TDD）

一句话解释： 先写测试，再写代码。

为什么重要？ 这是最能提升代码质量的单一习惯。当你让 AI 帮你写代码时，如果没有测试，你怎么知道代码是对的？「能跑起来」不等于「正确」。

怎么用？ 当你要实现一个功能时，告诉 Claude：「请先写一个测试来验证这个功能，运行测试确认它失败，然后再写实现代码。」

新手常见疑问： 「先写测试不是更慢吗？」短期看确实多了一步，但长期看它为你节省大量调试时间。测试就像安全网，让你敢于修改和重构代码。

实际效果：

你的指令：「创建一个函数，把华氏温度转换为摄氏温度」

没有 TDD：Claude 直接给你一个函数，可能对也可能有边界问题
有 TDD：Claude 先写测试（32°F = 0°C, 212°F = 100°C, -40°F = -40°C），
       运行测试确认失败，然后写实现，运行测试确认全部通过

技能2：系统化调试（Systematic Debugging）

一句话解释： 用二分法和假设检验来找 bug，不靠猜。

为什么重要？ 新手调试最常见的方式是「到处加 print，看哪里出了问题」。这在简单情况下可行，但当代码复杂度上升后就完全失效了。系统化调试教你用科学方法定位问题。

怎么用？ 遇到 bug 时，告诉 Claude：「这里有一个 bug（描述症状），请用系统化调试方法来定位根因。」Claude 会列出可能的假设，按优先级排列，然后逐一验证。

核心方法：

二分法定位：不断缩小问题范围，每次排除一半的可能性
假设驱动：提出假设 → 设计实验 → 验证或推翻 → 下一个假设
一次一变量：每次只改一个东西，确保你知道是什么修复了问题

技能3：完成前验证（Pre-completion Verification）

一句话解释： 在说「完成了」之前，过一遍检查清单。

为什么重要？ AI 生成的代码经常有一个问题：主要功能是对的，但边界情况、错误处理、安全性可能有遗漏。完成前验证就是那个防止你把半成品当成品的关卡。

怎么用？ 每次让 Claude 完成一个功能后，要求它：「在提交之前，请做完成前验证。」它会检查：

功能是否完整（所有需求点都实现了吗？）
测试是否充分（关键路径都覆盖了吗？）
错误处理是否到位（异常情况会怎样？）
有没有安全隐患

技能4：编写实施计划（Implementation Plan）

一句话解释： 先做计划，再动手。

为什么重要？ 「边想边做」是新手最常见的工作方式，也是返工最多的工作方式。一份好的实施计划能帮你理清思路，避免做到一半发现方向错了。

怎么用？ 在开始一个新功能或新项目时，告诉 Claude：「先别写代码，帮我写一个实施计划。」计划应包含：

目标和范围
技术方案选择及理由
具体的实施步骤
每步的验收标准
潜在风险和应对方案

技能5：代码评审（Code Review）

一句话解释： 让 AI 当你的严格审查者。

为什么重要？ 在团队中，代码评审是标准流程。但如果你是独立开发者，没人帮你审查代码。代码评审技能让 Claude 扮演一个严格的高级工程师，帮你发现你自己看不到的问题。

怎么用？ 功能开发完成后，告诉 Claude：「请对这些变更做一次严格的代码评审。」它会从可读性、可维护性、性能、安全性等多个维度给出反馈。

你的第一个项目

理论讲够了，让我们动手做一个简单的项目来实践这些技能。

项目： 一个命令行待办事项（Todo）工具，支持添加、列出、完成、删除任务。

步骤1：制定计划

你对 Claude 说：
「我想做一个命令行 Todo 工具，支持添加、列出、完成、删除任务。
请先写一个实施计划，不要写代码。」

Claude 会给你一份计划，包含技术选型、数据存储方案、具体实施步骤等。确认计划后再进入下一步。

步骤2：用 TDD 开发

你对 Claude 说：
「按照计划，我们开始实现第一个功能：添加任务。
请先写测试，运行确认失败，再写实现。」

Claude 会按照 TDD 的红-绿-重构循环来开发。你可以看到测试先失败（红），然后代码实现后测试通过（绿），最后重构代码使其更整洁。

步骤3：逐个实现其他功能

对每个功能（列出、完成、删除）重复步骤2。每个功能都是：测试先行 → 实现 → 通过。

步骤4：完成前验证

你对 Claude 说：
「所有功能都实现了，请做一次完成前验证。」

Claude 会检查边界情况（空列表、重复添加、无效 ID 等）、错误处理、代码质量。

步骤5：代码评审

你对 Claude 说：
「请对整个项目做一次代码评审。」

根据评审意见做最后的优化，你的第一个项目就完成了。

进阶路径

掌握了这 5 个核心技能后，你可以继续探索更高级的技能：

下一步学什么

Git Worktrees 并行开发 — 当你的项目变大，需要同时开发多个功能时，这个技能能让你高效地并行工作
头脑风暴 — 当你有新的项目想法时，用这个技能把模糊的想法变成结构化的需求
并行代理调度（Parallel Agent Dispatch） — 高级技能，让多个 Claude 实例同时工作，适合大型项目

学习建议

循序渐进：不要试图一次学会所有技能，先把 TDD 和完成前验证形成习惯
在真实项目中练习：不要只看教程，选一个你真正需要的小工具来做
反思和调整：每次用完后想想：哪些技能帮了大忙？哪些地方还可以改进？
浏览技能库：我们的网站按场景整理了所有技能，找到适合你当前需要的去学习

Complete Beginner's Guide to Claude Code

Overview

You do not need years of coding experience to build software with Claude Code. You do not need a computer science degree. You do not even need to know what a "function" or a "variable" is. What you need is a problem you want to solve and the willingness to describe it clearly.

Claude Code is an AI-powered development tool that lives in your terminal. You describe what you want to build in plain English, and it writes the code, runs it, debugs it, and helps you ship it. But Claude Code becomes dramatically more powerful when you give it structured instructions called "skills" --- reusable patterns that tell Claude how to approach specific types of work.

This guide is your first step. It will walk you through what Claude Code is, how to set it up, the five core skills every beginner should know, and how to build your first project. By the end, you will have a working application and a foundation for tackling more ambitious projects.

What is Claude Code?

Claude Code is a command-line interface (CLI) tool made by Anthropic. Think of it as having a senior software developer sitting next to you in the terminal, ready to help with anything: writing code, fixing bugs, explaining concepts, managing files, running commands, and deploying applications.

Unlike a chatbot that just gives you text responses, Claude Code can actually do things on your computer. It can create files, edit existing ones, run your application, read error messages, and fix problems --- all within a conversation where you guide it with natural language.

Skills are what make Claude Code exceptional. A skill is a set of instructions (usually written in a markdown file) that tells Claude Code how to approach a specific type of task. Without skills, Claude Code is a general-purpose assistant. With the right skills loaded, it becomes a specialist --- a testing expert, a debugging detective, a project planner, or a code reviewer. Skills are the difference between "write me some code" and "follow a proven methodology to build reliable software."

Installation & Setup

Getting started requires three things:

A terminal. On macOS, open the Terminal app. On Windows, use PowerShell or Windows Terminal. On Linux, you already know where your terminal is.
Node.js. Claude Code runs on Node.js. Download it from nodejs.org and install the LTS (Long Term Support) version.
Claude Code itself. Open your terminal and run:
```
npm install -g @anthropic-ai/claude-code
```
Authentication. Run claude in your terminal. The first time, it will walk you through connecting to your Anthropic account. Follow the prompts.

For detailed setup instructions, including troubleshooting common installation issues, visit the setup guide on the website.

Once installed, you interact with Claude Code by typing claude in your terminal and then having a conversation. You can ask it to create projects, write code, explain what existing code does, run tests, and much more.

The 5 Core Skills Every Beginner Should Know

These five skills form the foundation of effective Claude Code usage. You do not need to master all of them at once. Start with the first two, and add the others as you gain confidence.

1. Implementation Plan

What it does: Turns your vague idea into a structured, step-by-step development plan.

Why it matters: The biggest mistake beginners make is diving straight into code without a plan. You end up building features in the wrong order, painting yourself into architectural corners, and wasting time on things that do not matter yet. The Implementation Plan skill prevents all of this.

How to use it: Describe your project idea to Claude Code and ask it to create an implementation plan. The skill will produce a phased roadmap with specific milestones. Each milestone is a small, complete piece of functionality that you can build and test independently.

Example prompt: "I want to build a personal expense tracker web app. Create an implementation plan."

2. TDD (Test-Driven Development)

What it does: Teaches Claude Code to write tests before writing the actual code.

Why it matters: Tests are like guardrails on a mountain road. They do not slow you down --- they keep you from driving off a cliff. When Claude Code writes tests first, it defines what "working correctly" means before writing the implementation. This catches bugs immediately, not three weeks later when you cannot remember how the code was supposed to work.

How to use it: When asking Claude Code to build a feature, instruct it to write the test first, then the implementation. The TDD skill enforces a cycle: write a failing test, write code to make it pass, clean up the code while keeping the test green.

Example prompt: "Using TDD, build the expense creation endpoint. Write the test first."

3. Brainstorming

What it does: Structures a creative exploration of your problem space.

Why it matters: When you are starting a new project, the problem is rarely "I cannot code this." The problem is "I am not sure exactly what to build." The Brainstorming skill helps you explore your idea systematically: who are your users, what problems do they have, what solutions exist, and where is the opportunity?

How to use it: Describe your domain area and ask Claude Code to run a brainstorming session. It will ask you questions, challenge your assumptions, and help you converge on a focused product vision.

Example prompt: "I want to build something that helps freelancers manage their finances. Run a brainstorming session."

4. Systematic Debugging

What it does: Provides a structured method for finding and fixing bugs.

Why it matters: Every developer encounters bugs. The difference between a beginner and an expert is not that experts write bug-free code --- it is that experts have a system for finding bugs efficiently. The Systematic Debugging skill gives you that system from day one: gather evidence, form hypotheses, test them methodically, and verify your fix.

How to use it: When something breaks, resist the urge to randomly change things. Instead, describe the problem to Claude Code and follow the debugging methodology: What is the expected behavior? What is the actual behavior? What changed recently?

Example prompt: "The login page shows a blank screen instead of the login form. Help me debug this systematically."

5. Pre-Completion Verification

What it does: Runs a comprehensive checklist before you declare a feature "done."

Why it matters: Beginners often think a feature is done when it works on their machine in the happy path. Pre-Completion Verification checks for all the things you might forget: error handling, edge cases, input validation, security basics, and accessibility. It is like having an experienced developer review your work before you ship it.

How to use it: After building a feature, ask Claude Code to run pre-completion verification. It will systematically check for common issues and suggest improvements.

Example prompt: "I just finished the user registration feature. Run pre-completion verification."

Your First Project

Let us put these skills into practice with a concrete project: a personal task manager. This is small enough to build in an afternoon but complex enough to exercise all five core skills.

Step 1: Brainstorm (15 minutes)

Open Claude Code and start a brainstorming session:

claude
> I want to build a simple personal task manager. Help me brainstorm what features it should have and how it should work.

Claude will guide you through questions about your target user (yourself), must-have features (create, complete, delete tasks), nice-to-haves (categories, due dates, priorities), and technical choices (web app, command-line tool, or mobile app).

For your first project, keep it simple: a web-based task manager with the ability to create, view, complete, and delete tasks.

Step 2: Plan (20 minutes)

Ask Claude to create an implementation plan:

> Create an implementation plan for a web-based task manager with create, view, complete, and delete functionality.

The plan might include three milestones:

Milestone 1: Project setup and a task list that shows hardcoded data
Milestone 2: Create and delete tasks with real data storage
Milestone 3: Mark tasks as complete, add filtering

Step 3: Build with TDD (2--3 hours)

Work through each milestone using TDD:

> Let's start Milestone 1. Using TDD, set up the project and create a task list component that displays tasks.

Claude will write a test for the task list component, then write the component to make the test pass. You will see the red-green-refactor cycle in action. Continue through each milestone, always writing tests first.

Step 4: Debug as needed

When something breaks (and it will --- that is normal and expected), use the Systematic Debugging approach:

> The task list is not rendering. The page shows "Cannot read property 'map' of undefined." Help me debug this systematically.

Claude will help you trace the error to its source, understand why it happened, and fix it properly.

Step 5: Verify before shipping

Once all three milestones are complete:

> Run pre-completion verification on the entire task manager application.

Claude will check for missing error handling, potential security issues, accessibility problems, and other common oversights. Fix whatever it finds.

Congratulations --- you have built a real application using a professional development methodology. The task manager might be simple, but the process you followed is the same one used to build complex production software.

What's Next

You have learned the five core skills and built your first project. Here is where to go from there:

Build something you actually need. The task manager was practice. Now pick a project that solves a real problem in your life. A recipe organizer, a workout tracker, a reading log, a budgeting tool --- something you will actually use. Real motivation produces better software.

Explore more skills. The five core skills are just the beginning. The Claude Code Skills website has dozens more, organized by scenario. Interested in working with APIs? There is a skill for that. Want to build a mobile app? There are skills for that too. Browse the collection and add skills as your projects demand them.

Learn to read code. As you work with Claude Code, start reading the code it generates. Ask it to explain anything you do not understand. Over time, you will develop an intuition for how software is structured, and you will be able to guide Claude Code more effectively.

Join the community. Share what you build. Ask questions when you are stuck. Help others who are a step behind you. The best way to solidify your own understanding is to explain it to someone else.

The gap between "I have an idea" and "I built a working application" has never been smaller. Claude Code and its skills are the bridge. Start walking.

你想做什么	推荐指南
从零构建一个 Web 应用	用 Claude Code 从零构建 SaaS 产品
修复一个棘手的 bug	系统化调试生产环境问题
建立代码评审流程	用 AI 做严格代码评审的完整流程
构建 Agent 系统	构建多 Agent 系统的完整方法论

Claude Code 新手完全入门指南 Complete Beginner's Guide to Claude Code

本指南使用的技能 Skills Used in This Guide