1. Claude Code 快速上手核心指南

Claude Code 快速上手核心指南秀才 2026年6月19日大约 21 分钟 Vibe Coding Vibe Coding AI编程 Claude Code Claude Code教程此页内容 1. 多种使用形态 2. 三个上手实验 2.1 纯对话 2.2 生成一个网页 2.3 写个能跑的小游戏 3. 四种工作模式 4. 基础交互 4.1 三个快捷前缀 4.2 直接贴图片 4.3 救命快捷键 5. 必会的核心命令 6. 权限与安全 7. 一次完整的实战流程 8. 常见问题排查 9. 小结不少人把 Claude Code 装好、跑通了第一次对话，就以为自己会用了，其实离用得顺还差得远——只会一句句地问、一下下地点��认，把一个能自己规划、自己跑命令、自己调试的强力 Agent，用成了普通的问答机器人，白白浪费了它一大半的本事。这一篇是 Claude Code 深入浅出子系列的开篇，目标是把会用这件事彻底打通。读完你会清楚：它有哪几种形态、该用哪个；怎么通过几个小实验快速找到手感；它干活时的几种放手程度怎么切换；那些能让你效率翻倍的快捷前缀和快捷键；日常必会的核心命令；以及把这些串起来的一套真实工作流。内容偏多，但每一块都是天天要用的真功夫，建议跟着动手过一遍。本篇默认你已按环境搭建篇装好 Claude Code（含国内可用性配置）。还没装的，先回去看《Claude Code 安装与配置》那一篇，这里不再重复安装步骤。 1. 多种使用形态很多人以为 Claude Code 就是个命令行工具，其实它有一整套产品形态，同一个账号、同一套能力，可以在好几种入口里用。先认清它们，挑一个最适合你的当主战场。

Claude Code 的多种使用形态形态怎么进入特点适合谁终端 CLI 终端里敲 claude 功能最全、最强大，所有高级能力都基于它想把 Claude Code 用透的人（本系列主力） VS Code 插件 VS Code 扩展市场搜 "Claude Code" 安装在编辑器里侧边栏对话，改动直接显示在编辑器里平时就用 VS Code 写代码的人 JetBrains 插件 IDEA/PyCharm 等插件市场安装同上，融进 JetBrains 系 IDE 用 IntelliJ、PyCharm、GoLand 的人桌面 App 官网下载安装包（macOS/Windows）图形界面，多会话并排管理怕终端、想要图形工作台的人 Web 版浏览器打开 claude.ai/code 打开网页就能用，不装任何东西临时试用、不想装东西的人这五种里，终端 CLI 是绝对的主力 ——它功能最全，本系列后面所有进阶能力（ CLAUDE.md 、命令、MCP、子代理、Hooks、Skills）都是围绕它讲的。VS Code / JetBrains 插件本质上是把 CLI 的能力嵌进了编辑器，习惯在 IDE 里写代码的话用它们很顺手。桌面 App 和 Web 版则是给那些实在不想碰命令行的人留的图形入口。我的建议：把终端 CLI 当主力练熟。终端听着唬人，实际用起来就是打字聊天，半小时就上手；而且只有 CLI 才能完整发挥 Claude Code 的威力。下面的所有讲解，都以终端 CLI 为准。 2. 三个上手实验讲一堆概念不如直接上手玩。下面三个小实验由浅入深，跟着做一遍，你就能对 Claude Code 能干什么、怎么跟它配合，建立起直观的感觉。先在终端里 cd 进任意一个文件夹（空文件夹也行），敲 claude 启动。第一次在某个文件夹启动时，它会问你是否信任这个目录（trust this folder）。确认是你自己的文件夹，选信任即可——这是它的一道安全闸，防止你误在陌生目录里让它乱跑。 2.1 纯对话先别让它写代码，就当个聊天机器人，试试它读不读得懂你的项目。如果你是在一个有代码的文件夹里启动的，直接问：

这个项目是做什么的？用了哪些技术？主要入口在哪个文件？

你会发现一件神奇的事：你根本不用手动把文件贴给它，它会自己去翻文件夹里的文件，然后用中文给你总结项目用途、技术栈、入口位置。这种主动寻找上下文的能力，正是 Coding Agent 和普通问答机器人的本质区别。 2.2 生成一个网页接着让它干点产出。试试让它从零做一个网页：

