Claude Code 命令大全小白也能快速上手告别命令混淆如果你最近开始折腾 Claude Code大概率会和我当初一样被一堆命令弄得头昏脑涨一会儿要在终端里敲npm install一会儿要用/clear清空上下文一会儿又被告知可以用!ls直接把命令透传给系统。三套逻辑叠在一起不混淆才怪。我花了一整个周末把 Claude Code 从安装到日常使用完整趟了一遍把踩过的坑、查过的文档、实际用顺手的命令全部整理到了这篇里。这篇文章面向的是“命令行基础一般、但想认真用 Claude Code 干活”的人不是那种已经写了几年代码的老手专属所以我会尽量把话说得直白。读完你至少能搞清楚三件事Claude Code 的命令到底分几层、每一层的核心命令怎么用、以及遇到问题该去哪里查而不是干瞪眼。1. 先搞清楚 Claude Code 是怎么工作的1.1 它不是一个普通的“聊天机器人”Claude Code 是 Anthropic 官方推出的命令行编程助手跑在终端里你通过自然语言和它对话它可以直接读取你项目里的文件、执行终端命令、修改代码。也就是说它不是让你把代码复制粘贴进去问“这里有什么 bug”而是真正能“上手干活”的那种工具。拿我自己的体会说最爽的场景是这样的我盯着一个报错日志看了十分钟没头绪直接问 Claude Code“看一下src/utils/parse.js里split那行为什么在遇到空字符串时会抛错顺便修复它。”它能自己打开文件、定位代码、给出修改建议如果我允许它甚至会直接改完文件让我跑测试验证。想用好它第一步不是背命令而是理解它的运行架构。Claude Code 本质上是一个 Node.js 包安装之后你在终端输入claude命令启动它然后进入一个交互式会话。你的身份、模型、工具权限都由配置和登录状态决定命令只是你操作这个工具的“入口”。1.2 命令混淆的根源三层命令体系我猜很多人和我一样命令混淆不是因为记性差而是因为 Claude Code 里同时存在三套完全不同的“命令”它们长得很像但工作原理完全不一样。第一层是你自己电脑的终端命令比如cd、ls、git status、npm run build。这些是操作系统或软件自带的和 Claude Code 没有关系在终端里就能直接执行。第二层是 Claude Code 的斜杠命令类似/help、/clear、/compact。这些命令以/开头只能在 Claude Code 的交互对话框里输入作用是控制 Claude Code 本身的行为比如清空上下文、压缩历史、查看 token 用量。第三层是把终端命令“透传”给系统执行语法是!加命令比如!git status、!ls -la。!开头的命令在 Claude Code 对话框里输入后会直接丢给你的 shell 执行并把结果带回来。这三层的使用姿势、生效位置、作用对象都不同。很多人搞混是因为看到/clear和!clear长得几乎一样但一个是清空 Claude 的记忆一个是执行系统的clear命令把终端屏幕清干净完全是两码事。这篇就是帮你把这堵墙彻底打通。2. 高频核心命令逐一拆解2.1 斜杠命令Claude Code 的“内部功能开关”斜杠命令是 Claude Code 里最常用也最需要记牢的一批命令因为它们控制着会话本身。新手最容易犯的错误是会话跑着跑着发现 Claude 的“记忆”乱掉了回复质量和上下文严重不符这时候很多人都是一脸懵不知道是该重新启动还是该做什么。其实用对斜杠命令就能解决。我最常用的几个放在一张表里给你看命令作用使用时机/help查看帮助文档和所有可用命令任何时候尤其是卡住时/clear清空当前会话的历史上下文Claude 开始答非所问或跑偏时/compact压缩历史上下文保留核心信息但减少 token 占用长会话后变慢、变“笨”时/init在项目根目录创建 CLAUDE.md 记忆文件第一次进入一个项目时/login登录 Claude 账号首次使用或登录过期时/logout退出登录切换账号时/status查看当前使用的模型、账号、工作模式不确定自己连的是哪个模型时/cost查看当前会话的 token 消耗和费用估算长期会话前、大任务前/config打开或查看配置文件需要调整模型参数、开关权限时/exit退出 Claude Code收工下班时这里最值得展开的是/compact。它的原理不是简单“删掉一些旧对话”而是把当前对话历史浓缩成一段摘要让 Claude 在 token 预算有限的情况下还能记住关键信息。我实测的经验是当会话超过大约 50 轮对话或者贴了大量日志之后响应速度明显下降此时/compact一下效果立竿见影。它适合“还得继续聊下去”的场景而/clear更适合“这个任务已经结束开个新话题”的场景。另外一个容易被忽略的是/init。它会扫描当前项目结构读取已有的配置和代码风格生成一个CLAUDE.md文件作为项目级“记忆”。以后每次启动 Claude Code它都会自动读取这个文件相当于给它一份项目背景说明。第一次进入别人的项目或者自己维护很久的老项目我都会先跑一次/init这比每次手动解释项目背景高效得多。2.2 让 Claude 帮你执行终端命令的正确姿势Claude Code 最有用的能力之一就是能在对话中执行终端命令。但它的执行方式跟你自己在终端里敲命令不一样需要理解两种触发途径。第一种是在对话中用自然语言要求它执行比如你直接说“帮我看看当前目录下有没有正在运行的 Node 进程”它会自动决定执行ps aux | grep node之类的命令并把结果整理给你。第二种是手动用!前缀强制透传比如你在对话框里输入!git log --oneline -5Claude Code 会直接把这个命令扔给 shell 执行然后把输出内容作为上下文的一部分带回来。我个人的习惯是凡是需要“让 Claude 理解这个命令结果并基于它做判断”的场景用自然语言方式让它自己决定执行什么命令、怎么解读输出。凡是“我已经知道要跑什么命令只是懒得切出对话”的场景用!前缀直接透传。两种方式各有各的适用场景别混着用。有一个细节很重要Claude Code 执行有副作用的命令比如删除文件、安装依赖、推送代码时会弹出确认请求你需要主动允许它才会继续执行。这个机制是为了防止 AI 在你不注意的时候乱搞我建议不要图省事一次性批准所有权限因为这相当于把方向盘完全交给了 AI。2.3 文件引用与上下文管理的实用技巧除了斜杠命令和!透传命令日常使用中最高频的操作其实是“让 Claude 看某个文件”。很多新手不知道Claude Code 里可以直接用引用文件输入src/main.js它就能读取这个文件的内容。更妙的是引用目录比如src/components它会递归读取这个目录下的所有文件。我遇到过一个典型场景朋友让我帮他看一个 Vue 项目里的页面为什么渲染空白我第一反应不是打开文件复制粘贴而是直接在 Claude Code 里输入src/App.vue和src/router命令一下Claude 就自动把相关文件读了一遍几秒钟后指出了路由配置的一个问题。这种体验就像多了一个会自动翻代码的助理而不是你自己在十几个文件之间来回切换。上下文管理的核心思路是你喂给 Claude 什么它就基于什么回答。所以每次开始一个重要任务之前我都会先想清楚它到底需要哪些文件用引用进去再明确告诉它“只基于这些文件做分析不要脑补”。这样既控制了 token 成本也避免了它因为上下文太杂而产生幻觉。2.4 常见混淆命令对照表前面说过三套命令容易混淆这里直接给你一个对照表以后不确定的时候就回来查。想做什么用 Claude Code 斜杠命令用终端命令用!透传清空对话上下文/clear无无清空屏幕显示无clear!clear查看当前目录文件在对话中询问ls -la!ls -la查看 git 改动在对话中询问git status!git status删除文件让 Claude 帮你删rm -rf xxx!rm -rf xxx压缩会话历史/compact无无查看命令历史Claude 会话记录history!history一句话总结记忆技巧斜杠命令管的是“Claude 自己”!命令管的是“你的电脑”两者前缀很像但归属完全不同。记住这个底层逻辑混淆问题就解决了一大半。3. 从安装到跑通完整实操记录3.1 环境准备Node.js 安装与版本检查Claude Code 依赖 Node.js 运行所以第一步不是装 Claude Code 本身而是先确认电脑上有没有可用的 Node.js 环境。打开你的终端Windows 上推荐用 PowerShell 或 Windows TerminalmacOS 直接用 Terminal输入node -v npm -v如果两个命令都正常输出了版本号且 Node 版本大于等于 18.0.0那环境就合格了。如果提示“node 不是内部或外部命令”Windows 常见或command not foundmacOS/Linux 常见说明你还没装 Node.js。安装 Node.js 我推荐直接去官网下载 LTS 版本比用各种版本管理工具省心。Linux 用户如果用的是银河麒麟这类基于 deb 的发行版可以直接用sudo apt install nodejs npm安装但版本可能偏旧装完记得用node -v确认一下如果版本不够新还是去官网下二进制包更稳妥。这里有个很多人踩过的坑装了 Node.js 但 npm 全局安装目录不在 PATH 里结果执行claude时提示找不到命令。解决办法是在安装完 Claude Code 后确认 npm 全局 bin 目录已经加入系统 PATHWindows 上一般是AppData\Roaming\npmmacOS/Linux 上一般是/usr/local/bin或~/.npm-global/bin。3.2 安装 Claude Code 的两种方式Claude Code 的官方安装方式很简单核心就是一条 npm 命令npm install -g anthropic-ai/claude-code安装完成后在终端输入claude --version如果能输出版本号就说明安装成功了。首次运行会引导你登录账号按提示操作即可。如果你是 VS Code 用户我强烈建议直接在 VS Code 的集成终端里跑claude这样后续开会话时可以直接对照左边的文件树体验比纯终端好很多。有些网络环境下 npm 下载慢可以考虑先配置国内镜像源再安装npm config set registry https://registry.npmmirror.com配置完再执行安装命令速度会快很多。不过镜像源只影响 npm 包的下载Claude Code 运行时的服务连接走的是它自己的通道两者不要混为一谈。装完之后如果启动时提示需要登录直接用浏览器打开的授权页面完成认证即可。除了 npm 安装官方也提供了原生安装脚本但我个人觉得 npm 方式更通用、更好卸载所以默认推荐 npm。唯一需要多留意的场景是Windows 上如果之前装过老版本建议先卸载干净再装新版否则可能出现命令冲突。3.3 VS Code 集成配置Claude Code 官方支持 VS Code 的深度集成方式就是安装 Claude Code for VS Code 扩展然后直接在 VS Code 的侧边栏打开 Claude Code 面板。这样它能看到你当前打开的文件做代码修改时可以直接在编辑器里展示 diff体验确实比纯终端舒适。不过说实话很多和我一样喜欢轻量工作流的人还是习惯直接开一个终端窗口跑claude。两种方式不冲突扩展适合重度使用、需要可视化 diff 的场景终端适合快速问答、随手改点东西的场景。我的建议是先跑终端方式等觉得不够用了再上扩展不用一上来就把环境搞得很复杂。如果你打算在 VS Code 集成终端里长期使用有几个小配置值得调一下一是把终端字体调成等宽字体比如 Fira Code 或 Cascadia Code否则表情符号和特殊字符会错位二是在设置里把终端滚动缓冲区调大一点因为 Claude Code 的输出通常很长默认 1000 行根本不够翻三是如果终端里中文显示乱码检查 VS Code 的终端编码设置改成 UTF-8 基本能解决。3.4 第三方模型接入DeepSeek、Qwen、GLM 与本地模型很多人找 Claude Code 命令资料其实是冲着“接入其他模型”来的。Claude Code 默认使用 Anthropic 的 Claude 模型但它的架构允许你通过环境变量来切换 API 端点这就给了接入第三方模型的自由度。目前社区里最常用的切换工具是 cc switch可以把它理解为“模型配置的切换器”可视化地管理多套 API 配置一键切换 DeepSeek、Qwen、GLM 等模型的接入。切换的核心原理是设置两个环境变量ANTHROPIC_BASE_URL指向目标模型兼容的 API 地址ANTHROPIC_AUTH_TOKEN填你对应平台的 API Key。设置好之后重启 Claude Code再用/status确认当前连接的模型就能正常对话了。我用过 cc switch 把 Claude Code 切到 DeepSeek 和 Qwen 上实测下来日常代码问答、命令生成这些任务完全够用但复杂项目重构类的任务能力和 Claude 原生模型还是有一截差距。另一个趋势是接入本地模型用 LM Studio 这类工具在本地起一个 OpenAI 兼容的服务然后把ANTHROPIC_BASE_URL指向http://localhost:1234就能让 Claude Code 调用你本地跑起来的模型。好处是数据不出本机、无额外 API 费用坏处是你的显卡显存得够大否则推理速度会慢到让你怀疑人生。4. 高频问题排查与避坑记录4.1 账号登录与订阅状态问题新人最常遇到的一个报错是启动时报错提示组织已禁用 Claude 的订阅访问权限然后无奈挂机。这类问题通常不是 Claude Code 本身的问题而是登录的账号类型不对——你很可能用的是组织托管的团队账号而这类账号需要管理员在后台开通 Claude Code 的权限。解决办法也直接确认自己是不是在用个人账号登录。在 Claude Code 里输入/logout退出当前账号然后重新启动并用个人账号完成登录。登录成功后可以用/status检查账号和订阅状态。如果个人账号也提示订阅受限那就去 Anthropic 官网检查你的订阅是否有效、是否存在欠费等异常状态。没有别的捷径老老实实把账号状态搞清楚就是最快的出路。4.2 命令执行权限与终端卡死用着用着突然什么命令都不响应了这种“卡死”现象我也遇到过。先别急着关窗口试试CtrlC打断当前操作很多时候只是 Claude 在等待你的权限确认只是确认弹窗被输出淹没了你没看见。如果CtrlC无效再输入/exit看能不能正常退出。Windows 用户还有一个常见坑PowerShell 的脚本执行策略默认限制较多可能导致 Claude Code 启动时异常或者执行某些命令时窗口闪退。解决方案是在 PowerShell 里先运行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后重新启动终端。这条命令解决的是本地脚本运行权限问题属于 Windows 开发环境的常规操作。命令行工具频繁闪退的另一个原因可能是杀毒软件拦截了 Node.js 进程的网络请求如果你用的是第三方安全软件不妨先把 Claude Code 相关的进程加入信任列表试试。4.3 系统命令速查从 history 到 telnet 再到 vim很多人搜“Claude Code 命令”时其实真正关心的是干活时高频使用的系统命令比如history命令怎么用、怎么用telnet看 IP 端口通不通、vim 命令怎么退出。我的建议是这类命令不用背让 Claude Code 替你查。比如你想快速看之前执行过的命令直接在 Claude Code 里问“帮我列出最近用的 20 条命令”它就会给你解释history的用法并演示几个组合命令。再比如你想确认某个 IP 的 8080 端口通不通Claude Code 会告诉你用telnet ip port试一下连接成功会显示connected失败会提示超时或拒绝连接。这些场景本质上不是“Claude Code 的命令”而是“借助 Claude Code 提升系统命令效率”的用法。遇到 vim 这种交互式编辑器情况就特殊了。vim 是终端里的全屏交互程序Claude Code 无法替你在对话框里操作它只能给你生成命令和按键说明。“怎么退出 vim”这种地狱级问题Claude 可以轻松回答你先按Esc进入普通模式再输入:wq保存退出。但实际执行还得你自己来别指望它能直接代劳。4.4 上下文过长与 token 消耗控制最后一个高频问题也是很多人用着用着发现“越来越贵”的根源上下文管理和 token 消耗。Claude Code 按 token 计费而每次对话都会把历史记录重新发送给模型对话越长、历史越多单次请求的 token 消耗就越大费用自然水涨船高。我的做法是养成“分会话干活”的习惯。每完成一个独立的小任务就用/clear开启新会话而不是让一个会话从早上开到晚上。遇到大型重构任务先/init生成 CLAUDE.md再用引用关键文件尽量少让 Claude 在无关历史里翻找。每次开始重要操作前输一下/cost看看预估消耗做到心里有数。如果会话已经非常长Claude 的响应开始退化答非所问、遗漏上下文不要硬撑先/compact压缩历史再不行就/clear重开。重开会话时记得把关键结论写进 CLAUDE.md这样哪怕开新会话它也能通过读取记忆文件快速回到状态。5. 一个真实案例从零搭一个命令速查工作流前面说了那么多都是零散知识点。我自己日常是这么把这些东西串起来的你可以直接照搬。每天开工后我习惯先启动 Claude Code跑一次/init确保项目记忆是新的。然后进入目标项目目录把当天要改的关键文件用src/xxx引用进去顺便用!git status看清楚当前工作区状态。接下来就是正常的对话式开发穿插使用/cost监控消耗任务结束用/clear清掉旧上下文。收工时如果有重要的架构结论我会手动更新 CLAUDE.md把当天的决策和原因写进去。这套流程看着简单但真正跑顺之后Claude Code 就不再是一个“偶尔打开的玩具”而是我日常开发里真正的第一助手。你不需要一次把所有命令都学会从安装、/help、/clear、引用这四个点开始一周之内你就能建立起自己的使用节奏。写在最后回头看我刚开始折腾 Claude Code 那会儿也是被一堆命令搅得晕头转向甚至闹过在对话里输入!clear结果把整个终端屏幕清空的笑话。但用久了会发现命令的本质逻辑其实很简单/开头管的是 Claude 自己!开头管的是你的电脑用来喂文件普通对话就是正常聊天。把这个底层框架刻在脑子里之后再看到任何新命令你都能自然地归类到对应的层里而不是越记越乱。最后给一个小建议把 Claude Code 的/help输出完完整整看一遍配合我这篇里的对照表基本就足够应付 90% 的日常场景了。剩下 10% 的边角料命令等你真正遇到那个场景再去查记忆会更牢也更有针对性地解决你的实际问题。
)
