🧡 Claude Code 超简单新手教学(Windows 版)

今天的目标:① 装好 Claude Code 并第一次使用 ② 写第一个 CLAUDE.md ③ 写第一个 SKILL.md

贴到 PowerShell 在黑色/蓝色终端窗口里贴上 贴到 Claude 进入 Claude 之后贴上 贴到记事本 在记事本里贴上并保存

完成进度:0 / 0 步(每完成一步就打勾 ✅)

0

开始前先知道两件事

为什么你刚才输入 claude 没反应?因为电脑还没安装这个程序,就像手机没装 App 一样。装好就能用了。

确认你有付费的 Claude 账号

Claude Code 需要 Pro、Max、Team 或 Enterprise 账号(或 Console API 账号)。免费版不能使用 Claude Code。

你平常在 claude.ai 用的账号,如果是 Pro 或以上,就可以直接用。

学会打开 PowerShell(终端机)

  1. 按键盘左下角的 ⊞ Win 键
  2. 输入 powershell
  3. 按 Enter,会出现一个窗口

窗口里如果看到类似 PS C:\Users\你的名字>,前面有 PS 两个字母,就代表你开对了 ✅

💡 怎么贴上? 在本页按「复制」后,到 PowerShell 窗口里按 Ctrl + V,或直接按鼠标右键,然后按 Enter 执行。不需要用「以管理员身份运行」。
1

安装 Claude Code

只要一行指令,官方安装程序会帮你全部装好,以后也会自动更新。

① 复制这行,贴到 PowerShell,按 Enter

贴到 PowerShell
irm https://claude.ai/install.ps1 | iex

等它跑完(大约几十秒到几分钟),看到安装完成的讯息就好了。

⚠️ 如果看到 'irm' is not recognized,代表你开到的是 CMD(前面没有 PS)。请改用下面这行:
只有在 CMD 才用这行
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

② 关掉 PowerShell,重新打开一个新的

这一步很重要!旧窗口还「不认识」刚装好的程序,一定要关掉再重开。

③ 检查有没有装成功

贴到 PowerShell
claude --version

如果出现一串版本号,例如 2.x.x (Claude Code),恭喜你装好了 🎉

如果显示「无法识别 claude」,请跳到最下面的 ❓ 出问题了。

④(推荐,可选)安装 Git for Windows

不装也能用。装了之后 Claude 在 Windows 上执行指令会更顺(它会用 Git Bash)。

贴到 PowerShell
winget install --id Git.Git -e

如果 winget 不能用,也可以到 git-scm.com/downloads/win 下载,一直按「Next」装完即可。装完一样要重开 PowerShell。

2

第一次使用 Claude Code

Claude Code 会在「你所在的资料夹」里工作。所以我们先开一个专门练习用的资料夹,很安全。

① 建立练习资料夹,并进入它

贴到 PowerShell
mkdir "$HOME\my-first-claude" -Force
cd "$HOME\my-first-claude"

完成后,前面会变成 PS C:\Users\你的名字\my-first-claude>。

📁 这个资料夹在:C:\Users\你的名字\my-first-claude。以后每次要练习,先打开 PowerShell,再贴上面第二行 cd ... 就能回来。

② 启动 Claude

贴到 PowerShell
claude

第一次启动会问你几件事,照着做就好:

  1. 选颜色主题:用方向键 ↑↓ 选一个,按 Enter
  2. 选登录方式:选用 Claude 账号(订阅)登录
  3. 浏览器会自动打开:登录你的 Claude 账号,按「授权 / Authorize」
  4. 回到 PowerShell,看到登录成功,按 Enter 继续
  5. 问你「是否信任这个资料夹」:选 Yes(这是你自己的练习资料夹,安全)

最后看到一个输入框,就代表你已经在和 Claude 对话了!

③ 说第一句话

贴到 Claude
你好!我是第一次用 Claude Code 的初学者。请用简单的中文,用 3 句话告诉我你能在这个资料夹里帮我做什么。

④ 让 Claude 帮你建立第一个文件

贴到 Claude
请在这个资料夹建立一个 hello.txt,内容写「我今天开始学习 Claude Code!」再加上今天的日期。
🔐 Claude 问你「要不要允许」时怎么办? Claude 要建立或修改文件、执行指令前,会先问你。看清楚它要做什么,没问题就选 Yes。这是保护你的机制,不用担心。

