零基础如何用 Claude Code 写第一行代码

步骤一：下载并安装 Claude Code

Claude Code 目前主要在官网提供下载，支持 Windows 和 macOS。打开浏览器，搜索 "Claude Code" 进入官网，找到下载入口，选择和你电脑系统对应的安装包。

下载完成后双击安装，过程和普通软件差不多：点"下一步"、选安装位置、等进度条走完。Windows 用户如果弹出"是否允许此应用对设备进行更改"，点"是"；macOS 用户如果提示"来自互联网的应用"，去系统设置 → 隐私与安全性里点"仍要打开"。

安装完第一次启动，会要求登录。你可以用邮箱注册一个 Anthropic 账号，也可以用已有账号直接扫码。登录成功后，界面主要分成两块：上面是聊天区，你打字提问的地方；下面是终端区，它执行命令和显示结果的地方。看着唬人，其实跟微信聊天加一个黑框终端差不多。

步骤二：授权访问并新建项目文件夹

第一次使用前，Claude Code 会问你是否允许访问本地文件。这一步别怕，它只在当前项目目录里工作，不会乱翻你电脑。点"允许"或"Yes"。

接下来要给它圈一个"工作区"。agent 工具的核心逻辑是：你先指定一个文件夹，它写的新文件都会放在这里，找得着、不乱。

1. 在 D 盘空白处右键 → 新建文件夹，命名为 agent-first-code。

2. 打开命令提示符（按 Win + R，输入 cmd，回车），输入 cd D:\agent-first-code 回车，再输入 claude 回车启动 Claude Code。Mac 用户打开终端，输入 cd /Users/你的用户名/Desktop/agent-first-code 回车，再输入 claude 回车。注意把"你的用户名"换成你电脑的实际用户名。

3. 看到 Claude Code 窗口标题或终端路径显示 D:\agent-first-code（Mac 显示 /Users/你的用户名/Desktop/agent-first-code），就说明当前工作区已切换到该文件夹。

步骤三：用一句话描述需求，让它生成代码

现在可以开始写第一行代码了。不用自己敲，直接跟它说需求。

在聊天框里输入：

帮我写一个 Python 计算器，能输入两个数和运算符，输出结果。文件保存到当前项目文件夹里。

Claude Code 会开始思考，然后做几件事：先检查你电脑有没有装 Python；如果没有，它会提示你去 python.org 下载安装；如果有，它会直接在当前项目文件夹里新建一个 calculator.py 文件，并写入类似下面的代码。

def calculate(a, b, op):

    """根据运算符 op 计算 a 和 b 的结果。"""

    if op == "+":

        return a + b

    elif op == "-":

        return a - b

    elif op == "*":

        return a * b

    elif op == "/":

        if b == 0:

            raise ValueError("除数不能为 0")

        return a / b

    else:

        raise ValueError(f"不支持的运算符: {op}")

生成过程中你可以看到它在终端区执行了哪些命令。我第一次看到它唰唰唰把代码写出来，比自己查半小时文档爽多了。

步骤四：运行程序并看懂结果

代码写完后，让它跑起来验证一下。

在 Claude Code 聊天框输入（数字和运算符直接写在命令后面，空格分开）：! python calculator.py 8 4 "*"

它会直接运行并输出：结果: 8 * 4 = 32

注意运算符 * 要加英文引号（写成 "*"）。在 PowerShell 等终端里 * 会被当成通配符，自动展开成当前目录的文件名，程序就会收到错误内容而报错；加引号就能原样传入。

这种 8 4 * 写法是「命令行参数模式」。之所以不逐行输入数字，是因为 Claude Code 会话里跑程序时键盘输入接不上，会报 EOF when reading a line；把参数写进命令就能绕开（想体验自己敲键盘，在你自己的 cmd 里 cd D:\agent-first-code 后输入 python calculator.py 即可）。

如果提示"Python 没安装"，把报错复制回聊天框问它"怎么解决"，装包时记得勾选 "Add Python to PATH"，关掉重开即可。

步骤五：测一个边界情况，看 agent 替你想到了什么

基础计算跑通后，顺手测一个最容易出错的场景：除数是 0。

在聊天框输入（除法用 ÷ 代替 /，原因见下方注意事项）：! python calculator.py 5 0 ÷

你会看到输出：除数不能为 0

注意，这个"除数为 0 也不崩溃、还给出友好提示"的能力，其实在步骤三生成的代码里已经写好了（就是那一段 if b == 0: raise ValueError("除数不能为 0")）。也就是说，agent 在写代码时就已经替你考虑了这个边界情况。

这正是用 agent 编程省心的地方：你不用把每个坑都提前想清楚。但反过来，养成自己测边界情况的习惯很重要——别因为它"看起来能跑"就完全信它。哪天你让它写更复杂的程序，自己点几个特殊输入（比如空值、超长文本、除零），往往能发现它没考虑到的地方。

如果你想体验"你一句它一句"的迭代，也可以接着让它把提示语换个说法，它会立刻改好。