帮我做一个简洁好看的「番茄钟」网页，纯 HTML+CSS+JS 单文件：
25 分钟倒计时，有开始/暂停/重置按钮，深色背景、大字号显示剩余时间。

它会规划、写代码、把文件创建出来。生成完，你用浏览器打开那个 HTML 文件就能看到效果。下面就是用这条 Prompt 真实跑出来的番茄钟——深色背景、大字号倒计时、进度环、三个控制按钮，一个能直接用的小工具：

Claude Code 生成的番茄钟网页成品这一步让你感受到说一句话就能产出一个能用的东西的效率。 2.3 写个能跑的小游戏最后来个更有成就感的——让它写个小游戏，并且它能自己把环境跑起来：

用 HTML+CSS+JS 写一个 2048 小游戏，单文件就行：
4×4 棋盘，方向键控制合并，右上角显示当前分数和最高分，配色参考经典 2048。
写完直接帮我在浏览器里打开看看效果。

它会写出完整代码，甚至自己执行命令把网页打开。下面就是用这条 Prompt 真实跑出来的成品——一个配色、布局、计分都到位、可以直接玩的 2048：

Claude Code 生成的 2048 小游戏成品三个实验做完，你对 Claude Code 的特点就有数了：它能读懂项目、能从零造东西、还能自己跑命令验证。接下来的内容，都是为了让你把这种配合做得更顺、更高效。 3. 四种工作模式这一节是很多人装完没搞明白、白白浪费一半本事的地方—— 工作模式。 Claude Code 干活时的放手程度是可以调的：是每改一步都要问过你，还是放开手自己干，或者先别动手、先把方案讲给你听。这就是工作模式。它们用一个快捷键 Shift + Tab 循环切换，界面上会实时显示当前在哪个模式。

Claude Code 的工作模式与 Shift+Tab 循环切换模式放手程度行为什么时候用普通模式 / default 最稳每次改文件、跑命令前都停下来问你批准新手默认；做不确定、影响大的操作自动接受编辑 / acceptEdits 中文件编辑自动应用，不再逐个问已经信任它做这类活、不想被频繁打断时 Plan 模式 / plan 只想不做只研究和规划、出方案，绝不动代码复杂任务先让它出方案，确认后再执行（进阶）auto / bypassPermissions 最放飞几乎全自动、跳过大部分确认你非常清楚自己在干什么、且在安全环境里时才用重点说三个常用的。普通模式（default）是默认值，也是最稳的。AI 每次要改文件或跑命令之前，都会把要做的事列出来、停下等你点 Yes 。新手就用它——万一它理解错了、要乱改，你一眼能看到、随时能拦。自动接受编辑模式（acceptEdits）放开一档：它生成的代码编辑会自动落盘，不再一个个弹窗问你。当你已经信任它做某类活儿、不想被反复的确认打断节奏时，切到这个模式会顺畅很多。 Plan 模式（plan）最特别，也最该学会用——它只规划、不动手。你给一个复杂任务，它会先去读项目、想清楚分几步做、可能动哪些文件，然后给你一份详细的实施方案，停在那等你确认，而不是直接开干。

Plan 模式给出实施方案、等待确认为什么 Plan 模式这么重要？因为 AI 最怕理解偏了还一路狂奔——等它把一堆文件改完，你才发现方向错了，回滚都费劲。先让它出方案，你花一分钟扫一眼，对了再放它干，错了当场纠正，成本极低。这是 Claude Code 最值得养成的一个习惯。一套高效的组合拳是这样的：复杂任务先按 Shift+Tab 切到 Plan 模式看方案 → 方案满意后再按 Shift+Tab 切到自动接受模式，放手让它一口气干完。简单的小改动，普通模式直接做就行。至于 auto / bypassPermissions 这种全自动放飞模式，它会跳过几乎所有确认、效率最高，但风险也最大（它可能跑任何命令）。新手阶段不建议用，等你非常熟练、且在隔离/安全的环境里再说。 4. 基础交互跟 Claude Code 打交道，大部分时候就是用大白话对话。但掌握下面几个输入技巧，能让你快出一个量级。 4.1 三个快捷前缀在输入框开头敲不同的符号，会进入不同的模式。这三个前缀是日常最高频的。

Claude Code 的三个快捷前缀 / 斜杠命令 ——开头打 / ，弹出所有可用命令的列表（内置命令、技能、插件命令都在这），用来管理会话、调用功能。下一节专门讲常用的几个。 ! Shell 模式 ——开头打 ! ，后面的内容会作为终端命令直接执行，不经过 AI，而且执行结果会自动进入对话上下文。这点特别妙：