完成后,你可以打开「文件总管」进到 my-first-claude 资料夹,就会看到 hello.txt 了。

⑤ 记住几个常用按键和指令

在 Claude 里输入 / 按下作用
/help查看帮助
/clear清空对话,重新开始一个新话题
/skills查看你有哪些 Skill(第 4 部分会用到)
/memory打开 CLAUDE.md 来编辑(第 3 部分会用到)
Esc让 Claude 停下来(它做错方向时很好用)
/exit 或连按两次 Ctrl+C离开 Claude,回到 PowerShell
输入 /会跳出所有可用指令的清单
3

写你的第一个 CLAUDE.md

CLAUDE.md 就是给 Claude 看的「备忘录 / 说明书」。Claude 每次在这个资料夹启动,都会自动先读它,所以你不用每次重复交代同样的事。

📄 项目的 CLAUDE.md放在资料夹里(例如 my-first-claude\CLAUDE.md)
只在这个资料夹有效。
👤 个人的 CLAUDE.md放在 C:\Users\你的名字\.claude\CLAUDE.md
所有资料夹都有效(例如「永远用中文回答」)。

方法 A(最简单):让 Claude 帮你写

在 Claude 里贴上这段(可以先把「关于我」改成你自己的情况):

贴到 Claude
请在这个资料夹建立一个 CLAUDE.md,内容用简体中文,包含以下规则:
1. 关于我:我是程序初学者,使用 Windows 电脑。
2. 永远用简体中文回答我。
3. 解释要简单,少用专业术语;用到术语时顺便用一句话解释。
4. 要执行指令或修改文件之前,先用一句话告诉我你要做什么、为什么。
5. 回答尽量简短,重点先说。
写完后,请把 CLAUDE.md 的内容显示给我看。

方法 B(自己动手写,更有学习感)

先输入 /exit 离开 Claude,然后在 PowerShell 贴上:

贴到 PowerShell
notepad CLAUDE.md

记事本问「要建立新文件吗?」按 是。然后把下面整段贴进去,按 Ctrl+S 保存:

贴到记事本
# 我的练习项目

## 关于我
- 我是程序初学者,使用 Windows 电脑。
- 我正在学习 Claude Code。

## 回答规则
- 永远用简体中文回答。
- 解释要简单,少用专业术语;用到术语时顺便用一句话解释。
- 回答尽量简短,重点先说。

## 做事规则
- 执行指令或修改文件之前,先用一句话告诉我要做什么、为什么。
- 建立的文件都放在这个资料夹里。
💡 CLAUDE.md 写法小秘诀
  • 用 # 当标题,用 - 列点,这种格式叫 Markdown。
  • 写「事实」和「规则」,一句一件事,短短的最好。
  • 不要写太长:Claude 每次都会读它,太长反而浪费。

测试:Claude 有没有读到?

重新启动 Claude(在 PowerShell 输入 claude),然后贴上:

贴到 Claude
你从 CLAUDE.md 知道了关于我的哪些事情和规则?请列出来。

如果 Claude 正确说出你写的规则,就成功了 ✅ 以后想修改,在 Claude 里输入 /memory 就能打开编辑。

🚀 进阶小知识:以后你有真正的程序项目时,在项目资料夹里启动 Claude,输入 /init,Claude 会自动读你的项目,帮你生成一份 CLAUDE.md。

(可选)建立「个人」CLAUDE.md,让所有资料夹都用中文

贴到 PowerShell
mkdir "$HOME\.claude" -Force
notepad "$HOME\.claude\CLAUDE.md"
贴到记事本
# 我的个人偏好
- 永远用简体中文回答我。
- 我是初学者,请用简单的方式解释。
4

写你的第一个 SKILL.md

Skill(技能)就是一份「做某件事的步骤说明书」。你把常常要交代的做法写成 Skill,之后只要打 /技能名称 就能叫出来,Claude 也会在适合的时候自动使用它。

📄 CLAUDE.md= 永远记得的规则
每次都会读(例如:说中文)
🧩 SKILL.md= 需要时才拿出来的做法
用到才读(例如:怎么解释一个概念)
📦 Skill 的规定位置:每个 Skill 是一个资料夹,里面放一个 SKILL.md。
个人 Skill 放在:C:\Users\你的名字\.claude\skills\技能名称\SKILL.md(所有资料夹都能用)
资料夹名称就是指令名称,例如资料夹叫 simple-explain,就用 /simple-explain 叫它。名称建议用英文小写 + 横线。

