本教程面向从未用过 Claude Code 的零基础学习者。你将完成三件事：在自己的电脑上把 Claude Code 装通、跑通第一个会话、并用一句自然语言让它帮你造出一个真正能用的 CSV 数据清洗器——能自动去除重复行、补齐缺失值、统一日期格式、导出干净的新文件。学完后你不仅掌握安装与配置，更会拥有"用对话写代码"的核心工作直觉。适合数据运营、产品、测试、转码新手，全程不假设你写过任何代码。
cd 进入文件夹即可（不会也行，下面会教）在动手前花一分钟建立正确认知，能省掉后面 90% 的弯路。
Claude Code 不是又一个 ChatGPT 网页版。 它是一个跑在你本地终端里的 AI 编程助手，能直接读写你电脑上的真实文件、运行真实命令、看到真实报错，然后自己改。你和它的关系不是"问问题"，而是"派活"：你说"把这个文件夹里的 csv 都清洗一下并导出新文件"，它就会真的去做。
flowchart LR
A[你 打字提需求] --> B[Claude Code 终端]
B --> C[读你的真实文件]
B --> D[运行真实命令]
C --> E[理解任务与上下文]
D --> E
E --> F[写代码 / 改代码]
F --> G[运行验证]
G --> H{成功?}
H -->|否| E
H -->|是| I[交付结果给你]
记住这张图：它是一个会自己试错、自己改、自己验证的循环，而不是一次性问答机器。理解这一点，你后面就不会因为它"先报错再修好"而慌张——那正是它在干活。
Claude Code 基于 Node.js 运行，官方要求 Node.js 18.0 或更高版本，并建议至少 4GB 内存和稳定网络。
检查是否已安装，打开终端输入：
node --version
v20.11.0（数字 ≥18 即可），跳过本步。command not found，按系统安装：| 系统 | 安装方式 |
|---|---|
| macOS | 浏览器打开 https://nodejs.org 下载 LTS 安装包，或 brew install node |
| Linux | curl -fsSL https://deb.nodesource.com/setup_20.x \| sudo -E bash - 然后 sudo apt install -y nodejs |
| Windows | 安装 WSL（Ubuntu），进入 WSL 后按 Linux 方式装；或官网下载 Windows 安装包 |
预期结果：再次运行 node --version，能看到版本号；运行 npm --version 也能看到版本号（npm 随 Node 一起装好）。
常见问题：
EBADENGINE 警告：说明 Node 版本太低。Claude Code 在低版本上不会直接失败但会报警，请务必升到 18+。npm config set registry https://registry.npmmirror.com，装完再换回。在终端执行官方安装命令（全局安装，加 -g）：
npm install -g @anthropic-ai/claude-code
等待几十秒到一两分钟，看到一串包名滚过去即完成。
验证安装：
claude --version
能看到版本号（如 2.1.x）就说明装通了。
进阶提示：除了 npm，2026 年 Anthropic 还提供原生安装器，无需 Node.js 也能装，命令是
curl -fsSL https://claude.ai/install.sh \| bash（macOS/Linux/WSL）。如果你不想折腾 Node，用这个更省事。本教程后续以 npm 版为准，两者使用完全一致。
常见问题：
EACCES：不要用 sudo 装全局包（会埋下权限坑）。推荐修复 npm 默认目录：mkdir ~/.npm-global && npm config set prefix '~/.npm-global'，再把 ~/.npm-global/bin 加入 PATH。claude 命令找不到：通常是 npm 全局 bin 目录不在 PATH 里。运行 npm config get prefix 找到目录，把其中的 bin 子目录加进你的 ~/.zshrc 或 ~/.bashrc 的 export PATH=...。第一次运行：
claude
你会看到欢迎界面和登录提示。对于 Claude 订阅账号或 Console 账号，按回车后会自动打开浏览器完成 OAuth 登录；登录成功后终端会显示已连接。
预期结果：终端底部出现输入框（一个 > 提示符），光标在闪，说明你已经进入 Claude Code 的交互会话。
常见问题：
export ANTHROPIC_API_KEY=你的key（写入 ~/.bashrc 持久化），再运行 claude。Claude Code 的最佳实践是在具体的项目目录里启动它，这样它才知道"当前要处理哪些文件"。我们新建一个干净的工作区：
mkdir ~/csv-cleaner
cd ~/csv-cleaner
claude
进入会话后，先做一件很多人忽略却极重要的事——让它把当前目录看一眼。直接打字：
请看一下当前目录里有哪些文件，告诉我你了解到的项目情况。
因为目录是空的，它会告诉你"目录为空，这是一个全新项目"。这步的意义是：确认它确实能访问你的真实文件系统，建立信任。
在写正式功能前，掌握 5 个最常用的斜杠命令，它们是你驾驭 Claude Code 的方向盘：
| 命令 | 作用 | 何时用 |
|---|---|---|
/help |
查看所有命令 | 忘了有什么命令时 |
/clear |
清空当前对话上下文 | 换任务、避免它被旧信息干扰 |
/config |
打开配置面板 | 调主题、模型、权限模式 |
/init |
自动生成项目记忆文件 CLAUDE.md |
项目定型后，让它记住你的约定 |
/cost |
查看本次会话花费 | 关心用量时 |
权限模式是初学者最容易卡住的地方。Claude Code 默认会在执行有副作用的操作（写文件、运行命令）前向你确认。你会在屏幕上看到提示，按 y 同意、n 拒绝。
新手第一原则：看不懂的命令先拒绝。它若真的需要，会换一种更安全的方式或向你解释。绝不要一路按 y 到底。
现在进入本课的高潮。先准备一份"脏数据"让 Claude Code 看着改。在新的终端窗口（不是会话里）创建一个测试文件：
cat > ~/csv-cleaner/sales.csv << 'EOF'
order_id,customer,date,amount,status
1001,张三,2024/1/3,199.5,paid
1002,李四,2024-01-04,,paid
1003,王五,2024/1/5,88.0,pending
1001,张三,2024/1/3,199.5,paid
1004,,2024-01-06,45.0,paid
EOF
这份小数据故意埋了 5 类典型脏数据：重复行（1001 出现两次）、缺失值（amount 和 customer 各空一处）、日期格式不统一（2024/1/3 与 2024-01-04 混用）。回到 Claude Code 会话，把下面这段话完整地发给它：
当前目录有一个 sales.csv，请你：
1. 读取它，分析里面的数据质量问题，列给我看；
2. 写一个 Python 脚本 clean.py，完成：去除完全重复的行、把所有日期统一成 YYYY-MM-DD、把缺失的数值填为 0、缺失的名字填为"未知客户"；
3. 运行这个脚本，生成 cleaned_sales.csv；
4. 最后把清洗前后的行数和处理的统计打印出来。
做完后告诉我每个文件的位置。
预期结果：你会看到它依次做了这些事——先 cat 读文件分析问题，再创建 clean.py，向你确认是否允许运行，你按 y，它执行 Python，生成 cleaned_sales.csv，并打印类似这样的统计：
原始行数: 5 去重后: 4 统一日期: 2 处 填充缺失: 2 处
输出文件: /home/你/csv-cleaner/cleaned_sales.csv
打开 cleaned_sales.csv 你会看到干净、规整的数据。这就是"用对话写代码"的完整闭环——你一句中文，它读、写、跑、验全干了。
常见问题：
y。若你环境里没有 Python，它会自动改用 Node 或建议你装 Python。python: command not found：部分系统命令是 python3。直接回复它"用 python3 重试"，它会自己改。/config 里把权限模式临时切到 acceptEdits（自动接受文件编辑），但运行命令仍会确认，这是安全护栏，保留它。第一次的结果通常够用，但真实需求会变。这是体现 Claude Code 价值的地方——你不需要懂代码，只需要会提新需求。继续在同一个会话里说：
很好。现在再加一个功能：按 status 字段把清洗后的数据拆成两个文件，
paid.csv 和 pending.csv，并在 clean.py 末尾打印每个分组的金额合计。
它会只改动需要改的部分，复用已有逻辑，再次运行验证。这就是迭代——你像产品经理一样提需求，它像工程师一样实现。
如果它改出 bug（比如金额合计算错），不要自己去翻代码，直接把现象告诉它：
paid 组的金额合计不对，应该是 199.5+0+45=244.5，但你算成了别的数，请检查并修复。
它会自己定位、自己改、自己重跑。把报错和现象原样甩给它，是初学者最该养成的习惯。
当你对 clean.py 的行为满意，做一件一劳永逸的事：在会话里输入 /init。Claude Code 会扫描项目并生成一个 CLAUDE.md 文件，记录"这是一个 CSV 清洗项目、脚本叫 clean.py、用 python3 运行、日期统一为 YYYY-MM-DD"等约定。
你可以手动编辑 CLAUDE.md 加上自己的偏好，例如：
# 项目说明
本项目用 Python3 清洗销售 CSV 数据。
# 约定
- 日期统一输出为 YYYY-MM-DD
- 缺失金额填 0，缺失姓名填"未知客户"
- 所有输出文件加 cleaned_ 前缀
- 运行命令：python3 clean.py
下次你 cd 进这个目录再启动 claude，它会自动读取 CLAUDE.md，瞬间"想起来"这个项目的所有规矩。这是 Claude Code 跨会话记忆的核心机制，越早建立越省事。
flowchart TD
Start[cd 进项目目录] --> Launch[运行 claude]
Launch --> Read[自动读取 CLAUDE.md 项目记忆]
Read --> Chat[你提需求]
Chat --> Do[读文件/写代码/跑命令]
Do --> Verify{验证通过?}
Verify -->|否| Fix[你甩报错给它 它自修]
Fix --> Do
Verify -->|是| Done[交付结果]
Done --> Iter[你提下一个需求 迭代]
Iter --> Do
Done --> Persist[/init 更新 CLAUDE.md 固化约定]
入门阶段值得调三项配置（用 /config 打开面板）：
default，新手不要开 bypassPermissions（跳过所有确认，危险）。随时用 /cost 查看本次会话的 token 用量与花费，建立"对话不是免费"的直觉，避免无意义地堆砌超长指令。/compact 可在上下文变长时压缩历史，保持响应速度。
| 现象 | 原因 | 解决 |
|---|---|---|
claude: command not found |
npm 全局 bin 不在 PATH | 把 $(npm config get prefix)/bin 加进 PATH |
安装时 EACCES 权限错 |
全局目录无写权限 | 改 npm prefix 到用户目录，勿用 sudo |
EBADENGINE 警告 |
Node < 18 | 升级 Node.js |
| 浏览器登录弹不出 | 远程/无图形界面 | 改用 ANTHROPIC_API_KEY 环境变量 |
| 它反复问权限很烦 | 默认安全模式 | 临时切 acceptEdits，但命令仍会确认 |
| 改一半报错停住 | 真实 Bug 或环境缺依赖 | 把报错原文发回给它，让它自修 |
| 529 / 限流 | 服务端繁忙 | 等待 1–2 分钟重试 |
sales.csv 发给学员，避免现场造数据耗时；分组让学员互相"提新需求"驱动迭代，体会 AI 协作节奏；最后留 15 分钟让学员用 /init 固化各自项目记忆，作为结业产出。cd 进目录、启动会话、用一句自然语言生成并运行清洗脚本、把报错反馈给它修复——四步走通即合格。[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。