Claude Code 完全学习指南：从命令体系到实战应用
如果你正在寻找一份关于Claude Code的详细使用教程，那么这篇文章正是为你准备的。无论你是刚刚接触这个工具，还是已经使用过一段时间但对其命令体系感到困惑，本文都将帮助你建立起清晰的知识框架。
Claude Code是一个功能强大的开发辅助工具，但它的命令体系常常让初学者感到不知所措。本文将基于Claude Code 2.1.74版本，为你梳理出一套完整、清晰、实用的命令地图。
理解Claude Code的命令三层结构
在学习任何工具之前，理解其基本架构是最重要的一步。Claude Code的命令体系实际上只包含三个层次，掌握这个框架后，你就不会再对各种命令感到混乱。
第一层：终端主命令
这是你在Shell（命令行界面）中直接输入的claude，它的作用是“打开程序”。就像你使用git或docker一样，claude是进入这个工具世界的入口。
第二层：终端子命令
这是claude后面跟着的功能菜单，例如claude auth、claude mcp、claude plugins等。这些命令的作用是“管理功能”——配置认证、管理插件、检查系统状态等。
第三层：Slash命令
这是你进入Claude Code交互界面后输入的命令，它们都以斜杠（/）开头，例如/help、/model、/clear等。这些命令的作用是“控制会话”——管理对话上下文、切换模型、查看状态等。
用一句话总结：主命令打开程序，子命令管理功能，Slash命令控制会话。
快速上手：三条最常用的主命令
对于刚接触Claude Code的用户来说，下面这三条命令覆盖了90%的使用场景：
| 命令 | 作用 | 适用场景 |
|---|---|---|
claude |
进入交互式Claude Code会话 | 需要与AI进行多轮对话、逐步完成复杂任务 |
claude -p "你的任务描述" |
非交互模式，执行完直接输出结果后退出 | 适合脚本调用、批处理任务、快速问答 |
claude -c |
继续当前目录最近一次的会话 | 断点续聊，恢复之前未完成的对话 |
这三条命令构成了你使用Claude Code的主要入口。先掌握它们，你就可以开始实际使用了。
主命令的实用参数：按需配置你的体验
当你对基础命令熟悉后，可能需要根据具体任务调整Claude Code的行为。下面这些参数是最常用、最有价值的：
模型与性能控制
- 🍂
--model：指定本次会话使用的模型版本 - 🍂
--effort：控制思考强度，可选值通常包括low、medium、high、max - 🍂
--fallback-model：当默认模型拥堵时，为print模式指定备用模型
权限与安全控制
- 🍂
--permission-mode：指定权限策略，如default、auto、plan、dontAsk - 🍂
--allowed-tools：只允许运行指定的工具 - 🍂
--disallowed-tools：显式禁止某些工具运行 - 🍂
--tools：自定义本次会话可用的工具集合
调试与输出控制
- 🍂
--debug：开启调试模式，查看详细运行信息 - 🍂
--debug-file：将调试日志写入指定文件路径 - 🍂
--verbose：强制开启详细输出模式 - 🍂
--output-format：控制输出格式，可选text、json、stream-json - 🍂
--input-format：控制输入格式，常用于text或stream-json
会话与工作区管理
- 🍂
--add-dir：额外开放更多目录给Claude Code访问，适合跨目录读写 - 🍂
--session-id：手动指定会话ID - 🍂
--fork-session：恢复旧会话时，分叉出一个新会话 - 🍂
--no-session-persistence：不保存会话到本地
对于初学者，建议优先掌握以下五个参数：
-
--model：根据需要选择合适的模型 -
--effort：在简单任务上使用低强度以节省资源 -
--permission-mode：控制工具是否需要你确认才能执行 -
--debug：遇到问题时开启调试 -
--output-format：需要结构化输出时使用json格式
需要谨慎使用的参数
以下参数会直接影响Claude Code的行为边界和安全边界，使用时需要格外小心：
| 参数 | 作用 | 风险提示 |
|---|---|---|
--dangerously-skip-permissions |
跳过所有权限确认 | 工具将自动执行可能影响系统的操作 |
--allow-dangerously-skip-permissions |
允许跳过权限确认 | 相当于授权给AI更大的操作自由度 |
--tools |
自定义可用工具集合 | 可能启用或禁用某些关键工具 |
--system-prompt |
直接覆盖系统提示词 | 改变AI的基础行为模式 |
--permission-mode |
切换权限策略 | 影响AI能做什么、需要什么授权 |
这些参数在特定场景下非常有用，但使用前请确保你理解它们可能带来的影响。
终端子命令详解
除了直接进入交互会话，claude命令后还可以跟各种子命令来管理系统功能。下面是最常见的一级子命令：
claude agents # 列出或管理agents
claude auth # 管理登录状态和账号认证
claude auto-mode # 查看auto mode分类器配置
claude doctor # 检查Claude Code安装和更新器健康状态
claude install # 安装Claude Code原生版本
claude mcp # 管理MCP服务器
claude plugin # 管理插件（也可用plugins）
claude setup-token # 设置长期认证token
claude update # 检查并安装新版本（也可用upgrade）
auth认证命令详解
认证相关命令是你开始使用Claude Code前需要掌握的第一组子命令：
登录与退出
- 🍂
claude auth login：登录你的Anthropic账号 - 🍂
claude auth login --email your@email.com：预填邮箱地址 - 🍂
claude auth login --sso：强制使用SSO单点登录 - 🍂
claude auth logout：退出当前登录的账号
查看认证状态
- 🍂
claude auth status：以人类可读格式显示认证状态 - 🍂
claude auth status --json：以JSON格式显示详细信息
auto-mode命令
auto-mode相关命令主要用于查看自动模式的配置规则，排查问题时特别有用：
- 🍂
claude auto-mode config：查看当前生效的auto mode配置 - 🍂
claude auto-mode defaults：查看默认的auto mode规则
这些命令帮助你理解系统在当前环境下会如何自动选择模式。
系统维护命令
doctor、install、update、setup-token这组命令用于维护Claude Code本身：
检查与诊断
- 🍂
claude doctor：检查安装状态和自动更新器的健康情况
安装与版本管理
- 🍂
claude install stable：安装稳定版本 - 🍂
claude install latest：安装最新版本 - 🍂
claude install 1.2.3：安装指定版本号 - 🍂
claude install --force：即使已安装，也强制重新安装
更新与令牌配置
- 🍂
claude update或claude upgrade：检查更新并安装新版本 - 🍂
claude setup-token：配置长期认证token，适合自动化场景使用
MCP命令详解
MCP（Model Context Protocol）可以理解为Claude Code连接外部工具、服务和上下文的桥梁。通过MCP，你可以让Claude Code访问更多外部能力。
基础MCP命令
claude mcp list # 列出已配置的MCP服务器
claude mcp get <名称> # 查看指定MCP的详细信息
claude mcp add <名称> <命令或URL> # 新增一个MCP服务器
claude mcp add-json <名称> <JSON> # 使用JSON配置添加MCP
claude mcp add-from-claude-desktop # 从Claude Desktop导入MCP配置
claude mcp remove <名称> # 删除指定的MCP服务器
claude mcp reset-project-choices # 重置项目中的MCP批准/拒绝记录
claude mcp serve # 启动Claude Code自己的MCP服务端
MCP添加命令的常用参数
当你使用claude mcp add添加新的MCP时，可以配合以下参数进行精细控制：
| 参数 | 作用 |
|---|---|
--transport |
指定传输方式，常用值：stdio、sse、http |
--env |
为MCP进程注入环境变量 |
--header |
为HTTP连接设置请求头 |
--scope |
指定配置范围：local、user、project |
--client-id |
OAuth场景下使用的客户端ID |
--client-secret |
OAuth客户端密钥 |
--callback-port |
固定OAuth回调端口 |
对于普通用户，最常见的MCP使用场景是：
-
用 claude mcp list查看当前连接了哪些服务 -
用 claude mcp add增加一个新的本地或远程MCP -
用 claude mcp remove删除不再使用的连接
插件命令详解
插件是Claude Code的内部扩展模块，可以通过claude plugin或claude plugins进行管理。
基础插件命令
claude plugins list # 查看已安装插件
claude plugins list --json # 以JSON格式显示
claude plugins list --available --json # 连同市场可安装插件一起显示
claude plugins install <插件名> # 安装新插件
claude plugins enable <插件名> # 启用已安装的插件
claude plugins disable <插件名> # 禁用指定插件
claude plugins disable -a # 禁用全部已启用的插件
claude plugins update <插件名> # 更新指定插件
claude plugins uninstall <插件名> # 卸载插件
claude plugins validate <路径> # 校验插件或marketplace的manifest文件
插件市场管理
插件市场（marketplace）是插件的来源仓库，相关命令如下：
claude plugins marketplace list # 列出已配置的市场
claude plugins marketplace list --json # 以JSON格式显示
claude plugins marketplace add <来源> # 添加一个新的插件市场
claude plugins marketplace remove <名称> # 删除指定的插件市场
claude plugins marketplace update # 更新所有市场
claude plugins marketplace update <名称> # 只更新指定市场
添加市场时常用的参数：
- 🍂
--scope：指定市场定义写入user、project或local哪一层 - 🍂
--sparse：如果来源是monorepo，可以使用稀疏检出只拉取部分目录
交互式Slash命令详解
当你输入claude进入交互式会话后，就可以使用各种以斜杠开头的Slash命令了。这些命令分为几个功能类别，下面分别介绍。
重要提示：不同版本、账号权限、已安装插件和技能会导致具体的命令列表略有差异。以下列出的是本机交互菜单中实际可用的命令。
上下文与会话管理
这类命令帮助你控制对话的进程和状态：
| 命令 | 作用 | 使用场景 |
|---|---|---|
/help |
显示帮助和可用命令列表 | 任何时候需要查看帮助 |
/exit |
退出当前REPL会话 | 完成工作后退出 |
/clear |
清空会话历史，释放上下文 | 对话太长、开始新话题 |
/compact |
压缩上下文，保留摘要 | 上下文接近上限但不想完全清空 |
/resume |
恢复之前的对话 | 继续之前未完成的会话 |
/rewind |
回退到某个历史点 | 对话走偏、想回到之前某步 |
/fork |
从当前点分叉一个新会话 | 想保留当前状态同时探索新方向 |
/rename |
重命名当前会话 | 让会话名称更有意义 |
/copy |
复制Claude最近一条回复或其中的代码块 | 需要把结果粘贴到别处 |
/export |
导出当前对话到文件或剪贴板 | 保存对话记录 |
/diff |
查看未提交变更和每轮差异 | 代码修改前后对比 |
理解这组命令的关键点：
- 🍂
/clear是彻底清空当前上下文，就像新开一个对话 - 🍂
/compact是缩短上下文长度但保留摘要信息，AI仍然记得对话要点 - 🍂
/resume是恢复过去的某个会话 - 🍂
/rewind是退回过去某个检查点，就像时光倒流 - 🍂
/fork是从当前状态开一个分支，不影响原会话
运行环境与界面设置
这类命令控制Claude Code的运行环境和界面表现：
| 命令 | 作用 |
|---|---|
/status |
查看当前状态：版本、模型、环境等 |
/stats |
查看使用统计和活动情况 |
/usage |
查看套餐额度和使用限制 |
/cost |
查看当前会话总成本和耗时 |
/config |
打开配置面板 |
/model |
切换当前使用的模型 |
/plan |
进入或查看Plan模式 |
/permissions |
管理工具权限规则 |
/sandbox |
查看或配置沙箱状态 |
/theme |
切换界面主题 |
/vim |
切换Vim编辑模式和普通编辑模式 |
/fast |
切换Fast Mode |
/ide |
管理IDE集成和连接状态 |
/add-dir |
添加工作目录 |
/statusline |
设置状态栏UI |
/terminal-setup |
为终端安装Shift+Enter换行支持 |
账号、安装与连接
这类命令管理账号状态和与其他平台的连接：
| 命令 | 作用 |
|---|---|
/login |
登录或切换Anthropic账号 |
/logout |
退出当前账号 |
/upgrade |
升级套餐 |
/doctor |
检查安装状态 |
/init |
初始化新的CLAUDE.md文件 |
/desktop |
把当前会话继续到Claude Desktop |
/chrome |
管理Claude in Chrome的设置 |
/mobile |
显示二维码以下载Claude手机App |
扩展能力管理
这类命令管理Claude Code的扩展功能：
| 命令 | 作用 |
|---|---|
/agents |
管理agent配置 |
/hooks |
管理工具事件hooks |
/skills |
列出当前可用的skills |
/mcp |
管理MCP服务器（同终端子命令） |
/plugin |
管理Claude Code插件（同终端子命令） |
/reload-plugins |
让当前会话应用等待生效的插件改动 |
/install-github-app |
为仓库接入Claude GitHub Actions |
/install-slack-app |
安装Claude Slack App |
工程流程与自动化
这类命令面向开发工作流和自动化任务：
| 命令 | 作用 |
|---|---|
/tasks |
查看和管理后台任务 |
/loop |
按固定间隔重复执行prompt或slash命令 |
/batch |
用于大规模改动，先调研规划再推进执行 |
/review |
审查Pull Request |
/pr-comments |
读取GitHub Pull Request评论 |
/security-review |
从安全角度检查待提交改动 |
/simplify |
检查代码能否继续简化、复用或提质 |
/debug |
开启本会话调试日志 |
/feedback |
提交使用反馈 |
/stickers |
订购Claude Code贴纸 |
/insights |
生成Claude Code会话分析报告 |
/release-notes |
查看发布说明 |
动态技能型命令
这类命令不是每台机器都一样，它们取决于你安装了哪些skills、插件和扩展。例如某些环境会显示：
- 🍂
/x-post-reply-skill：X（原Twitter）内容生成技能 - 🍂
/claude-api：Claude API和Anthropic SDK使用指导
需要区分的是：
- 🍂
内置Slash命令：Claude Code本身稳定提供的命令 - 🍂
动态技能命令：当前环境额外挂载的扩展命令
最值得优先掌握的高频命令
如果你不想一次性记住所有命令，下面这些是最值得优先掌握的：
终端高频命令
| 命令 | 用途 |
|---|---|
claude |
启动交互式会话 |
claude -p "任务" |
一次性执行任务后退出 |
claude -c |
继续最近一次会话 |
claude --help |
查看总帮助 |
claude mcp list |
列出当前MCP连接 |
claude plugins list --json |
以JSON格式查看插件列表 |
Slash高频命令
| 命令 | 用途 |
|---|---|
/help |
显示帮助和可用命令列表 |
/clear |
清空会话历史 |
/compact |
压缩上下文但保留摘要 |
/status |
查看当前状态 |
/model |
切换当前模型 |
/permissions |
管理工具权限规则 |
/config |
打开配置面板 |
/mcp |
管理MCP服务器 |
/plugin |
管理插件 |
/review |
审查Pull Request |
新手最容易混淆的五组概念
第一组：claude 和 claude -p
- 🍂
claude：进入交互式界面，适合多轮对话 - 🍂
claude -p：一次性执行，打印结果后直接退出，适合脚本调用
第二组：/clear 和 /compact
- 🍂
/clear：直接清空所有上下文，AI会忘记之前的对话 - 🍂
/compact：压缩上下文但保留摘要，AI仍然记得对话要点
第三组：/resume 和 /rewind
- 🍂
/resume：找回并恢复过去的某个对话 - 🍂
/rewind：把当前对话的状态退回到过去的某个点
第四组：MCP 和 插件
- 🍂
MCP：外部能力连接器，让Claude Code访问外部服务 - 🍂
插件：Claude Code的内部扩展模块，增强自身功能
第五组：终端子命令 和 Slash命令
- 🍂
终端子命令：在Shell中运行，如 claude auth login - 🍂
Slash命令：在Claude Code会话内部运行，如 /model
系统学习路线：从入门到精通
如果你是第一次系统学习Claude Code，建议按照以下顺序逐步深入：
第一阶段：基础入门
-
掌握 claude、claude -p、claude -c三个核心入口命令 -
学会使用 /help查看帮助 -
理解 /clear和/compact的差异
第二阶段：日常使用
-
熟悉 /model切换模型的场景 -
掌握 /status查看系统状态 -
理解 /permissions管理工具权限
第三阶段：功能扩展
-
学习 auth相关命令管理账号 -
了解 mcp命令连接外部服务 -
掌握 plugins命令管理扩展
第四阶段：工程化应用
-
使用 /review进行代码审查 -
使用 /batch处理大规模改动 -
使用 /security-review进行安全检查
这个学习路径最稳定，也最不容易造成概念混乱。
总结：一张地图，三层结构
Claude Code的命令体系并不复杂，它只是清晰地分成了三个层次：
-
终端主命令： claude——程序的入口 -
终端子命令： claude auth、claude mcp等——管理功能 -
Slash命令： /help、/clear等——控制会话
你不需要背诵完整的命令清单，只需要先建立这张三层地图，然后根据实际需求逐步深入。当你需要特定功能时，自然就会知道该去哪一层寻找对应的命令。
如果你现在就想开始使用，记住下面这组核心命令就够了：
# 终端命令
claude # 启动交互式会话
claude -p "你的任务" # 一次性执行任务
claude -c # 继续最近会话
# Slash命令（进入会话后使用）
/help # 查看帮助
/clear # 清空历史
/compact # 压缩上下文
/model # 切换模型
/mcp # 管理MCP
/plugin # 管理插件
/review # 审查PR
掌握了这些，你就已经可以开始使用Claude Code完成日常工作了。随着使用深入，其他命令自然会慢慢熟悉起来。
常见问题解答
Q：Claude Code支持哪些操作系统？
A：Claude Code主要支持主流操作系统，包括macOS、Linux和Windows（通过WSL）。具体支持情况可以参考官方文档。
Q：如何查看当前使用的Claude Code版本？
A：可以在终端中输入claude --version查看版本信息，或者在交互会话中使用/status命令查看。
Q：Claude Code的会话保存在哪里？
A：会话默认保存在本地，具体位置取决于操作系统。可以使用--no-session-persistence参数临时禁用会话保存。
Q：MCP和插件有什么区别，我该用哪个？
A：MCP用于连接外部服务（如数据库、API等），插件用于增强Claude Code自身功能（如添加新的Slash命令）。两者用途不同，根据需求选择。
Q：/clear和/compact都会减少上下文，我该用哪个？
A：如果你想彻底开始新话题，用/clear。如果只是想优化上下文但保留对话要点，用/compact。
Q：如何让Claude Code访问我项目之外的文件？
A：可以使用--add-dir参数额外添加目录，或者在会话中使用/add-dir命令。
Q：/permissions命令有什么用？
A：这个命令让你管理AI在执行操作前是否需要获得你的确认，可以按工具类型分别设置权限策略。
Q：为什么我的Slash命令列表和别人不一样？
A：因为不同的插件、skills和账号权限会导致可用的Slash命令有差异，这是正常现象。
Q：如何批量处理文件修改？
A：可以使用/batch命令，它会先调研规划再推进执行，适合大规模改动。
Q：Claude Code支持代码审查吗？
A：是的，可以使用/review命令审查Pull Request，/security-review进行安全检查。
本文基于Claude Code 2.1.74版本整理，不同版本可能有细微差异。如有疑问，建议查阅官方文档或使用/help命令查看当前环境的具体支持情况。