① 了解 SKILL.md 的两个部分

  • 上半部(两条 --- 之间):告诉 Claude 这个 Skill「是什么、什么时候用」。最重要的是 description。
  • 下半部:具体的步骤和规则,就像写给助理的工作说明。
⚠️ 第一行一定要是 ---,前面不能有空行或空格,否则 Claude 读不到上半部的设定。

② 建立 Skill 资料夹,并打开记事本

先在 Claude 里输入 /exit 回到 PowerShell,然后贴上:

贴到 PowerShell
mkdir "$HOME\.claude\skills\simple-explain" -Force
notepad "$HOME\.claude\skills\simple-explain\SKILL.md"

记事本问「要建立新文件吗?」按 是。

③ 把这段贴进记事本,按 Ctrl+S 保存

贴到记事本
---
name: simple-explain
description: 用超级简单的中文解释任何概念。当用户说「简单解释」「我听不懂」「用白话讲」「什么是…」时使用。
---

# 简单解释

请用下面的格式解释用户问的概念:$ARGUMENTS

1. **一句话说明**:用小学生也听得懂的一句话说明它是什么。
2. **生活比喻**:用一个日常生活的例子来比喻。
3. **一个小例子**:举一个真实、具体的例子。
4. **记住这个**:最后用一句话总结重点。

规则:
- 全程使用简体中文。
- 不要使用没解释过的专业术语。
- 整个回答不超过 200 字。
💡 $ARGUMENTS 是一个「空格」:你打 /simple-explain 什么是API 时,「什么是API」就会自动填进这里。

④ 测试你的 Skill

回到练习资料夹,重新启动 Claude:

贴到 PowerShell
cd "$HOME\my-first-claude"
claude

测试 1:直接叫它

贴到 Claude
/simple-explain 什么是 API

测试 2:让 Claude 自己判断要不要用

贴到 Claude
我听不懂什么是「终端机」,可以用白话讲给我听吗?

如果回答是「一句话说明 → 生活比喻 → 小例子 → 记住这个」的格式,就代表 Skill 成功运作了 🎉

也可以输入 /skills 看看清单里有没有 simple-explain。

⑤(挑战)让 Claude 帮你做第二个 Skill

学会原理后,也可以请 Claude 帮你写。贴上这段试试看:

贴到 Claude
请帮我建立一个个人 Skill,位置是 ~/.claude/skills/daily-plan/SKILL.md。
功能:当我输入 /daily-plan 加上今天要做的事情时,帮我整理成「最重要的 3 件事、其他事项、建议的时间安排」三个部分。
要求:SKILL.md 开头要有 name 和 description,description 用中文写清楚什么时候使用;内容用简体中文,简短清楚。
建立完成后,把 SKILL.md 的完整内容显示给我看,并解释每一部分的作用。

完成后测试:

贴到 Claude
/daily-plan 写报告、回邮件、去超市、学 Claude Code、运动 30 分钟
❓

出问题了怎么办

输入 claude 显示「无法识别」或 not recognized

1. 先确定你已经关掉并重开 PowerShell。
2. 还是不行的话,贴上这行,把安装位置加进系统路径:

贴到 PowerShell
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")

3. 再关掉并重开 PowerShell,输入 claude --version 检查。

想检查安装状况是否健康

贴到 PowerShell
claude doctor

它会列出安装状态和问题,并给出修正建议。

登录失败,或说没有权限使用

请确认你的 Claude 账号是 Pro 或以上(免费版不能用 Claude Code)。在 Claude 里输入 /login 可以重新登录。

Skill 没有出现 / 没有被使用

  • 检查路径是不是 .claude\skills\simple-explain\SKILL.md(中间要有 skills 这层资料夹)。
  • 文件名要是 SKILL.md,不能变成 SKILL.md.txt。
  • 第一行一定要是 ---。
  • 自动触发不灵的话,把 description 写得更清楚,加上你平常会说的关键字;或直接用 /simple-explain 叫它。

用这行检查文件在不在:

贴到 PowerShell
Get-ChildItem "$HOME\.claude\skills" -Recurse

万能方法:直接问 Claude

贴到 Claude
我是初学者,刚刚遇到这个问题:(把错误讯息贴在这里)。请用简单的中文告诉我是什么意思、要怎么解决。