前言
作为一名新手，想要快速上手Claude Code（简称cc），无需复杂操作，只需跟着以下步骤一步步推进，就能轻松解锁AI编码的高效体验。cc本质上是集成了skill、agent、mcp、tool等功能的综合编程助手，底层基于JavaScript开发，能全程辅助我们完成项目开发，全程只需简单确认，就能不知不觉搞定完整项目。
一、前期准备：安装必备工具
在配置cc之前，我们需要先安装两个基础工具，它们是cc正常运行的前提，直接访问对应链接下载安装即可，操作简单无门槛。
1. 安装Git for Windows
Git是项目版本管理的基础工具，cc运行过程中需要依赖其相关功能，下载地址如下：
官方下载链接：git-scm.com/downloads/w…
进入链接后，可选择最新版（当前最新为2.51.0 x64版本，2025年8月19日发布），根据自身需求选择“standalone installer”（独立安装包）、“portable（thumbdrive edition）”（便携版），或通过winget工具安装（若已安装winget，可在命令提示符或PowerShell中输入命令：winget install --id git.git -e --source winget），安装过程一路下一步即可完成。
2. 安装Node.js
Node.js提供了cc运行所需的运行环境，同时自带npm包管理工具，后续用于安装cc原版包，下载地址如下：
官方下载链接：nodejs.org/zh-cn/downl…
推荐下载LTS版本（当前为v22.17.0），Linux系统可通过nvm工具安装（具体命令参考官方提示），Windows系统直接下载对应安装包，安装完成后，可通过终端输入“node -v”验证版本（应显示v22.17.0），输入“npm -v”验证npm版本（应显示10.9.2），确认安装成功。
二、核心配置：设置环境变量
cc正常运行必须配置3个环境变量（虽你提及4个名称，实际核心为3个关键变量），这是cc对接Anthropic服务、实现正常调用的核心，步骤如下（以Windows系统为例）：
需配置的3个环境变量
- ANTHROPIC_API_KEY：Anthropic平台的API Key，用于接口调用鉴权，是cc正常工作的核心凭证。
- ANTHROPIC_AUTH_TOKEN：Claude账号认证Token，用于身份验证，确保调用权限合法。
- ANTHROPIC_BASE_URL：API请求基础地址，可使用Anthropic官方地址，若有代理或第三方接口，替换为对应地址即可（可咨询AI获取合适的地址）。
环境变量配置步骤
-
打开电脑“设置”，搜索“环境变量”，点击“编辑系统环境变量”；
-
在弹出的窗口中，点击“环境变量”，在“系统变量”栏点击“新建”，依次创建上述3个环境变量，填写对应的变量名和变量值；
-
配置完成后，可在终端输入以下命令验证配置是否生效：
echo $env:ANTHROPIC_API_KEY
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
若能正常输出对应变量值，说明配置成功；若报错，可检查变量名是否拼写正确，或重新配置后重启终端。
三、安装cc：部署AI编码助手
环境变量配置完成后，即可通过npm安装cc原版包，这是启动cc的关键一步，操作如下：
- 打开终端（命令提示符或PowerShell），输入以下命令，全局安装cc原版包：
npm install -g @anthropic-ai/claude-code
2. 安装过程中耐心等待，若出现“command not found”报错，说明npm全局bin目录未添加到系统PATH环境变量中，手动添加后重新安装即可。
四、启动cc：开启AI编码之旅
所有配置和安装完成后，无需复杂操作，只需重启终端，即可启动cc，具体步骤如下：
- 重启终端（确保环境变量和安装的包生效）；
- 通过cd命令进入你的新项目目录（例如：cd 学生管理系统）；
- 在终端中输入“cc”，按下回车，即可启动cc，进入AI编码交互界面。
新手小技巧：cc + Cursor 搭配使用
作为新手，推荐将cc与Cursor编辑器搭配使用，Cursor能实时显示cc生成的项目代码、结构和细节，方便我们查看项目进度、检查代码质量，及时发现问题并调整，让AI编码过程更直观、更高效。
五、新手实战：从/plan指令开始，拒绝上来就写代码
cc有很多指令，但新手切记不要上来就直接在命令行写代码，最基础、最实用的第一个指令是“/plan”，这个指令的核心作用是帮我们生成和完善claude.md文档——这是cc工程化开发的核心，也是高效开发的关键。除了/plan指令，cc还有多个常用核心指令，新手掌握这些指令，能大幅提升编码效率，以下详细补充各指令的细节、使用场景及注意事项。
/plan指令的核心作用（补充细节）
输入“/plan”后，cc会引导我们创建claude.md文档，这份文档是项目的“需求说明书”，cc会在我们初始输入的需求规范基础上，不断提供优化建议（options），帮我们完善项目的所有细节，包括数据库设计、API文档、项目限制、业务逻辑等，全程无需我们手动编写，只需不断确认（输入yes），就能得到一份完整、规范的项目需求文档。
这个过程就像我们作为“包工头”，只需指挥方向，cc就会帮我们完善“施工图纸”，确保后续开发不偏离需求，避免返工，是非常高效的开发模式。
补充细节：1. 输入/plan后，cc会先询问“请输入项目核心需求”，新手可简单描述（如“开发一个学生管理系统，支持学生信息管理、成绩录入”），无需复杂表述，cc会自动拆解需求；2. 若对cc提出的优化建议有疑问，可输入“why”，cc会详细解释该建议的用途（如“为什么需要添加院系编码表？—— 为了统一院系标识，避免后续数据混乱”）；3. 若想跳过某条建议，输入“skip”即可，不影响后续文档生成；4. 文档生成后，输入“/plan update”可重新优化文档，补充新的需求细节。
cc核心指令补充（新手必学）
cc的指令均以“/”开头，无需记忆复杂语法，新手重点掌握以下5个核心指令，就能覆盖从需求梳理到代码开发、问题排查的全流程，每个指令均补充详细用法和实战场景，贴合新手使用习惯。
1. /code 指令：生成具体代码（核心开发指令）
核心作用：根据claude.md文档的需求，生成指定模块、指定功能的代码，支持前端、后端、数据库等各类代码生成，新手无需手动编写基础代码，只需确认和微调即可。
使用细节：
- 基础用法：启动cc后，输入“/code 模块名称+功能”，如“/code 学生管理模块 新增学生接口”，cc会自动生成对应代码，并标注关键注释（如参数校验、数据库操作逻辑）；
- 精准生成：可指定技术栈，如“/code 前端 学生列表页面 React+Tailwind CSS”，cc会贴合项目技术栈生成代码，避免后续适配问题；
- 修改代码：若生成的代码不符合需求，输入“/code modify 问题描述”，如“/code modify 新增学生接口需增加手机号校验”，cc会自动修改代码，无需手动删除重写；
- 注意事项：生成代码后，cc会询问“是否需要解释代码逻辑？”，输入“yes”可获取逐行注释，帮助新手理解代码含义，快速掌握核心逻辑。
2. /test 指令：生成测试用例（保障代码可用性）
核心作用：针对生成的代码，自动生成对应的测试用例，包括单元测试、接口测试，帮助新手排查代码bug，确保代码能正常运行，避免后续上线出现问题。
使用细节：
- 基础用法：输入“/test 代码模块”，如“/test 新增学生接口”，cc会生成测试代码（贴合项目测试框架，如Jest），并标注测试要点（如正常场景、异常场景、边界值测试）；
- 运行测试：生成测试用例后，cc会提示对应的测试命令（如“pnpm test”），新手只需复制命令在终端执行，即可查看测试结果；
- 补充测试：若想增加特定场景的测试，输入“/test add 场景描述”，如“/test add 测试手机号格式错误的情况”，cc会补充对应的测试用例；
- 注意事项：测试失败时，cc会提示失败原因（如“参数校验未通过”），并给出修改建议，新手可根据建议调整代码，再次执行测试。
3. /debug 指令：排查代码问题（新手必备排错工具）
核心作用：当代码运行报错、功能无法实现时，使用该指令排查问题，cc会自动分析报错信息、定位问题位置，并给出具体的修改方案，无需新手手动排查代码漏洞。
使用细节：
- 基础用法：两种方式——① 输入“/debug 报错信息”，如“/debug 报错：Cannot read property 'name' of undefined”，cc会分析报错原因（如“未定义name变量”）并给出修改方案；② 输入“/debug 功能描述+问题”，如“/debug 新增学生功能无法保存数据”，cc会排查代码逻辑，找到问题所在；
- 快速排错：cc会优先排查常见问题（如参数缺失、数据库连接失败、语法错误），新手可直接按照建议修改，无需深入理解报错原理；
- 注意事项：若报错信息较长，可直接复制终端报错内容粘贴，cc会自动识别关键信息，无需精简报错内容。
4. /docs 指令：生成API文档（规范开发流程）
核心作用：自动生成项目的API文档，包括接口地址、请求方式、参数说明、返回值说明，适合多人协作开发，也方便新手后续维护代码、对接其他模块。
使用细节：
- 基础用法：输入“/docs 生成API文档”，cc会根据claude.md文档的接口需求和已生成的代码，自动生成规范的API文档，支持Markdown格式，可直接复制保存；
- 补充细节：输入“/docs add 接口名称”，如“/docs add 新增学生接口”，可单独生成某一个接口的文档；
- 格式调整：输入“/docs format 格式类型”，如“/docs format 表格形式”，cc会调整文档格式，让文档更直观、易读；
- 注意事项：API文档生成后，会同步更新到claude.md文档中，后续修改接口代码后，输入“/docs update”可同步更新API文档，避免文档与代码不一致。
5. /help 指令：查看指令指南（新手求助工具）
核心作用：当忘记指令用法、不知道该使用哪个指令时，使用该指令获取帮助，cc会列出所有常用指令的用法、示例，无需记忆所有指令，随时查询即可。
使用细节：
- 基础用法：输入“/help”，cc会列出所有核心指令的简要说明；
- 精准查询：输入“/help 指令名称”，如“/help /code”，cc会详细介绍该指令的用法、示例、注意事项，贴合新手需求；
- 常见问题：输入“/help 常见问题”，cc会列出新手使用cc时的常见问题（如“安装失败”“指令无效”）及解决方案，快速解决使用难题。
cc指令使用通用注意事项（新手必看）
- 所有指令均以“/”开头，输入时需注意格式，避免遗漏“/”（如输入“plan”无效，需输入“/plan”）；
- 输入指令后，若cc未响应，可重启终端、重新启动cc（输入“cc”回车），或检查环境变量配置是否生效；
- 新手无需一次性掌握所有指令，先熟练掌握“/plan”和“/code”指令，能完成基础项目开发，后续再逐步学习其他指令；
- cc所有指令支持中文描述，无需输入英文，新手可直接用中文描述需求（如“/code 生成学生登录页面”），cc会自动识别；
- 若对cc的响应结果不满意，可输入“重新生成”，cc会根据需求重新优化内容，直至符合预期。
实战案例：学生管理系统的claude.md文档
我以“学生管理系统”为例，通过/plan指令生成了完整的claude.md需求文档，文档结构清晰、内容规范，涵盖了项目开发的所有核心细节，具体如下：
claude.md 文档模板（学生管理系统 - 需求文档）
目录
1. 项目概述
学生管理系统用于提升学校学生信息、教学活动及日常事务管理效率，面向学生、教师、系统管理员三类用户，实现信息共享、流程自动化与数据可视化。
2. 术语表
| 术语 | 定义 |
|---|---|
| 学号 | 学生的唯一标识，10 位数字编码 |
| 工号 | 教师的唯一标识 |
| 院系代码 | 院系的 3 位数字编码（第 5-7 位） |
| 学期 | 学年学期标识，如 2024-2025-1 |
| 成绩可见 | 教师手动发布后学生对成绩可见 |
| 两级审批 | 辅导员审批 → 院系审批 |
3. 技术栈
- 前端: React + TypeScript + Tailwind CSS + React Router
- 状态管理: Zustand
- 后端: Next.js API Routes
- 数据库: PostgreSQL
- 包管理: pnpm
- UI 组件: Shadcn/ui
4. 角色定义
| 角色 | 权限范围 |
|---|---|
| 学生 | 查询个人信息/课程/成绩，提交请假/反馈/选课 |
| 教师 | 管理授课课程、查看学生名单、录入成绩 |
| 系统管理员 | 账号管理、院系/课程全局配置 |
5. 功能模块
5.1 学生管理模块（系统管理员）
5.1.1 学生信息模型
| 字段 | 类型 | 说明 |
|---|---|---|
| 学号 | string (10位) | 主键，唯一标识 |
| 姓名 | string | - |
| 性别 | enum | 男/女 |
| 出生日期 | date | - |
| 联系电话 | string | - |
| 电子邮箱 | string | - |
| 入学年份 | number | 4位年份 |
| 院系代码 | string (3位) | 参见院系编码表 |
| 专业 | string | - |
| 班级 | string | - |
| 状态 | enum | 在读/休学/毕业/退学 |
5.1.2 学号编码规则
格式：10位数字
组成：[入学年份4位][院系代码3位][序号3位]
示例：2024011001
├── 2024：入学年份
├── 011：院系代码（计算机学院）
└── 001：年度院系内唯一序号
规则：
1. 序号自动递增，从 001 开始
2. 同一院系同年入学序号连续
3. 系统自动校验格式、有效性、唯一性
4. 学号生成后不可修改
5.1.3 核心功能
新增学生：输入姓名、性别、出生日期、联系电话、邮箱、入学年份、院系、专业、班级，系统校验必填字段、院系代码有效性，生成学号并检查唯一性，保存至数据库，成功返回学号，失败返回错误信息。
查询学生：支持学号（精确）、姓名（模糊）、院系（精确）、入学年份（精确）多条件组合筛选，输出分页学生列表。
修改学生：输入学号及待修改字段，校验学号存在性和字段合法性，更新数据库，输出操作结果（学号不可修改）。
删除学生：输入学号，校验学号存在性，二次确认后执行软删除（状态改为退学）或硬删除，输出操作结果。
5.2 学生门户模块（学生）
5.2.1 个人面板：展示个人信息概览、本周课表、最近成绩、待审批事项。
5.2.2 信息查询：课程查询支持当前/历史学期已选课程详情查看；成绩查询支持当前/历史学期已发布成绩查看，输出课程名、平时成绩、期中成绩、期末成绩、总评成绩。
5.2.3 业务功能：请假申请支持提交请假类型、时间、原因、证明材料，执行辅导员→院系两级审批，可查看申请状态；反馈提交支持标题、内容、分类提交，系统分配对应负责人处理；选课支持学期课程选择，自动检测时间冲突和容量限制，支持退选；心理教育提供科普资源查看、心理测评、咨询预约及历史记录查询。
5.3 教师模块（教师）
5.3.1 基础功能：个人信息查看与修改、授课课程列表查看、课程学生名单查看。
5.3.2 成绩管理：支持单条/批量录入平时、期中、期末成绩，自动计算总评成绩（默认权重：平时30%、期中30%、期末40%），支持成绩保存、提交发布，发布后学生可见，教师可撤回修改；批量录入支持Excel文件导入，输出成功/失败数量及原因。
6. 非功能性需求
| 需求 | 说明 |
|---|---|
| 性能 | API 响应 < 200ms，支持 5000 用户并发 |
| 可靠性 | 数据完整一致，支持每日备份 |
| 易用性 | 界面简洁，操作步骤 ≤ 3 步 |
| 安全性 | RBAC 权限控制，全操作审计日志 |
| 兼容性 | 支持 Chrome/Edge/Firefox/Safari |
7. 依赖与约束
- 学号编码规则：学校已制定
- 院系代码：学校已定义（见编码表）
- SSO 认证：对接学校统一身份认证
- 数据库：PostgreSQL，本地部署
- 第三方集成：教务系统、一卡通（待对接）
8. 验收标准
| 模块 | 验收条件 |
|---|---|
| 学生管理 | 新增/查询/修改/删除功能正常，学号自动生成正确 |
| 学生门户 | 面板数据准确，选课冲突检测有效 |
| 请假审批 | 两级审批流程正确，通知发送成功 |
| 成绩管理 | 录入/批量/发布功能正常，成绩对学生可见控制有效 |
| 心理教育 | 测评量表完整，预约流程通顺 |
| 报表导出 | 成绩报表生成正确 |
| 审计日志 | 所有操作记录完整 |
附录 A：院系编码表
| 代码 | 院系名称 |
|---|---|
| 001 | 文学院 |
| 002 | 历史学院 |
| 003 | 哲学系 |
| 011 | 法学院 |
| 012 | 马克思主义学院 |
| 013 | 经济学院 |
| 014 | 管理学院 |
| 015 | 外国语学院 |
| 021 | 数学与统计学院 |
| 022 | 物理学院 |
| 023 | 化学学院 |
| 024 | 生命科学学院 |
| 031 | 计算机学院 |
| 032 | 电子信息学院 |
| 033 | 自动化学院 |
| 034 | 软件工程学院 |
| 214 | 软件学院 |
| 041 | 土木工程学院 |
| 042 | 机械工程学院 |
| 043 | 材料科学与工程学院 |
| 051 | 艺术学院 |
| 052 | 体育学院 |
| 053 | 传媒学院 |
| 099 | 继续教育学院 |
附录 B：状态枚举
| 模块 | 状态值 |
|---|---|
| 学生 | 在读 / 休学 / 毕业 / 退学 |
| 请假 | 草稿 / 待辅导员审批 / 待院系审批 / 已通过 / 已拒绝 |
| 成绩 | 草稿 / 已发布 |
| 选课 | 已选 / 已退 |
附录 C：开发命令
# 安装依赖
pnpm install
# 开发模式
pnpm dev
# 构建生产版本
pnpm build
# 运行测试
pnpm test
# 代码检查
pnpm lint
# 数据库迁移
pnpm db:migrate
# 生成 Prisma Client
pnpm db:generate
六、新手总结：cc的核心优势与使用逻辑
cc作为集成了多种工具的AI编码助手，底层基于JavaScript开发，新手使用无需掌握复杂指令，核心逻辑就是“先定需求，再写代码”——通过/plan指令完善claude.md文档，让cc帮我们梳理项目细节、规避开发风险，我们只需像“包工头”一样，不断确认cc提供的优化建议（输入yes），就能不知不觉完成整个项目开发。
补充说明：新手使用cc时，可遵循“/plan定需求 → /code生成代码 → /test测试代码 → /debug排查问题 → /docs生成文档”的流程，逐步推进项目开发。无需担心指令使用不熟练，通过/help指令可随时查询用法，多实战几次就能快速上手。
搭配Cursor编辑器，能更直观地查看项目进度和代码质量，新手只需跟着本文步骤，从工具安装、环境配置到/plan指令实战，一步步推进，就能快速上手cc，开启高效AI编码之路。
大佬提供的学习cc 视频：my.feishu.cn/wiki/JK1WwrRgJiYfRok7YxxceS5qn1J www.bilibili.com/video/BV1Xn… 学习cc 的可以关注交流一下。
