夜雨聆风
点蓝色字关注“拓普资源屋”
不需要外网
不需要注册Claude账号
不需要外国手机号短信验证注意：小泓以 Windows 11作为示例进行介绍。
Linux/Mac用户也是类似操作，只是指令不同。
检查是否成功安装 Node.js
打开【终端】或【PowerShell】，在窗口中输入以下命令并回车： node -v- 如果已经安装好了，就会出现版本号 - 如果没有安装，会有提示“不是内部或外部命令” 如果没有安装的话，直接参考以下教程下载，然后一步一步点击就可以实现安装，非常简单：
https://www.runoob.com/nodejs/nodejs-install-setup.html
**我帮你下载了： Node.js 安装包及源码下载地址为：
下载地址：https://pan.quark.cn/s/28c4239287e3
npm -v
npm install -g @anthropic-ai/claude-code
先要获取API密钥 这里以 apiyi 为例（可以用的就是这个中转服务），你可以直接参考以下官方文档，按教程点几下就可以获取密钥： https://docs.apiyi.com/faq/token-management
然后设置环境变量 找到【系统】->【高级系统设置】->【环境变量】->【系统变量】， 点击【新建】添加对应的变量及值。
在用户主目录中创建 ~/.claude.json 文件并添加： {"hasCompletedOnboarding": true}【可选】在 ~/.claude/settings.json 中配置 API 服务： 注意：这里和前面的环境变量配置只取其一即可，否则会出现冲突！ {"env": {"ANTHROPIC_API_KEY": "sk-你的API易密钥","ANTHROPIC_BASE_URL": "https://api.apiyi.com"}}
claude
**终极新手指南（2026年4月版）：
我用 Claude Code 大概有半年了。
最开始以为它就是个聊天框套了个终端皮——原来它能直接读你的代码、改你的文件、跑命令，是真的在帮你干活，不是陪你聊天。
这篇写给刚听说 Claude Code 的人，和用了一段时间但总感觉"没用对"的人。
它到底是什么
Claude Code 是一个装在终端里的 AI 编程工具。
不是网页版 Claude，不是 Copilot，是你在命令行里输一句话，它能去翻你的项目、改代码、跑测试——有文件系统权限那种。
VS Code 插件版也有，功能一样，底层是同一套东西。
装起来
npm install -g @anthropic-ai/claude-code装完跑一下 claude doctor 确认环境没问题。
需要 Anthropic 订阅，claude.com 上付费。装好之后，在任意项目目录输 claude，就进去了。
最核心的操作循环
每次用 Claude Code，本质上都是这个流程：
1.你描述需要什么
2.Claude 分析代码
3.Claude 展示改动 diff
4.你来读这个 diff
5.确认 / 拒绝 / 手动改
6.跑测试
7.提交
第 4 步是最容易被跳过的，也是最不能跳过的。
它给的改动，你不读完就按 y 确认，迟早出事。
怎么说话它才听
新手最常见的问题：说不清楚。
"帮我优化一下这个函数"——Claude 不知道你想要什么，给的结果大概率不对。
换成这个格式效果好很多：
WHAT: 给登录表单加输入校验 WHERE: src/components/LoginForm.tsx HOW: 用 Zod schema，错误信息显示在字段下方 VERIFY: 空邮件显示报错，格式不对显示报错四要素：做什么、在哪里、怎么做、怎么验证。越具体越好。
Context 这件事，必须认真对待
这是新手最快翻车的地方。
Claude Code 有个"上下文窗口"，大约 20 万 token。填满之前没问题，快满的时候它会开始变笨——回答变短、忘事、乱改。
状态栏里有个 Ctx(u): 的数字，就是当前用了多少。
/compact | ||
/clear |
/compact 会压缩历史对话，省出空间。/clear 完全重置，适合换任务。
上下文满了不是速度变慢，是它在撒谎——你以为它在认真改代码，其实它在乱猜。
CLAUDE.md：让它记住你的项目
每次新开会话，Claude Code 什么都不记得。除非你写了 CLAUDE.md。
这个文件放在项目根目录，Claude 每次启动都会读。相当于给它的工作说明书。
最简版本，三件事就够：
# 项目名称 一句话描述这个项目是干什么的。 ## 常用命令 - `pnpm dev` - 启动开发服务器 - `pnpm test` - 跑测试 - `pnpm lint` - 检查代码格式不需要写得很长。只写 Claude 读代码本身发现不了的东西——比如"这个项目用 pnpm 不用 npm"，比如"不要动 legacy 目录下的文件"。
有个研究（ETH Zürich，2026年2月）发现：自己手写的 CLAUDE.md 能提升任务成功率约 4%，但用 /init 自动生成的反而会降低 3%。所以亲自写，写少，写精。
每次 Claude 犯错被你纠正，把这个规则加进 CLAUDE.md——它就永远不会再犯同样的错。这是真正的复利。
几个每天都用得上的命令
/clear | |
/compact | |
/plan | |
/model | |
!git status | |
@文件名 |
/plan 值得单独说一下。复杂改动或者不太确定方向的时候，先进规划模式——Claude 只分析不动代码，你看完计划觉得没问题再让它执行。省了很多"改乱了不知道怎么还原"的麻烦。
还有一个很多人不知道的：按 Shift+Tab 可以循环切换权限模式。
默认模式每次改文件、跑命令都要你确认。如果做的是低风险的重复性任务，嫌烦的话可以切到 acceptEdits 模式——改文件自动通过，只有跑命令还会问你。
还有个 bypassPermissions 模式（也可以启动时加 --dangerously-skip-permissions 参数），改文件和跑命令全部自动通过，不问了。这个主要用在 CI/CD 流水线里，或者你已经很熟悉任务内容、确定没有风险的批量操作。日常开发别开这个，出了问题追悔莫及。
8 个新手必踩的坑
1. 不写上下文就让它干活 — 说清楚 WHAT/WHERE/HOW/VERIFY
2. 不看 diff 就确认 — 每次都要读，哪怕看起来很简单
3. 说话太模糊 — "优化一下"不如"把这个函数的时间复杂度从 O(n²) 降到 O(n)"
4. 无视上下文警告 — 70% 就该 /compact，不要等到失控
5. 动大改动前没提交 — 先 git commit，出了事才有退路
6. 把它当聊天机器人 — 一次只做一件事，用完 /clear 换任务
7. 不建 CLAUDE.md — 每次都要重新介绍项目是在浪费自己时间
8. 什么任务都用 Opus — 简单的改动用 Haiku 或 Sonnet，便宜十倍，效果差不多
模型怎么选
Claude Code 支持切换模型，差别很大：
●Haiku — 便宜快，改名字、写注释、生成模板用这个
●Sonnet — 大多数情况，功能开发、debug、重构
●Opus — 贵但强，架构决策、安全审计、真的想不明白的问题
用 /model sonnet 切换，不用退出重进。
第一周只需要做三件事
1.装好，跑通 claude doctor
2.在一个真实项目里建 CLAUDE.md
3.跑五次完整流程——描述 → 看 diff → 确认 → 验证
第一周别管 MCP、Hooks、Agent 这些高级功能。先把基础用顺了，高级功能自然知道什么时候需要。
以前以为 AI 编程工具都差不多——原来差距主要在你用没用对。
装上，跑起来，先动手再说。
