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 的“记忆”乱掉了，回复质量和上下文严重不符，这时候很多人都是一脸懵，不知道是该重新启动还是该做什么。其实用对斜杠命令就能解决。

我最常用的几个，放在一张表里给你看：

这里最值得展开的是/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 -5，Claude 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 自己”，!命令管的是“你的电脑”，两者前缀很像但归属完全不同。记住这个底层逻辑，混淆问题就解决了一大半。

3. 从安装到跑通：完整实操记录

3.1 环境准备：Node.js 安装与版本检查

Claude Code 依赖 Node.js 运行，所以第一步不是装 Claude Code 本身，而是先确认电脑上有没有可用的 Node.js 环境。打开你的终端（Windows 上推荐用 PowerShell 或 Windows Terminal，macOS 直接用 Terminal），输入：

node -v npm -v

如果两个命令都正常输出了版本号，且 Node 版本大于等于 18.0.0，那环境就合格了。如果提示“node 不是内部或外部命令”（Windows 常见）或command not found（macOS/Linux 常见），说明你还没装 Node.js。

安装 Node.js 我推荐直接去官网下载 LTS 版本，比用各种版本管理工具省心。Linux 用户如果用的是银河麒麟这类基于 deb 的发行版，可以直接用sudo apt install nodejs npm安装，但版本可能偏旧，装完记得用node -v确认一下；如果版本不够新，还是去官网下二进制包更稳妥。

这里有个很多人踩过的坑：装了 Node.js 但 npm 全局安装目录不在 PATH 里，结果执行claude时提示找不到命令。解决办法是在安装完 Claude Code 后，确认 npm 全局 bin 目录已经加入系统 PATH，Windows 上一般是AppData\Roaming\npm，macOS/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 命令执行权限与终端卡死

用着用着突然什么命令都不响应了，这种“卡死”现象我也遇到过。先别急着关窗口，试试Ctrl+C打断当前操作，很多时候只是 Claude 在等待你的权限确认，只是确认弹窗被输出淹没了你没看见。如果Ctrl+C无效，再输入/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% 的边角料命令，等你真正遇到那个场景再去查，记忆会更牢，也更有针对性地解决你的实际问题。