Claude Code 基础使用完整指南：从启动到精通的实战手册
输入“/”快速插入内容
Claude Code 基础使用完整指南：从启动到精通的实战手册
Claude Code 基础使用完整指南：从启动到精通的实战手册
用户6572用户657210月4日修改
2月12日创建
4864
10222
5
0
课程信息
•
作者：老金
•
•
公众号：老金带你玩AI
•
X（Twitter）：老金带你玩AI
•
•
预计学时：4-6小时
•
难度等级：⭐ 零基础入门
•
更新日期：2026年10月3日
•
适用版本：Claude Code v2.1.270 为 2026-09-14 的历史参考；截至 2026-10-03 的新增行为按正文标注版本与官方文档
•
前置要求：已完成Claude Code安装
先修一个小 Bug：空任务列表为什么显示 NaN
项目看板里，完成 2 项、共 4 项，应显示 50%。可新建项目还没有任务时，页面却显示 NaN%。先用这个小问题练一遍：把错误交给 Claude，检查它改了哪里，再亲眼看到测试通过。
已装好并登录 Claude Code 后，给自己留一小段练习时间。这个样例只需要 Node.js，不需要安装 npm 依赖；先在终端运行 node --version 确认环境可用。还没有 Node.js，可以先做下一节的项目只读分析，等运行环境备好再回来。
准备两份练习文件
progress.cjs：
代码块
// 教学样例：故意保留空列表时的 Bug，请按课程修复。
function progressPercent(completed, total) {
return Math.round((completed / total) * 100);
}
module.exports = { progressPercent };
progress.test.cjs：
代码块
const assert = require('node:assert/strict');
const { progressPercent } = require('./progress.cjs');
assert.equal(progressPercent(2, 4), 50, '完成一半时应为 50');
assert.equal(progressPercent(0, 0), 0, '空列表时应为 0');
assert.equal(progressPercent(4, 4), 100, '全部完成时应为 100');
assert.equal(progressPercent(1, 3), 33, '百分比应四舍五入到整数');
console.log('progress checks passed');
先看到失败，再让 Claude 修
在这个练习目录打开终端，先运行：
代码块
node progress.test.cjs
第一次出现 AssertionError 是预期现象：空列表得到 NaN，测试要求的是 0。报错中的路径和行号随你的保存位置变化。
仍在这个目录中运行 claude，把下面的任务交给它：
代码块
这个练习里，空任务列表的进度会变成 NaN。
请先读 progress.cjs 和 progress.test.cjs，运行 node progress.test.cjs 复现问题，
解释原因，再只修改 progress.cjs，把空列表的结果修成 0。
输入都是非负整数，已完成数不超过总数。
保留正常百分比和四舍五入规则，不删除测试、不加依赖、不改其他目录。
修完运行同一条命令，告诉我实际输出、改动位置和原因。
看它给出的改动和命令输出。正常情况下，空列表已经返回 0，2/4、4/4、1/3 仍分别返回 50、100、33，最后看到 progress checks passed。你也可以自己再运行一次，确认文件确实已经改好。
结果不对时，具体指出哪一步