Claude Code 中文指南
返回实战工坊

Lab · 约 30 分钟

第一个小工具

不依赖现有代码仓库。你将得到一个能在浏览器打开的「今日待办」页面——证明 Claude Code 真的能替你动手,而不只是聊天。

开始前确认

完全零基础?建议先走 零基础新手线

分步操作

步骤 1准备文件夹

在桌面或任意位置新建文件夹,例如 my-first-tool。用终端进入该目录:cd 路径/my-first-tool。这里将成为 Claude Code 的工作区。

步骤 2启动 Claude Code

确认已安装 CLI 并完成模型配置(官方登录或国产 API)。在同一目录运行:claude

步骤 3描述你要做什么

用一句话说清楚目标、技术约束和验收方式。下面是一条可直接复制的提示词。

可复制提示词

请在这个空文件夹里做一个「今日待办」单页小工具:
- 只用 HTML + CSS + 原生 JavaScript,不要框架,不要 npm
- 页面标题:我的今日待办
- 功能:输入框添加待办、点击条目切换完成状态、有一个「清空已完成」按钮
- 样式简洁好看,手机浏览器也能用
- 写完后告诉我如何在浏览器打开 index.html 做验收
先列出你的计划,我确认后再创建文件。

步骤 4审阅计划并批准

Claude 会先给出文件列表和步骤。看清它会创建哪些文件、是否会运行命令。没问题就回复「按方案执行」。有顾虑就要求缩小范围。

可复制提示词

按方案执行。完成后只保留必要文件。

步骤 5逐项确认权限

创建文件、运行命令时终端可能弹出确认。新手建议一律先看清楚再允许,不要开启「全自动跳过权限」除非你很清楚风险。

步骤 6在浏览器验收

完成后用 Finder / 资源管理器双击 index.html,或在终端用 open index.html(macOS)/ start index.html(Windows)打开。自己试:添加、完成、清空是否正常。

步骤 7收尾与复盘

让 Claude 用三句话总结改了什么;若有 CLAUDE.md 可要求写入「本项目是纯静态 HTML 小工具」。下次加功能时上下文更清晰。

可复制提示词

请用三句话总结你创建了哪些文件、各自作用,以及我下次想加「删除单条待办」该怎么描述需求。

常见卡点

  • 命令找不到:回到安装章节检查 PATH,重开终端。
  • 401 / 鉴权失败:检查 API Key 与 Base URL,参考国产模型接入页。
  • 页面空白:让 Claude 打开浏览器控制台报错并修复。
  • 改乱了想重来:删除文件夹内文件(保留空目录),重新描述需求再做一遍。

仍解决不了?截图终端全文,并说明「新手线第几步」,发给 Claude Code 继续排查。

完成后

你已经完成「能跑起来」的闭环。下一步建议做 首次项目接入,把同样方法用到真实 Git 仓库上。

核对日期:2026-05-20