<!-- title: 零基础装通Claude Code造数据清洗器 -->

# Claude Code 入门第一课：从安装到造出你的第一个 CSV 数据清洗器

## 概述

本教程面向**从未用过 Claude Code 的零基础学习者**。你将完成三件事：在自己的电脑上把 Claude Code 装通、跑通第一个会话、并用一句自然语言让它帮你造出一个**真正能用的 CSV 数据清洗器**——能自动去除重复行、补齐缺失值、统一日期格式、导出干净的新文件。学完后你不仅掌握安装与配置，更会拥有"用对话写代码"的核心工作直觉。适合数据运营、产品、测试、转码新手，全程不假设你写过任何代码。

## 前置条件

- 一台 macOS、Linux 或 Windows（WSL）电脑，能联网
- **不会写代码也没关系**——这正是用 Claude Code 的前提
- 终端基本操作：会打开终端、会 `cd` 进入文件夹即可（不会也行，下面会教）
- 一个 Anthropic 账号（Claude 订阅或 Console 账号均可，注册免费）

---

## 第一步：理解 Claude Code 到底是什么

在动手前花一分钟建立正确认知，能省掉后面 90% 的弯路。

**Claude Code 不是又一个 ChatGPT 网页版。** 它是一个跑在你**本地终端**里的 AI 编程助手，能直接读写你电脑上的真实文件、运行真实命令、看到真实报错，然后自己改。你和它的关系不是"问问题"，而是"派活"：你说"把这个文件夹里的 csv 都清洗一下并导出新文件"，它就会真的去做。

```mermaid
flowchart LR
    A[你 打字提需求] --> B[Claude Code 终端]
    B --> C[读你的真实文件]
    B --> D[运行真实命令]
    C --> E[理解任务与上下文]
    D --> E
    E --> F[写代码 / 改代码]
    F --> G[运行验证]
    G --> H{成功?}
    H -->|否| E
    H -->|是| I[交付结果给你]
```

记住这张图：它是一个**会自己试错、自己改、自己验证**的循环，而不是一次性问答机器。理解这一点，你后面就不会因为它"先报错再修好"而慌张——那正是它在干活。

## 第二步：安装 Node.js（Claude Code 的运行底座）

Claude Code 基于 Node.js 运行，官方要求 **Node.js 18.0 或更高版本**，并建议至少 4GB 内存和稳定网络。

**检查是否已安装**，打开终端输入：

```bash
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 源慢，可临时换源 `npm config set registry https://registry.npmmirror.com`，装完再换回。

## 第三步：一行命令安装 Claude Code

在终端执行官方安装命令（全局安装，加 `-g`）：

```bash
npm install -g @anthropic-ai/claude-code
```

等待几十秒到一两分钟，看到一串包名滚过去即完成。

**验证安装**：

```bash
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=...`。

## 第四步：首次认证登录

第一次运行：

```bash
claude
```

你会看到欢迎界面和登录提示。对于 Claude 订阅账号或 Console 账号，按回车后会**自动打开浏览器**完成 OAuth 登录；登录成功后终端会显示已连接。

**预期结果**：终端底部出现输入框（一个 `>` 提示符），光标在闪，说明你已经进入 Claude Code 的交互会话。

**常见问题**：

- **服务器没有图形界面（远程服务器）**：浏览器无法弹出。改用 API Key 方式——在 https://console.anthropic.com 创建 Key，然后 `export ANTHROPIC_API_KEY=你的key`（写入 `~/.bashrc` 持久化），再运行 `claude`。
- **报 529/限流**：偶发的服务端繁忙，等一两分钟重试即可，不是你装错了。

## 第五步：建好你的第一个项目文件夹

Claude Code 的最佳实践是**在具体的项目目录里启动它**，这样它才知道"当前要处理哪些文件"。我们新建一个干净的工作区：

```bash
mkdir ~/csv-cleaner
cd ~/csv-cleaner
claude
```

进入会话后，先做一件很多人忽略却极重要的事——**让它把当前目录看一眼**。直接打字：

```
请看一下当前目录里有哪些文件，告诉我你了解到的项目情况。
```

因为目录是空的，它会告诉你"目录为空，这是一个全新项目"。这步的意义是：确认它确实能访问你的真实文件系统，建立信任。

## 第六步：认识核心交互——斜杠命令与权限

在写正式功能前，掌握 5 个最常用的斜杠命令，它们是你驾驭 Claude Code 的方向盘：

| 命令 | 作用 | 何时用 |
|------|------|--------|
| `/help` | 查看所有命令 | 忘了有什么命令时 |
| `/clear` | 清空当前对话上下文 | 换任务、避免它被旧信息干扰 |
| `/config` | 打开配置面板 | 调主题、模型、权限模式 |
| `/init` | 自动生成项目记忆文件 `CLAUDE.md` | 项目定型后，让它记住你的约定 |
| `/cost` | 查看本次会话花费 | 关心用量时 |

**权限模式**是初学者最容易卡住的地方。Claude Code 默认会在执行**有副作用的操作**（写文件、运行命令）前向你确认。你会在屏幕上看到提示，按 `y` 同意、`n` 拒绝。

新手第一原则：**看不懂的命令先拒绝**。它若真的需要，会换一种更安全的方式或向你解释。绝不要一路按 `y` 到底。

## 第七步：实战——用一句话造出 CSV 数据清洗器

现在进入本课的高潮。先准备一份"脏数据"让 Claude Code 看着改。在**新的终端窗口**（不是会话里）创建一个测试文件：

