跳到主要内容

Claude Code完全上手指南

不懂编程也能学会的AI编程工具 | 从0到1掌握Claude Code + 20个实用技巧

Claude Code Terminal

一、为什么我选择Claude Code​

过去几个月，我一直在用Claude Code。

开始我是Cursor的重度用户，小猫补光灯就是用Cursor做的。但试了Claude Code之后，很多场景我更喜欢用它。

我用Claude Code做了什么？

B站和YouTube评论自动回复

之前每天要花1小时逐条回复留言。让Claude Code写了个脚本，自动识别关键词并回复。省下的时间都能再做个视频了。

Paul Graham的100篇文章翻译

理论上写个爬虫更高效。但直接跟Claude Code说"翻译Paul Graham最新100篇文章"，它自己就搞定了。

这种Agent式的工作方式，你不用告诉它每一步怎么做，它自己会规划和执行，确实方便。

想到什么做什么

昨天想做个书单页面，今天想做个倒计时。都能很快搞出来。

为什么选Claude Code？

Claude Code在理解整个代码库、处理复杂任务方面做得更好。

去年大家卷AI IDE，今年突然又都在卷终端工具。Claude Code能起来，很大程度是因为Anthropic有模型优势——可以更"无所畏惧"地给模型投喂代码上下文，不用太担心成本。

用下来的感觉是，它更像一个真正理解你项目的助手，而不只是代码补全工具。

对比一下主流工具

特性Claude CodeCursorGitHub Copilot
运行环境终端IDEIDE
理解范围整个代码库当前文件为主当前文件
工作方式Agent式（自己规划执行）补全+对话补全为主
Git管理✅ 内置支持基础支持❌ 不支持
价格$20/月$20/月$10/月

这篇文章会教你：

  1. 怎么安装（Mac用户，10分钟搞定）
  2. 做第一个网页（完整案例，不会代码也能做）
  3. 20个实用技巧（都是我踩过坑总结的）

强烈建议：在Cursor或VS Code的终端里用Claude Code。

为什么？

因为Cursor本身就是AI助手，安装过程中遇到任何报错，直接问Cursor怎么解决。相当于有个AI在旁边指导你。

二、准备和安装（Mac用户）​

2.1 你需要什么​

系统要求：

  • macOS 10.15+（点击左上角 → 关于本Mac 查看）
  • Node.js 18+（下面教你装）

推荐在哪里操作：

  • ✅ Cursor或VS Code的终端（强烈推荐）
  • ✅ 系统自带终端（也可以）

2.2 快速安装（3步搞定）​

Step 1: 打开终端

