主题
Claude Code 完全上手指南：最强编程 AI（小白版）
Claude Code 是 Anthropic（Claude 那家公司）出品的编程 AI，被很多程序员认为是目前编程能力最强的工具。它的玩法比 Codex 更"硬核"一点，需要在电脑上敲几行命令。这篇把每一步都拆给完全不懂技术的人看。
Claude Code 由 Anthropic 出品（上方为其官方标识，仅用于指代该产品）
这篇适合谁?（先看一眼，省得白读）
- 愿意折腾一点、想要最强效果 → 往下读。
- 完全不想碰技术、只想处理 Word/Excel/PPT → 别为难自己，直接去看 腾讯 WorkBuddy 指南（国内直接装、不用命令）。
- 第一次接触这类工具、想要更友好的 → 先看 Codex 指南。
老板速览（先把你最关心的答了）
- 要花钱吗? 要。可订阅官方 Claude 套餐，或走国内中转按用量付费（通常可微信/支付宝充值）。价格以官方/渠道最新为准。
- 要会编程吗? 用它干活不用，但装它、配置它需要照着敲几行命令——这就是它比 WorkBuddy 门槛高的地方。本文会一步步带你。
- 要"翻墙"吗? 官方要；走国内中转不用（新手推荐）。
- API key 是什么? 一把"钥匙"，在中转服务网站注册、充值后拿到，填进去它才能用。
- 安全吗? 它能读写你电脑文件、还能执行命令。建议只让它在某个专门的文件夹里干活，别碰重要资料。
- 搞砸了怎么办? 可以设成"每一步都先问你再做"，新手务必这样设；改坏了配合"存档"能退回。
看到不懂的词?先看这张"大白话对照表"（点开）
| 文档里的词 | 说人话就是 |
|---|---|
| 终端 / 命令行 | 电脑里一个黑色的输入框窗口，你在里面打字给电脑下命令（下面教你怎么打开） |
| 命令 | 你复制粘贴到终端、按回车执行的一行字 |
| Node.js / npm | 一个基础软件（Node.js），装好后自带一个安装器（npm），用来安装 Claude Code |
| API / API key | 一把"钥匙"，注册充值后获得，拿着它才能用 AI 服务 |
| 中转 / 代理站 | 官方国内连不上，找个"国内代收点"帮你转一道 |
| 配置文件 | 一个存设置的小文件，你把"钥匙"和"地址"填进去 |
| Plan 模式 | "先让它列计划、你点头、它再动手" |
/clear、/compact | 在它的输入框里打的两个指令（清空、压缩对话） |
| CLAUDE.md | 一个你新建的说明文件，写清项目规矩，它每次先读 |
| Git / 存档 | 像游戏存档，改坏了能退回上一版 |
一、它和普通 AI、和 Codex 有什么不一样
- 不是聊天框，是干活的：它直接读你的文件、改文件、运行命令，全程用大白话指挥。
- 理解整个项目：不是只看你贴的一段，而是能把整个文件夹的内容都"看在眼里"，跨文件改动。
- 能力强、但偏技术：相比对小白更友好的 Codex，它更硬核，但上限更高。Anthropic 自己内部团队大量用它开发产品。
二、先搞懂"终端"——它是这一切的地基
后面装软件都要用到"终端"，先花一分钟认识它：
终端 = 电脑里一个黑色的输入框窗口，你在里面打字（敲命令）来指挥电脑。
怎么打开它：
- Windows（普通电脑）：点开始菜单，搜索 "PowerShell" 或 "命令提示符"，点开，会弹出一个黑/蓝色窗口——这就是终端。
- Mac（苹果电脑）：按
Command + 空格，输入 "终端" 两个字，回车打开。
用法很简单：把命令复制 → 粘贴进这个窗口 → 按回车，就这么三步。下面所有"命令"都这么操作。
三、国内怎么用：四步安装
怕麻烦?有"一键脚本"
claude-code-guide 中文指南 提供了一键安装脚本：把中转服务给你的"钥匙(API key)"和"地址"填进去，它能自动把下面这些步骤跑完。新手强烈建议用它省事。（打开是个英文页面，但里面的中文说明照着走即可；实在不想碰英文页面，就照下面手动四步来，一样能装好。）
如果手动来，四步：
第 1 步：装 Node.js（基础软件） 打开官网 nodejs.org（认准这个网址，别从山寨下载站下），下载安装包，**像装微信一样双击、一路"下一步"**装好。它是 Claude Code 的"地基"。
第 2 步：用命令安装 Claude Code 打开终端（见上一节），把下面这行整行复制粘贴进去，按回车，等它装完：
bash
npm install -g @anthropic-ai/claude-code第 3 步：验证装好没 在终端里输入下面这行回车，如果能显示出一串版本号，就是装成功了：
bash
claude --version第 4 步：填上"钥匙"和"地址" 去你选的国内中转服务网站注册、充值，拿到两样东西：API key（钥匙） 和 接入地址。
填法说白了就是给电脑记两个值（你照着中转服务给的实际值替换即可）：
bash
# 接入地址（中转服务会给你一个网址）
ANTHROPIC_BASE_URL=https://中转服务给你的地址/
# 你的钥匙（一长串字符，别外泄）
ANTHROPIC_AUTH_TOKEN=你的API_key这一步用前面说的"一键脚本"会自动帮你填好，新手不用手动操作。 填好后，在终端输入 claude 回车，就进入 Claude Code 了。
花钱 & 中转安不安全（老板必看）
- 大概花多少：走中转一般是"先充值、按用量扣费"。轻度使用通常一个月几十到一两百元量级（大致量级，需验证）。建议先小额充值（比如几十元）试水，跑顺了再加。
- 怎么选中转、别被坑：优先选有口碑、能开发票、客服在线的服务，别图便宜用来路不明的小站；你的"钥匙"别外泄，等于别人能花你的钱。渠道更新快，本文不写死某一家；拿不准选哪家，加我微信帮你把关。
- 数据安全：你的对话和代码会经过中转服务，别用它处理特别敏感的商业机密；重要资料先别让它碰。
四、用好它的三条核心心法
1. 先让它列计划，你点头它再动手（最重要）
别一上来就让它写。先用 Plan 模式让它把"打算怎么做"讲清楚，你确认方向对了，再放它去执行。活越复杂，这一步越值钱——能避免它朝错误方向猛干半天。
2. 管好"对话"，别让它记太多反而糊涂
AI 的"注意力"有限，对话堆太长反而会变笨。下面这些都是在它的输入框里直接打字输入的指令：
- 一件事干完了，打
/clear回车 → 清空重置，开始下一件事 - 对话太长时，打
/compact回车 → 把关键决定压成摘要，留住重点 - 想让它看某个文件，打
@再选文件 → 比你复制粘贴更准
3. 给项目放一份"说明书"：CLAUDE.md
在你项目最外层的文件夹里，用记事本新建一个文本文件，文件名改成 CLAUDE.md，里面写清楚：这个项目是干嘛的、有什么规矩、不要碰哪些东西。Claude Code 每次都会先读它，相当于给新员工一份入职手册——交代一次，往后省心。
五、典型用法举例
- "帮我在这个网站加一个'联系我们'的表单" → 它读懂现有结构，自己找到该改的文件
- "这个页面在手机上显示错位了，修一下" → 它定位问题、改样式、让你看效果
- "把这个老项目升级一下，别改坏功能" → 跨文件批量处理，还能帮你验证
六、安全 & 搞砸了怎么办（老板必看）
- 新手务必开"每步先问你"：可以把它设成执行关键操作前先征求你同意，你看到不对就别批准。
- 圈定地盘：只让它在某个专门文件夹里干活，别让它满电脑乱动。
- 改坏能退回：配合"存档/历史版本"，可回到上一个好版本。
- 钥匙看好：API key 不要发给别人、不要截图外传。
七、Codex 还是 Claude Code？
| Claude Code | Codex | |
|---|---|---|
| 能力上限 | 公认更强 | 强，对小白更友好 |
| 上手门槛 | 要敲几行命令 | 有专门的小白中文教程 |
| 适合 | 想要最强效果 | 第一次接触这类工具 |
不冲突，预算够两个都装来对比。Codex 看 → Codex 完全上手指南。 完全不想碰命令、只想处理办公文档 → 腾讯 WorkBuddy 指南。
本文内容基于 Claude Code 官方文档、Anthropic 官方最佳实践 与 claude-code-guide 中文指南 整理本地化，配图为本站原创示意图。 安装方式与中转渠道更新较快，请以原指南最新说明为准。