One page. There's no long manual — you're going to have Claude walk you through setup, on your machine, answering your questions as they come up.
就一页。没有长手册。你会让 Claude 在你自己的机器上带你走一遍,边走边答你的问题。
This is the course in miniature. You won't be handed a list of instructions covering every laptop in the world. You'll be interviewed by an AI that figures out which parts apply to you. That's the whole method — you're just meeting it early.
这一页就是这门课的缩本。没有人会给你一份覆盖全世界所有笔记本的说明清单。会有一个 AI 来问你,问出哪几步跟你有关。这就是整套方法,先在你自己身上走一遍。
Set up first, then read why this page works this way. It's the shift the whole course is about, and you'll have just lived it.
先把机器装好,再回来看这一页为什么这么做。那正是这门课要讲的转变,而你刚刚亲身走过一遍。
If you don't already pay for either, buy Claude Pro — about $20/month. It's what your instructor uses, so you'll get faster help. Already paying for ChatGPT? Stay with it.
两个都没在付费的话,买 Claude Pro,一个月二十美元上下。你的老师用的就是它,问起来答得快。已经在付 ChatGPT?那就用 ChatGPT,别买第二份。
claude.com/pricing · chatgpt.com/pricing
On an older Mac, buy Claude. The ChatGPT desktop app requires macOS 14 or newer; Claude requires macOS 13 or newer. Check yours: Apple menu → About This Mac.
Mac 系统旧的话,买 Claude。ChatGPT 桌面版要 macOS 14 以上;Claude 要 macOS 13 以上。查一下:左上角苹果菜单 → 关于本机。
This is your finish line. You check these — not the AI. Five things:
这是你的终点线。验收的是你,不是 AI。五件事:
Go to claude.ai. The free account is fine for this part — you're just talking to it. Start a new chat and paste the whole block below.
打开 claude.ai。这一步用免费账号就够,你只是跟它说话。开一个新的 chat,把下面整段贴进去。
Paste it into a chat at claude.ai — not into a coding app. Coding tools — the Code tab, or a developer tool like Codex — are built to work on projects, not to teach. Give one this and it stops behaving like a patient tutor and starts behaving like an engineer: walls of commands, things typed into a black window, and instructions we did not write.
要贴进 claude.ai 的 chat 里,不要贴进写代码的工具。写代码的工具(Code 那个页签,或者 Codex 这类开发者工具)是为做项目造的,不是为教人造的。把这段给它,它就不再像一个有耐心的老师,开始像一个工程师:一屏一屏的命令、往黑窗口里敲的东西、还有我们没写过的指令。
We tried it in one of them on purpose. It was genuinely bad. A normal chat window is the whole trick.
我们故意拿其中一个试过。结果确实很糟。一个普通的聊天窗口,就是全部诀窍。
Then answer its questions. It will work out which steps apply to your laptop and skip the rest.
然后回答它的问题。它会自己判断哪几步适用于你这台笔记本,其余的跳过。
PASTE THIS INTO A CHAT AT claude.ai — not into a coding app, not into
the Code tab. This is a conversation, not a project.
You are my setup buddy for a course called Vibe Coding 101. I am not
technical.
Your job: get my laptop ready by asking me one question at a time and
walking only the path that applies to my machine. Never send me a long
checklist. Don't describe the paths that don't apply to me.
LANGUAGE
Your very first question is which language I want: English or 中文. Use that
language for everything after it. Whichever I pick, keep tool names, menu
items, buttons, file names and anything I have to type in English, exactly as
they appear on screen — Terminal, Git, my-website, git --version. My laptop
is in English and I have to find these things on it.
YOU ARE A TUTOR, NOT AN ENGINEER
If you have access to files, folders, a terminal, or a code project,
ignore all of it. Do not read files. Do not run commands. Do not inspect
any repository. I am setting up a laptop, not working on a project. If
you catch yourself about to do engineering, stop and ask me the next
question instead.
HOW TO TALK TO ME
- One question at a time. Wait for my answer before the next one.
- Plain English. Explain any jargon right where you use it.
- After each step, ask what I actually see on screen — not "did it work?"
- If I paste an error, explain what it means before telling me what to do.
- If you're not sure, say so and send me to the official page or to my
instructor. A confident wrong answer costs me an hour.
- Never ask me for a password, a card number, or any key or token.
- Only give me a command if it appears under FACTS below. For anything
else, send me to the official page. Never invent an install command,
and never give me anything starting with sudo.
ASK ME FIRST
1. Mac, Windows, or Linux?
2. Which version? (Mac: Apple menu > About This Mac. Windows: press the
Windows key, type winver, press Enter.)
3. Do I already pay for Claude, for ChatGPT, or for neither?
FACTS — use these, don't substitute your own
- I need one paid plan: Claude Pro or ChatGPT Plus, about $20/month.
Claude Code needs a paid Claude plan; the free Claude.ai plan does not
include it. Codex is on every ChatGPT plan including Free, but free tiers
hit rate limits mid-session, so Plus is what the course assumes.
If I have neither, recommend Claude.
- Claude: claude.com/download ChatGPT: chatgpt.com/download
- The ChatGPT desktop app needs macOS 14 or newer. Claude Code needs
macOS 13 or newer, so on a Mac running 13, steer me to Claude.
- Windows needs Git for Windows first (git-scm.com/downloads/win, accept
every default), or the Code tab can't open a folder. Restart the app
after installing it.
- Mac: check Git by opening Terminal and typing git --version
- Linux: Claude has a beta build for Ubuntu and Debian; ChatGPT desktop
has none. Say it's beta and expect rough edges.
- Locked-down work laptop: stop, and tell me to ask my instructor.
DONE means all five of these are true:
paid plan signed in · Git installed · desktop app signed in · a folder on
my Desktop named exactly my-website · I opened that folder in the app,
asked it to make a file, and saw the file appear.
Don't stop before all five. Then tell me I'm done and summarise what I
set up.
Start now with question 1 only.
Why paste all that instead of just asking “how do I install Claude?” Because the block tells it the facts we've already checked, so it isn't guessing at the things that break people — and it tells it to interview you rather than lecture you. That difference is the entire course.
为什么要贴这么一大段,而不是直接问“Claude 怎么装”?因为这段话把我们已经核实过的事实交给了它,它就不必在那些真正卡住人的地方靠猜。而且这段话要求它来问你,不是对你讲课。这个区别,就是这门课的全部。
Anything asks for a password, card number, or key. Setup never needs you to give one to an AI.
任何东西向你要密码、卡号或者密钥。装机这件事,从来不需要你把这些交给 AI。
You're told to paste a command you don't understand and it isn't from one of the official sites above.
有人让你贴一条你看不懂的命令,而且它不是来自上面那几个官方网站。
It's a work laptop and something is blocked. That's usually not fixable — bring a personal machine.
是公司发的笔记本,某个环节被挡住了。这通常修不了,带一台自己的机器来。
You've been stuck on the same step for more than fifteen minutes. Stop. That's what class time is for.
同一步卡了十五分钟以上。停下来。上课时间就是用来干这个的。
Being stuck is not a failure and it is not unusual. Installing software is the ugliest part of this whole course, and it gets easier immediately afterwards. Come to session 1 stuck rather than not coming.
卡住不算失败,也不稀奇。装软件是这门课里最难看的一段,过了这一段马上就好起来。卡着来上第一次课,也比不来强。
This isn't bureaucracy and it isn't a test. Session 1 starts by making a webpage, not by installing software — so if setup didn't work for you, we need to know the evening before, not at ten past the hour with eleven people watching.
这不是走流程,也不是考试。第一次课一上来就是做网页,不是装软件。所以你要是没装成,我们得在前一天晚上知道,而不是开课十分钟后、全班人看着的时候才知道。
Your desktop app, signed in, with my-website open in it. That single picture proves the plan, the install, the sign-in and the folder all at once.
你的桌面 app,已登录,里面开着 my-website。这一张图同时证明四件事:订阅、安装、登录、文件夹。
The page you made, open in your browser. This is the one that actually matters — it's the only proof that you and the agent have successfully done something together.
你做的那个网页,在浏览器里打开的样子。这一张才是真正要紧的。它是唯一的证据,证明你和 agent 一起把一件事做成了。
Add one line while you're there: which did you use — the chat, or the written steps? And if you switched, where?
顺手写一句:你用的是哪一种——聊天,还是写好的步骤?中间换过没有,在哪一步换的?
That single sentence is the only way we find out whether this page actually works. We're running it against the old written manual on purpose, and you're the evidence. It takes you four seconds and it decides what next term's students get handed.
就这一句话,是我们唯一能知道这一页到底管不管用的办法。我们是有意拿它和老版书面手册对着跑的,你就是那个证据。你花四秒钟,决定的是下一批学生看到哪一版。
If you can't send both, send what you have and say where you got stuck. That's a completely normal outcome and it's genuinely useful — it means we can pair you with someone, or hand you a spare laptop, before the session starts instead of losing your first twenty minutes to it.
两张发不齐,就发你有的,再说一句卡在哪儿。这是完全正常的结果,而且真有用:我们可以提前给你配个搭档,或者留一台备用笔记本,不必等到当天。
Silence is the only bad answer. No screenshots and no message means we assume you're ready, and you'll spend session 1 installing while everyone else builds.
只有一种回答是坏的:不回。没有截图也没有消息,我们就当你准备好了;然后第一次课,你在装软件,别人在做东西。
Every other course would have handed you a manual. We handed you a conversation. That difference is worth two minutes of your time, because it's the difference the rest of your working life is about to run on.
别的课会发给你一份手册。我们发给你的是一场对话。这个差别值得你花两分钟看一下,因为你往后的工作,都要靠这个差别来跑。
What you gain: it was written once, checked once, and it says the same thing to everybody. You can read ahead. You can go back. If it's right, it's reliably right.
你得到的:写过一遍,核过一遍,对谁说的都一样。可以往前翻,也可以往回翻。它要是对的,就一直是对的。
What it costs: it has to cover every laptop in the world, so most of it isn't yours — and you do the work of figuring out which parts are. It also starts going stale the day it's printed.
你付出的:它得覆盖全世界的笔记本,所以大部分内容不是给你的——挑出哪几段是你的,这个活归你干。而且从印出来那天起,它就开始过期。
What you gain: one path — the one that fits your machine, your version, your situation. It answers the question the manual never anticipated. Nothing to skim past.
你得到的:只有一条路——合你这台机器、你这个版本、你这个情况的那一条。手册没预料到的问题,它答得上来。没有需要跳过的段落。
What it costs: it can be confidently wrong, and there's no editor between it and you. Made for one, checked by no one.
你付出的:它可能非常笃定地说错,而且它和你之间没有编辑。为一个人做的,没有人复核。
So look at what we still printed. Not the steps — the finish line and the guard rails. That isn't an accident, and it isn't leftovers.
那么看看这一页上我们还是印出来了的东西。不是步骤——是终点线,和那几条红线。这不是随手留下的,也不是剩下的边角料。
Those are precisely the things you'd need in order to catch it being wrong. When the work is made for one person and reviewed by nobody, the check has to come from you — so the check is the part that stays written down. Delegate the route. Keep the destination. You'll do exactly this with your website in session 3.
那恰恰是你用来抓它说错话的东西。一份东西为一个人做、又没有人复核,检查这一步就只能你来做。所以留在纸上的,正是检查的那部分。
We're not describing this shift from a distance. We made the swap on our own course, deliberately, and we'd rather show you the working than pretend it went smoothly.
这个转变不是我们站在旁边描述的。我们在自己的课上真做了这个替换,而且宁可把过程摊开给你看,也不想假装它一路顺利。
The old setup guide covers two operating systems, two vendors, and three different minimum-version rules — and it has to, because it's written for everyone at once. You need exactly one path through that: your laptop, your subscription, your version. It can't tell you which path is yours. You have to sort that out for yourself, at the precise moment you know least about it.
老的装机指南要覆盖两个操作系统、两家厂商、三套不同的最低版本规则。它不得不这样,因为它是一次性写给所有人的。而你只需要其中一条路:你这台笔记本、你这个订阅、你这个版本。它没法告诉你哪一条是你的。这件事得你自己分辨,而且恰好是在你最不懂的那一刻。
But the length wasn't the real problem. The manual contradicted the course. We spend four sessions teaching you to stop hunting through instructions and let an agent work out what applies to you — and then handed you a camera manual on day one. Setup should be the first example of the method, not the exception to it.
但长不是真问题。真问题是那份手册和这门课自相矛盾。我们花四次课教你别再在说明书里翻来翻去、让 agent 去判断哪些跟你有关——然后开课之前,先发给你一份说明书。
We didn't just publish it and hope. We ran the briefing on purpose against the wrong kind of AI — a coding tool with access to files — to see what would break.
我们没有发出去就指望它好。我们故意把这段 briefing 拿去喂了一个不该喂的 AI(一个能读文件的写代码工具)看它会怎么坏。
It broke badly. It stopped asking questions, read our own source code uninvited, produced five commands including one that would have needed an administrator password, and invented a download address we never gave it. Then it signed off with a status code, to someone who'd said they weren't technical.
坏得很彻底。它不再问问题,未经允许读了我们自己的源码,给出五条命令,其中一条需要管理员密码,还编了一个我们从来没给过的下载地址。
We tried to fix that by adding rules to the briefing — twice. Both times it ignored them. So we stopped, because a third attempt at a failing approach is exactly what this course tells you not to do. The problem wasn't the wording; it was the venue. So the fix went where it belonged: the warning above telling you to paste it into a chat window and nowhere else.
我们试着往 briefing 里加规则去堵,加了两次。两次它都不理。于是我们停了,因为“一个办法失败两次还接着来第三次”正是这门课教你不要做的事。问题不在措辞,在场合。所以补救放到了它该在的地方:上面那条“只贴进聊天窗口”的警告。
That is the whole method, done in front of you. Try it → check it honestly → when it fails twice, stop and change the approach rather than nag → write down what you learned. The warning on this page exists because a test failed, not because someone predicted it in a meeting.
这就是整套方法,当着你的面走了一遍。试 → 老老实实验 → 失败两次就停下来换路子,而不是继续催 → 把学到的写下来。这一页上那条警告之所以存在,就是因为这件事真发生过。
Students told us the old manual was easy to follow. That's real evidence, and this page is still a theory. So we're running both — which is why the long version is still one click away.
学生说老手册容易照着做。这是实打实的证据,而这一页目前还只是一个想法。所以两版我们都在跑——长版还留着、点一下就能到,就是这个原因。
Which is where you come in, and we've made it as small as we can: when you send your instructor the two screenshots above, say which one you used and where you switched if you did. That's the whole ask — one sentence, in a message you're already sending.
这就轮到你了,而且我们把它压到最小:给老师发那两张截图的时候,说一句你用的是哪一版,中间换过没有、在哪儿换的。就这一句。
We'd rather ask you once, properly, than put a feedback form on a page nobody fills in. A request with no way to answer it is the same failure this page spends its whole length complaining about.
我们宁可正经问你一次,也不想在页面上挂一个没人填的反馈表。一个没法回答的请求,和这一页从头到尾在抱怨的,是同一种毛病。
Some people would simply rather have the written steps. That's fine — the full guide covers every path, every error message, and both operating systems. It isn't much longer than this page. It's wider: most of it is about laptops that aren't yours, and you're the one who has to work out which parts those are.
有些人就是更愿意看写好的步骤。这没问题——完整版覆盖每一条路径、每一个报错、两个操作系统。它不比这一页长多少,是宽:大部分内容不是给你的。
Session 1 is the first lesson proper — your first webpage, what the permission prompt is really asking, and the five safety rules.
第一次课才是正式的第一课:你的第一个网页、那个授权提示到底在问什么、还有五条安全规矩。