! npm test
! git status
! ls -la src/

你不用切出去再开一个终端窗口，命令跑完的结果会自动进入上下文，Claude 能据此继续判断。比如 ! npm test 后看到几个测试挂了，直接说"把上面失败的测试修一下"，它就知道你指的是哪些。 @ 引用文件 ——打 @ 会触发文件路径自动补全，把项目里某个具体文件精准地交给 AI 当上下文：

参考 @src/utils/format.js 的写法，帮我写一个类似的金额格式化函数
照着 @docs/api.md 里的接口规范，实现 @src/api/user.js 里的用户查询

当你明确知道该看哪个文件时，用 @ 点名比让它自己满项目找要快、要准得多。 4.2 直接贴图片 Claude Code 不只读文字，也能读图，这一点新手很容易忽略。遇到下面几种情况，与其用文字费劲描述，不如直接把图贴进去：程序报错时，把终端或浏览器控制台的报错截图贴给它，让它自己看错误信息和调用栈；想还原一张设计稿，把设计图贴进去让它照着实现页面；页面样式不对，截下当前效果让它对比着改。对小白来说，很多时候你根本说不清问题出在哪，但一张截图就把现场交代清楚了。操作方式是：先用截图工具把图存进剪贴板，回到 Claude Code 输入框按 Ctrl + V 粘贴。这里要特别留意——是 Ctrl + V ，不是 macOS 习惯的 Cmd + V ��只有 iTerm2 等部分终端额外支持 Cmd + V 。粘贴成功后，输入框里会插入一个 [Image #1] 标记，你可以在它前后继续输入文字，告诉它针对这张图做什么，比如"按这张设计稿写一个落地页"或"这个报错怎么解决"。 4.3 救命快捷键除了前缀，下面这些键用熟了，能帮你从各种卡住的情况里脱身。建议把这张表存下来。快捷键作用典型场景 Esc 打断当前动作它跑偏了、或你想中途改主意，按一下立刻停，已做的工作保留 Esc Esc （连按两下）打开回退菜单它把代码改坏了，回退到之前某个时间点 Shift + Tab 循环切换工作模式 default → acceptEdits → plan 来回切 Ctrl + C 中断 / 清空输入强行打断；连按两次退出 Ctrl + B 把正在跑的命令转到后台跑长时间的构建/服务时，腾出手继续聊 Ctrl + O 展开 / 收起执行详情想看清它具体调了哪些工具、跑了什么命令时 Ctrl + R 反向搜索历史输入找回之前敲过的某条 Prompt ↑ / ↓ 翻历史输入复用上一条指令 Tab 接受灰色的输入建议 / 补全快速采纳它猜的下一步 \ + 回车 / Shift + 回车 / Ctrl + J 多行输入要粘一大段需求、不想中途回车发出去这里要特别强调双击 Esc 回退 ——这是 Claude Code 内置的状态回退能力。AI 偶尔会越改越歪，把本来正常的功能改坏，这时不用慌，也不用手动逐个撤销，连按两下 Esc 打开回退菜单，选一个之前的好状态恢复即可。有这道保底，你才敢放手让它去做。还有两个小细节能让输入更省力。其一，输入框里时不时会浮现一行浅灰色的文字，那是 Claude Code 根据你的项目和当前对话猜测的下一步操作，正合你意就按 Tab 或 → 直接采纳，不需要就继续打字、它自动消失。其二，配合 ↑ / ↓ 翻历史、 Ctrl + R 反向搜索，你常用的那几条指令基本不必重复敲。这些键单看不起眼，但每天省下的时间累积起来很可观。 5. 必会的核心命令斜杠命令有几十个，但新手日常高频用到的就那么几个。把下面这张速查表记住，基本够用了。

Claude Code 核心命令速查卡命令作用什么时候用 /help 列出所有可用命令记不清命令时 /clear 清空当前对话、开新会话换不相干的新任务时（高频！） /compact 把长对话压缩成摘要、腾出上下文一个任务聊太久、上下文快满时 /context 可视化当前上下文被什么占用了想知道该不该 clear / compact 时 /init 扫描项目、生成 CLAUDE.md 新项目第一次用、想让它长期记住项目规矩时 /memory 查看、编辑项目的 CLAUDE.md 与自动记忆想调整 AI 长期记住的项目规则时 /permissions 查看和编辑工具权限的允许 / 拒绝列表想固定放行或挡掉某类操作时 /model 切换使用的模型简单活用快模型、复杂活用最强模型 /resume 恢复之前的某次会话想接着昨天那个任务继续聊 /btw 问一个不进入对话历史的临时问题想顺嘴问一句又不想打断当前任务时 /config 打开设置调主题、编辑器模式、自动更新等挑几个最该用熟的细说。 /clear 是新手最该养成的习惯。很多人抱怨 AI 聊着聊着越来越笨，根源就是在一个对话里堆了太多不相干的内容，把上下文塞乱了。只要开始一件和之前无关的新任务，就先 /clear ，把上下文清空、重新开始。这个动作收益极大、成本为零。 /compact 用于长任务续命。如果一个任务确实要长时间持续推进，聊到上下文快满了，敲 /compact ，它会把前面的内容浓缩成摘要、保留关键信息，再接着干，避免丢失前面的关键内容。 /context 帮你判断上下文健康度。它会把当前上下文窗口的占用情况可视化地画出来——系统提示占多少、对话历史占多少、读过的文件占多少、还剩多少空间。当你拿不准是不是该 clear 时，敲它看一眼最直观。

/context 查看上下文占用 /init 是项目第一次用时的标配动作。它会扫描整个项目、自动生成一份 CLAUDE.md 项目说明文件，让 AI 以后一进这个项目就懂它的技术栈和规矩。这个文件极其重要，下一篇会专门展开讲。和它配套的是 /memory ，能列出当前生效的所有 CLAUDE.md 和自动记忆文件、直接打开编辑，是日常管理项目记忆的入口。 6. 权限与安全前面讲的工作模式，控制的是 AI 在改代码、跑命令前要不要停下来问你；而更底层、更细的一层控制，是 Claude Code 的权限系统。把它理解透，你才能既放心地放手，又不至于让它在你不知情的情况下做危险操作。默认情况下，凡是有副作用的操作（写文件、删文件、执行 shell 命令、发起联网请求等），Claude Code 都会先弹出确认框，把它要干什么列清楚，等你批准；只读操作（看文件、搜索代码）一般不打断。这就是为什么你前期会频繁看到要你点允许的弹窗——这是一道安全闸，不是它笨。看懂这一点，你就不会被满屏的确认搞烦，而是知道每一次确认都是一个让你拦截误操作的机会。确认框通常给三种选择：只允许这一次、本次会话内都允许这类操作、以及拒绝。当你已经确认某类操作安全、又要反复用（比如 npm test 、 git status ），选"本次会话都允许"，之后它就不再为这条反复打断你。如果想长期、跨会话地固定一批规则，用 /permissions 命令打开权限设置，把操作写进允许列表（allow）或拒绝列表（deny）。比如把只读的 git status 、 ls 、 npm test 加进允许列表，日常就清净很多；把 rm -rf 、 git push 这类高风险命令放进拒绝列表，等于上了一道硬保险，AI 再想跑也会被挡下。这些规则会写进项目配置文件，团队之间可以共享同一套安全基线。最后强调一条底线：不要图省事就长期开着 bypassPermissions （全自动放飞）模式。它会跳过所有确认，一旦 AI 理解偏差或被外部内容诱导，可能执行你完全不想要的命令。正确的姿势是日常用普通模式或自动接受模式，把高频且安全的操作通过允许列表放行，把危险操作通过拒绝列表挡死，而不是一刀切地全放开。涉及生产环境、密钥、批量删除这些场景，尤其要让它停下来等你拍板。顺带一提，第一次在某个目录启动时它要你确认是否信任，也是同一套思路：只在你信得过的项目里放手，避免在陌生代码里被诱导执行恶意指令。 7. 一次完整的实战流程把上面这些拼到一起，看一次真实的使用流程长什么样——假设你要给一个项目加一个用户登录功能：

# 1. 终端进入项目，启动
cd ~/projects/my-app
claude

# 2. 先让它熟悉项目（实验一那样）
> 这个项目用的什么技术栈？用户相关的代码在哪？

# 3. 复杂功能，先 Shift+Tab 切到 Plan 模式，让它出方案
> 帮我加一个用户登录功能（邮箱+密码），先给我一份分步实施计划，先别写代码

# 4. 看完方案觉得 OK，Shift+Tab 切到自动接受模式，放它干
> 方案没问题，按这个计划实现吧

# 5. 干活中途想跑测试验证（用 ! 前缀，结果它能看到）
> ! npm test

# 6. 有个文件想让它参考着改（用 @ 精准投喂）
> 参考 @src/api/user.js 的错误处理风格，统一一下登录接口的报错

# 7. 发现它某步理解偏了，按 Esc 打断，纠正它
（按 Esc）
> 等下，密码不要明文存，用 bcrypt 加密

# 8. 这个功能做完了，换下一个不相干的任务前，先清空
> /clear

你看，这一套下来，模式（Plan/自动接受）、前缀（ ! / @ ）、快捷键（ Esc ）、命令（ /clear ）各司其职，配合得很顺。这些操作用不了几次就会变成肌肉记忆，到时候你压根不用想该按哪个键，手自己就动了。 8. 常见问题排查 Q：敲 claude 提示 command not found ？装完没重启终端是最常见的原因，关掉终端重开再试；还不行就重启电脑，让系统重新加载环境变量。如果是 npm 装的，确认全局 bin 目录在 PATH 里。 Q：聊着聊着 AI 明显变笨、答非所问？基本都是上下文塞乱了。先 /context 看占用，如果是堆了太多不相干内容，换新任务就 /clear ；如果是同一个大任务聊太长，用 /compact 压缩。养成新任务先 /clear 的习惯，能避免绝大多数这类问题。 Q：它把我的代码改坏了，怎么退回去？两道防线：① Claude Code 内置的——连按两下 Esc 打开回退菜单，恢复到之前的好状态；② 通用的——用 Git， git checkout . 或 git reset 回退（所以前面环境搭建篇才让你一定装 Git）。重要改动前先 git commit 存个档，是最稳的习惯。 Q：它每一步都要我确认是否允许，太烦了？说明你在普通模式。 Shift+Tab 切到自动接受模式，它就不再逐个��文件编辑了。如果是某几条命令反复要确认，更稳的办法是用 /permissions 把这些安全命令加进允许列表，长期放行又不至于全放开（见第 6 节）。但别一上来就用最放飞的 auto 模式，那会跳过所有安全确认。 Q：截图粘贴不进去、或贴了没反应？最常见的原因是按错了键——在大多数终端里贴图是 Ctrl + V ，不是 Cmd + V 。先确认图已经在剪贴板里（用截图工具截取后通常会自动进剪贴板），再回到输入框按 Ctrl + V ，看到 [Image #N] 标记才算成功。个别终端对图片支持不好，换 iTerm2 或在桌面 App 里操作一般就好了。 Q：国内用着卡 / 登录连不上？这是网络和账号的问题，解决办法在《Claude Code 安装与配置》那篇讲过——用国产大模型的 Anthropic 兼容接口（智谱 GLM、Kimi 等）国内直连，回去按那篇配一下即可。 9. 小结这一篇把 Claude Code 的核心用法彻底打通了。回头梳理一下你现在握住的东西：知道了多种使用形态（终端 CLI 为主力）；通过三个实验找到了读项目、造东西、跑起来的手感；搞清了四种工作模式（普通 / 自动接受 / Plan / 放飞， Shift+Tab 切换，复杂任务先 Plan 后执行）；掌握了三个快捷前缀（ / 命令、 ! 跑 shell、 @ 引用文件）、贴图片让它看报错和设计稿、以及一把救命快捷键（尤其双击 Esc 回退）；记住了几个核心命令（ /clear 、 /compact 、 /context 、 /init 等）；理清了权限与安全的边界（用 /permissions 放行安全操作、挡住危险操作，不轻易全放开）；最后用一条端到端工作流把它们串成了肌肉记忆。这些是你天天都要用的基本盘，多用几次就熟了。但要让 Claude Code 真正读懂你的项目、不必每次从头熟悉，光会用还不够——还得给它配上长期记忆，让它一进项目就知道你的技术栈、规范和偏好。把这些基础操作练成肌肉记忆，是你和这个工具长期默契配合的真正起点。关注秀才公众号： IT杨秀才，回复：面试领取后端/AI面试题库PDF

🔥 配套实战项目，拆得开、跑得起、能写进简历多 Agent 编排 + RAG 混合检索 · 31 篇深度教程 + 50+ 面试题点击查看 DevSupport AI 实战项目 → 在 GitHub 上编辑此页上次编辑于: 2026/6/24 23:41:22 贡献者: Percygu 下一页 2. CLAUDE.md 配置与记忆