```bash
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` 你会看到干净、规整的数据。**这就是"用对话写代码"的完整闭环**——你一句中文，它读、写、跑、验全干了。

**常见问题**：

- **它问"是否运行 python"**：这是正常权限确认，按 `y`。若你环境里没有 Python，它会自动改用 Node 或建议你装 Python。
- **报错 `python: command not found`**：部分系统命令是 `python3`。直接回复它"用 python3 重试"，它会自己改。
- **它停下来让你确认每一步**：如果你信任它的操作，可在 `/config` 里把权限模式临时切到 `acceptEdits`（自动接受文件编辑），但**运行命令仍会确认**，这是安全护栏，保留它。

## 第八步：迭代与调试——真正的 AI 协作

第一次的结果通常够用，但真实需求会变。这是体现 Claude Code 价值的地方——你**不需要懂代码**，只需要会提新需求。继续在同一个会话里说：

```
很好。现在再加一个功能：按 status 字段把清洗后的数据拆成两个文件，
paid.csv 和 pending.csv，并在 clean.py 末尾打印每个分组的金额合计。
```

它会**只改动需要改的部分**，复用已有逻辑，再次运行验证。这就是迭代——你像产品经理一样提需求，它像工程师一样实现。

如果它改出 bug（比如金额合计算错），不要自己去翻代码，直接把现象告诉它：

```
paid 组的金额合计不对，应该是 199.5+0+45=244.5，但你算成了别的数，请检查并修复。
```

它会自己定位、自己改、自己重跑。**把报错和现象原样甩给它**，是初学者最该养成的习惯。

## 第九步：固化记忆——创建 CLAUDE.md

当你对 `clean.py` 的行为满意，做一件一劳永逸的事：在会话里输入 `/init`。Claude Code 会扫描项目并生成一个 `CLAUDE.md` 文件，记录"这是一个 CSV 清洗项目、脚本叫 clean.py、用 python3 运行、日期统一为 YYYY-MM-DD"等约定。

你可以手动编辑 `CLAUDE.md` 加上自己的偏好，例如：

```markdown
# 项目说明
本项目用 Python3 清洗销售 CSV 数据。

# 约定
- 日期统一输出为 YYYY-MM-DD
- 缺失金额填 0，缺失姓名填"未知客户"
- 所有输出文件加 cleaned_ 前缀
- 运行命令：python3 clean.py
```

下次你 `cd` 进这个目录再启动 `claude`，它会**自动读取 CLAUDE.md**，瞬间"想起来"这个项目的所有规矩。这是 Claude Code 跨会话记忆的核心机制，越早建立越省事。

```text
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` 打开面板）：

1. **模型选择**：日常清洗、写小工具用默认即可；遇到复杂逻辑可切到更强模型。
2. **主题**：深色/浅色，按喜好。
3. **权限模式**：保持默认 `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 分钟重试 |

---

## 延伸阅读

- **官方快速入门**（最权威的第一手）：https://code.claude.com/docs/en/quickstart
- **官方高级安装**（权限、更新、卸载、原生安装器）：https://code.claude.com/docs/en/setup
- **斜杠命令与交互模式完整文档**：https://code.claude.com/docs/en/slash-commands
- 本系列后续教程将依次进入 **Skills 开发、MCP 服务器、Agent 自动化、高级上下文管理**，由浅入深。

## 训练营适用性评估

- **适合训练营类型**：编程零基础转码营、数据运营/分析训练营、企业数字化提效入门营、AI 工具实操营。
- **不适合**：纯前端框架训练营（需直接进入工程化）、资深算法营（过于基础）。
- **预计教学时长**：**2～2.5 小时**。其中安装与认证约 30 分钟（含排错），首次会话与命令熟悉 30 分钟，CSV 清洗器实战 60–90 分钟（含迭代调试）。
- **教学建议**：讲师提前备好脏数据 `sales.csv` 发给学员，避免现场造数据耗时；分组让学员互相"提新需求"驱动迭代，体会 AI 协作节奏；最后留 15 分钟让学员用 `/init` 固化各自项目记忆，作为结业产出。
- **考核点**：学员能独立 `cd` 进目录、启动会话、用一句自然语言生成并运行清洗脚本、把报错反馈给它修复——四步走通即合格。

## 参考来源

1. [Quickstart - Claude Code Docs](https://code.claude.com/docs/en/quickstart) — Anthropic 官方快速入门，涵盖安装、认证、首次会话的权威步骤。
2. [Advanced setup - Claude Code Docs](https://code.claude.com/docs/en/setup) — 官方高级安装指南，包含系统要求、Node 版本、原生安装器、更新与卸载。
3. [Claude Code Tutorial for Beginners 2026 - dev.to](https://dev.to/ayyazzafar/claude-code-tutorial-for-beginners-2026-from-installation-to-building-your-first-project-1lma) — 2026 初学者从安装到首项目的分步实战教程。
4. [Claude Code CLI Guide: Install, Configure, and Use in 2026 - Petronella Tech](https://petronellatech.com/blog/claude-code-cli-guide/) — 2026 年 Claude Code CLI 完整指南，覆盖模型、权限与配置。
5. [The Complete Claude Code Setup Guide (Spring 2026) - mlearning](https://mlearning.substack.com/p/the-complete-claude-code-setup-guide-from-beginner-to-pro-spring-2026) — 从入门到进阶的 8 步安装配置实践指南。

> [!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 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)