跳至主要内容

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（如果还没装）

先检查有没有装过： CODE_BLOCK_0

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

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

方法1：用Homebrew（推荐） CODE_BLOCK_1

方法2：去官网下载

遇到报错？

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

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

Step 3: 安装Claude Code

一条命令搞定： CODE_BLOCK_2

回车，等1-2分钟。

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

Step 4: 验证

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

看到版本号就成功了。

2.3 第一次启动​

输入： CODE_BLOCK_5

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

还没账号：

  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的终端里也一样）： CODE_BLOCK_6

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

3.2 启动Claude Code​

CODE_BLOCK_7

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

3.3 告诉Claude你想要什么​

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

CODE_BLOCK_8

回车。

3.4 Claude开始工作​

Claude会思考，然后问你： CODE_BLOCK_9

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

输入 yes（或 y），回车。

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

为什么要确认？

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

3.5 打开你的作品​

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

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

在Cursor里更方便：

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

3.6 想修改？继续对话​

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

改颜色： CODE_BLOCK_11

调整布局： CODE_BLOCK_12

修改内容： CODE_BLOCK_13

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（规划模式）

示例： CODE_BLOCK_14

为什么有用：

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

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

技巧3: 创建CLAUDE.md​

怎么做：

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

示例： CODE_BLOCK_15

为什么神奇：

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

不用每次都重复说。

在Cursor里更方便：

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

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

心态调整：

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

好的提示词： CODE_BLOCK_16

不好的提示词： CODE_BLOCK_17

原则：

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

技巧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: 用!直接运行命令​

语法：!命令

示例： CODE_BLOCK_18

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

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

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

做什么： 输入 /doctor

会检查：

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

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

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

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

解决：

  1. 在项目文件夹创建 .claude/commands/ 文件夹
  2. 创建 review.md，内容： CODE_BLOCK_19

使用： 输入 /，选择 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 很烦

解决： CODE_BLOCK_20

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

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

技巧17: Extended Thinking深度思考​

场景： 遇到复杂问题

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

示例： CODE_BLOCK_21

级别：

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

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

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

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

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

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

怎么检查： CODE_BLOCK_22

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

如果有不需要的： CODE_BLOCK_23

避坑指南（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個技巧來自官方文件和社羣實踐