在Cursor里：

  • 快捷键：Ctrl+`（反引号键，Tab上面那个）
  • 或者：菜单 Terminal → New Terminal

在系统自带终端里：

  • Cmd+Space 搜索"终端"

Step 2: 安装Node.js（如果还没装）

先检查有没有装过：

node --version

如果看到类似 v20.10.0 的版本号，说明已经有了，跳到Step 3。

如果显示 command not found，需要安装：

方法1：用Homebrew（推荐）

# 如果没有Homebrew，先装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 然后装Node.js
brew install node

方法2：去官网下载

遇到报错？

在Cursor里直接选中报错信息，问："怎么解决？"

Cursor会分析报错，告诉你下一步怎么做。

Step 3: 安装Claude Code

一条命令搞定：

curl -fsSL https://claude.ai/install.sh | bash

回车，等1-2分钟。

会看到一堆文字滚动（这是正常的），最后显示：

✓ Successfully installed Claude Code!

Step 4: 验证

关闭终端，重新打开，输入：

claude --version

看到版本号就成功了。

2.3 第一次启动​

输入：

claude

浏览器会自动打开授权页面。

还没账号：

  1. 点"Sign up"（免费）
  2. 验证邮箱

已有账号：

  1. 登录
  2. 点"Authorize"

回到终端，看到 You: 提示符，就搞定了。

2.4 常见问题快速解决​

Q: 命令找不到（command not found）

  • 关闭终端，重新打开
  • 还不行？问Cursor："claude command not found怎么解决"

Q: Node版本太低

  • 提示需要18+：brew upgrade node

Q: 网络连接失败

  • 检查网络
  • 国内可能需要科学上网工具

Q: 授权页面打不开

  • 复制终端里的链接，手动在浏览器打开

遇到其他问题？

  • 在Cursor里问AI："[把报错信息粘贴这里] 怎么解决"
  • Cursor会根据报错内容给你具体的解决方案

三、第一次使用：做个书单网页​

安装好了，现在来点有趣的。

让AI帮你做一个"我的书单"网页。

不需要会代码，能打字就行。

3.1 创建项目文件夹​

在终端里输入（在Cursor的终端里也一样）：

mkdir my-bookshelf && cd my-bookshelf

这会创建一个叫"my-bookshelf"的文件夹，并进入这个文件夹。

3.2 启动Claude Code​

claude

看到 You: 提示符，表示Claude在等你说话了。

3.3 告诉Claude你想要什么​

复制下面这段话，粘贴到Claude Code里：

请帮我创建一个书单网页：

功能要求：
- 显示5本书的信息
- 每本书包括：书名、作者、评分（1-5星）、简短推荐语
- 书的数据你可以随便编，用一些经典书籍

设计要求：
- 卡片式布局，每本书一个卡片
- 背景用浅色，简洁风格
- 不要紫色或蓝色渐变（太像AI网站了）
- 手机上也要能正常显示

技术要求：
- 用HTML和CSS就够了
- 所有代码放在一个文件里

回车。

3.4 Claude开始工作​

Claude会思考，然后问你：

Can I create this file bookshelf.html? (yes/no)

这是在问："我能创建这个文件吗？"

输入 yes（或 y），回车。

可能还会问几次权限，都说 yes。

为什么要确认？

避免意外修改文件。保护机制。

3.5 打开你的作品​

代码生成好之后，在终端输入：

open bookshelf.html

浏览器会自动打开，你应该能看到一个精美的书单网页！

在Cursor里更方便：

  • 生成的文件会直接出现在Cursor的文件列表里
  • 可以右键文件 → Open in Browser
  • 也可以点击预览

3.6 想修改？继续对话​

不用退出Claude Code，直接继续说：

改颜色：

能把背景色改成淡绿色吗？

调整布局：

能把书的卡片放大一点吗？

修改内容：

把第一本书改成《三体》，作者刘慈欣，评分5星

Claude会继续修改。你说 yes，刷新浏览器页面（Cmd+R），就能看到变化。

想改多少次都可以，直到你满意为止。

3.7 完成​

满意了：

  1. /clear 清空对话
  2. exit 退出

文件会一直在文件夹里。

恭喜，你做出了第一个网页。

四、20个使用技巧​

基础必知（1-8）​

技巧1: 每次新任务用/clear ⭐​

什么时候用：

做完一个项目，要开始新项目。

怎么做：

输入 /clear

为什么重要：

对话历史越长，Claude越容易混乱。

就像你跟一个人聊了10个小时，他会把不同话题搞混。

/clear相当于"清空购物车重新选"。

我的习惯：

  • 做完一个网页，要做另一个 → /clear
  • Python切换到JavaScript → /clear
  • Claude开始"不对劲" → 立即/clear

技巧2: 先规划，再动手​

怎么做：

提示词前加"先制定计划，等我确认后再执行"

或者按两次 Shift+Tab（规划模式）

示例：

You: 先制定计划：帮我做一个博客网站

Claude: 我建议：
1. 首页展示文章列表
2. 文章详情页
3. 关于我页面
4. 导航栏

你觉得怎么样？

You: 可以

Claude: 好的，开始创建...

为什么有用：

避免方向错了做一半才发现。

就像装修房子，先看图纸。

技巧3: 创建CLAUDE.md​

怎么做：

在项目文件夹创建 CLAUDE.md，写上偏好。

示例：

# 项目偏好

## 编码
- 注释用中文
- 变量名要有意义

## 设计
- 配色：蓝绿色系
- 不要紫色渐变

## 技术
- 优先HTML/CSS

为什么神奇：

Claude启动时会自动读取，遵守规则。

不用每次都重复说。

在Cursor里更方便：

  • 直接创建
  • Cursor和Claude Code都能读
  • 团队共享

技巧4: 把Claude当成很快的实习生​

心态调整：

  • ✅ Claude = 很快、记忆力完美的实习生
  • ❌ Claude ≠ 能读懂你心思的老师傅

好的提示词：

帮我创建一个登录页面：
- 需要用户名和密码输入框
- 有一个"登录"按钮
- 背景用浅蓝色 #E3F2FD
- 居中显示，手机端也要好看

不好的提示词：

做个登录页面

原则：

  • 说清楚要什么功能
  • 说清楚要什么样子
  • 举例子（"像淘宝那样"）
  • 说不要什么（"不要复杂动画"）

技巧5: 用Escape停止Claude（不是Ctrl+C）​

常见错误： 按 Ctrl+C → 整个Claude都退出了

正确方法： 按 Escape → 只停止当前任务

额外技巧： 按两次Escape可以查看历史对话列表，可以跳回之前的某个点。

技巧6: /terminal-setup让换行更方便​

问题： 默认按Enter就发送了，想输入多行怎么办？

解决： 运行一次 /terminal-setup

效果：

  • Shift+Enter：换行
  • Enter：发送

只需要设置一次，以后都会这样。

技巧7: 在Cursor里用Claude Code​

组合使用的优势：

可视化编辑：

  • Claude Code生成代码
  • Cursor显示文件树
  • 点击直接查看编辑

双AI协作：

  • Claude Code做大框架、复杂逻辑
  • Cursor做快速补全、细节调整
  • 遇到报错，问Cursor怎么解决

更好的预览：

  • Cursor有内置预览
  • 实时看效果
  • 不用每次打开浏览器

Git管理：

  • Cursor的Git界面友好
  • Claude Code写代码
  • Cursor点击提交

我的工作流：

  1. Cursor打开项目
  2. Cursor终端运行Claude Code
  3. Claude Code生成代码
  4. Cursor查看微调
  5. Cursor提交Git

技巧8: 拖文件和粘贴图片​

拖文件（想让Claude看某个文件）：

  • 按住 Shift
  • 把文件拖到终端窗口
  • 松开

粘贴图片（想让Claude看设计稿）：

  • 复制图片
  • 在Claude Code里按 Ctrl+V（Mac也是Ctrl，不是Cmd）
  • 回车

Claude会"看"到图片并理解内容。

效率提升（9-14）​

技巧9: 用!直接运行命令​

语法：!命令

示例：

You: !ls
（列出当前文件夹所有文件）

You: !pwd
（显示当前路径）

You: !git status
（查看git状态）

为什么有用： 不用退出Claude就能查看文件、检查状态。

技巧10: /doctor检查健康状态​

什么时候用： 感觉Claude怪怪的，不太对劲

做什么： 输入 /doctor

会检查：

  • Node.js版本
  • 网络连接
  • 权限配置
  • Claude Code版本

如果有 ❌，说明这里有问题，按提示解决。

技巧11: 自定义常用命令​

场景： 有些任务经常做，每次都要输入很长的提示词

解决：

  1. 在项目文件夹创建 .claude/commands/ 文件夹
  2. 创建 review.md，内容：
请审查当前代码：
1. 有没有明显的bug
2. 能不能优化
3. 注释是否清楚

使用： 输入 /，选择 review 命令，Claude就会执行审查。

可以创建哪些命令：

  • 代码审查
  • 添加中文注释
  • 优化性能
  • 写测试

技巧12: 用/compact压缩对话历史​

场景： 对话很长了，不想清空，但担心Claude混乱

做什么： 输入 /compact

作用： 总结之前的对话，保留关键信息，删除冗余。

技巧13: 订阅Claude Pro省钱（$20/月）​

对比：

  • 按量付费：根据token计费，可能很贵
  • 包月 Claude Pro：$20/月，高额度

建议：

  • 偶尔用（每周1-2次）：按量付费
  • 经常用（每周3次以上）：订阅

订阅方式： https://claude.ai/upgrade

技巧14: GitHub集成自动审查代码​

设置： 输入 /install-github-app

效果： 每次提交PR，Claude自动审查代码，在PR里留评论。

适合： 团队项目，提高代码质量

进阶技巧（15-18）​

技巧15: 遇到认证问题用/logout​

症状： 提示 "not authorized"

解决：

  1. /logout
  2. exit 退出
  3. 重新运行 claude
  4. 重新授权

技巧16: 跳过权限确认（高手模式）​

⚠️ 新手慎用

问题： 每次都问 yes/no 很烦

解决：

claude --dangerously-skip-permissions

风险： 可能意外修改或删除文件

建议： 熟悉后在小项目上试试，重要项目还是老老实实确认。

技巧17: Extended Thinking深度思考​

场景： 遇到复杂问题

触发方式： 在提示词前加 "think hard"

示例：

Think hard: 帮我设计一个高并发秒杀系统架构

级别：

  • think：基础思考
  • think hard：更深入
  • think harder：非常深入
  • ultrathink：最深入

适合： 复杂架构设计、棘手bug、需要权衡多个方案

不适合： 简单任务（浪费时间和token）

技巧18: 定期检查依赖文件​

背景： Claude有时会添加不必要的依赖

建议： 任务完成后，检查 package.json

怎么检查：

cat package.json

看看 dependencies 里有没有不认识的包。

如果有不需要的：

You: 这个项目真的需要 lodash 吗？能去掉吗？
Claude: 确实不需要，我帮你移除

避坑指南（19-20）​

技巧19: Claude变"不听话"时，/clear一下​

症状：

  • 回答开始重复
  • 理解偏了
  • 开始"胡言乱语"

原因： 对话历史太长，上下文污染

解决： 立即 /clear

预防：

  • 每个新任务都/clear
  • 对话超过20轮考虑/clear
  • 切换项目必须/clear

技巧20: 在Cursor里问AI解决Claude Code的问题​

这是个组合技！

当Claude Code遇到问题时：

  1. 复制报错信息
  2. 在Cursor里选中报错，或者新开对话
  3. 问Cursor："这个错误怎么解决？"
  4. Cursor会分析并给出解决方案
  5. 按方案操作

常见可以这样解决的问题：

  • 安装报错
  • 权限问题
  • Node版本问题
  • Git冲突
  • 依赖安装失败

为什么有效： Cursor理解你的项目环境，能给出更具体的解决方案。

五、常见问题FAQ​

Q1: 安装时提示"Node version too old" A: 需要Node 18+。运行 brew upgrade node 更新，或在Cursor里问AI怎么升级。

Q2: Claude一直问yes/no好烦 A: 用 claude --dangerously-skip-permissions 跳过（新手慎用）。

Q3: 生成的代码质量不好 A:

  • 提示词要详细
  • 创建CLAUDE.md说明偏好
  • 先让它规划再执行

Q4: 网络经常连不上 A: Claude需要稳定网络，考虑用VPN。检查 status.anthropic.com 是否有故障。

Q5: 想恢复之前的对话 A: 按两次Escape查看历史对话列表。

Q6: Claude突然变得不听话了 A: /clear 清空对话，重新开始。

Q7: 能同时用Cursor和Claude Code吗？ A: 可以！很多人这样做：

  • Cursor做快速补全和可视化编辑
  • Claude Code做大型重构和Agent任务
  • 在Cursor的终端里用Claude Code最方便

Q8: 在Cursor里用Claude Code有什么限制吗？ A: 没有限制，完全一样。甚至更方便，因为：

  • Cursor能帮你处理报错
  • 可视化界面更友好
  • Git管理更方便

六、进阶学习资源​

恭喜你走到这里！

你已经学会了Claude Code的基础使用。想继续深入，这里有一些建议：

1. 官方文档（技术向） https://docs.claude.com/en/docs/claude-code/

2. 社区教程（实战向） https://claudelog.com/

3. GitHub仓库（问题向） https://github.com/anthropics/claude-code

4. 我的使用经验

我这几个月用Claude Code做了：

  • 自动化运营：B站/YouTube评论自动回复，省了每天1小时
  • 批量翻译：100篇Paul Graham的文章
  • 快速原型：各种网页demo，想到什么做什么

最大的感受是：Agent式的工作方式确实更适合复杂任务。你不用告诉它每一步怎么做，只要说清楚目标，它自己会规划和执行。

5. 下一步建议

新手（刚学会的你）：

  • 先用3-5个小项目练手
  • 试试不同类型（网页、脚本、数据处理）
  • 每个项目都用上几个新技巧

进阶用户：

  • 学习Prompt工程
  • 研究如何写出更好的提示词
  • 尝试自定义命令
  • 参与Claude社区讨论

七、几句真心话​

用了几个月Claude Code，有些感受想跟你说：

不要期待它懂你的所有想法

Claude虽然聪明，但不是你肚子里的蛔虫。

说清楚想要什么，比期待它"自己看着办"更靠谱。

把它当工具，不是魔法

AI编程能让你更快做出东西。

但不代表什么都不用学、不用想。

你还是需要：

  • 知道自己想做什么
  • 判断Claude做的对不对
  • 发现问题并改进

重要的是你想创造什么

Cursor、Claude Code、GitHub Copilot，都是工具。

重要的不是用哪个工具，而是想创造什么。

当AI能帮你写任何代码，你想创造什么？

好奇心、创造欲、品味，可能才是AI时代的关键。

别让工具绑架了你。

去做点有趣的东西吧。

遇到问题，或者做出了有趣的项目，欢迎在评论区分享。

期待看到你的作品。

说明
  • 基于2025年10月最新功能
  • 所有案例真实测试
  • 20个技巧来自官方文档和社区实践