cluade主命令

  1. claude：进入交互式 Claude Code 会话。

  2. claude -p "任务"：非交互模式，执行完直接输出后退出，适合脚本和批处理。

  3. claude -c：继续当前目录最近一次会话，适合断点续聊。

 

下面是最常见、最有实际价值的一组全局参数：

  • --add-dir：额外开放更多目录给 Claude Code 访问，适合跨目录读写。

  • --agent：指定当前会话使用哪个 agent。

  • --agents：临时传入自定义 agents 的 JSON 定义。

  • --allowed-tools：只允许指定工具运行。

  • --disallowed-tools：显式禁止某些工具运行。

  • --tools：自定义本次会话可用工具集合。

  • --system-prompt：直接覆盖本次会话的系统提示词。

  • --append-system-prompt：在默认系统提示词后追加补充说明。

  • --model：指定模型。

  • --fallback-model：默认模型拥堵时，为 print 模式指定备用模型。

  • --effort：指定思考强度，常见有 low、medium、high、max。

  • --permission-mode：指定权限策略，例如 default、auto、plan、dontAsk。

  • --settings：加载额外 settings 文件或 JSON。

  • --setting-sources：限制只从哪些设置层读取配置。

  • --mcp-config：加载 MCP 配置文件或 JSON。

  • --strict-mcp-config：只使用命令行指定的 MCP 配置。

  • --plugin-dir：临时加载某些插件目录。

  • --debug：开启调试模式。

  • --debug-file：把调试日志写入指定路径。

  • --verbose：强制打开 verbose。

  • -p 或 --print：输出后退出，不进入交互模式。

  • --output-format：控制输出格式，可用于 text、json、stream-json。

  • --input-format：控制输入格式，常用于 text 或 stream-json。

  • --json-schema：要求输出满足指定 JSON Schema。

  • --include-partial-messages：流式输出时包含中途分片。

  • --max-budget-usd：限制本次 print 模式的 API 花费上限。

  • --no-session-persistence：不保存会话到本地。

  • --session-id：手动指定会话 ID。

  • --fork-session：恢复旧会话时，分叉出一个新会话。

  • --from-pr：从关联 PR 恢复会话。

  • --ide：如果本机只有一个可用 IDE，自动连接。

  • --chrome 或 --no-chrome：开启或关闭 Claude in Chrome 集成。

  • -w 或 --worktree：为本次任务创建新的 Git worktree。

  • --tmux：配合 worktree 建立 tmux 会话。

  • --file：启动时下载文件资源到指定相对路径。

一级子命令总览

Claude Code 当前常见一级子命令如下：

  • claude agents：列出或管理 agents。

  • claude auth：管理登录状态和账号认证。

  • claude auto-mode：查看 auto mode 分类器配置。

  • claude doctor：检查 Claude Code 安装和更新器健康状态。

  • claude install：安装 Claude Code 原生版本。

  • claude mcp：管理 MCP 服务器。

  • claude plugin 或 claude plugins：管理插件。

  • claude setup-token：设置长期认证 token。

  • claude update 或 claude upgrade：检查并安装新版本。

auth 认证命令

这一组用于登录、退出和查看认证状态：

  • claude auth login：登录 Anthropic 账号。

  • claude auth login --email 你的邮箱：预填邮箱。

  • claude auth login --sso：强制走 SSO 登录。

  • claude auth logout：退出当前账号。

  • claude auth status：查看认证状态。

  • claude auth status --json：以 JSON 格式显示。

  • claude auth status --text：以人类可读文本显示。

 

doctor、install、update、setup-token

  • claude doctor：检查安装状态和自动更新器健康情况。

  • claude install stable：安装稳定版。

  • claude install latest：安装最新版。

  • claude install 具体版本号：安装指定版本。

  • claude install --force：即使已安装，也强制重新安装。

  • claude update：检查更新并安装。

  • claude upgrade：与 update 类似，用于升级。

  • claude setup-token：配置长期认证 token。

MCP 命令详解

MCP 可以理解成 Claude Code 对外接工具、服务和上下文桥接的一套机制。
常见命令如下：

  • 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 服务端。

claude mcp add 常见参数：

  • --transport：传输方式，常见是 stdio、sse、http。

  • --env：给 MCP 进程注入环境变量。

  • --header：给 HTTP 或相关连接设置请求头。

  • --scope：指定配置范围，常见是 local、user、project。

  • --client-id：某些 OAuth 场景下使用。

  • --client-secret：输入 OAuth client secret。

  • --callback-port：固定 OAuth 回调端口。

如果你是普通用户，最常见的是这三种场景：

  1. 用 claude mcp list 看现在连了哪些服务。

  2. 用 claude mcp add 增加一个本地或远程 MCP。

  3. 用 claude mcp remove 删除不用的连接。

插件命令详解

插件命令既可以写成 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。

常见 scope 参数：

  • user：对当前用户生效。

  • project：对当前项目生效。

  • local：更偏向本地目录层的配置。

插件市场 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 名称：只更新指定市场。

claude plugins marketplace add 常见参数：

  • --scope：指定市场定义写到 user、project 或 local 哪一层。

  • --sparse：如果来源是 monorepo，可用稀疏检出只拉一部分目录。

上下文与会话管理类 Slash 命令

  • /help：显示帮助和可用命令列表。

  • /exit：退出当前 REPL。

  • /clear：清空会话历史，释放上下文。

  • /compact：压缩上下文，保留摘要。

  • /resume：恢复之前的对话。

  • /rewind：把代码和或对话回退到某个历史点。

  • /fork：从当前点分叉一个新会话。

  • /rename：重命名当前会话。

  • /copy：复制 Claude 最近一条回复，或其中的代码块。

  • /export：导出当前对话到文件或剪贴板。

  • /diff：查看未提交变更和每轮差异。

运行环境与界面设置类 Slash 命令

  • /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 换行支持。

账号、安装与连接类 Slash 命令

  • /login：登录或切换 Anthropic 账号。

  • /logout：退出账号。

  • /upgrade：升级套餐。

  • /doctor：检查安装状态。

  • /init：初始化新的 CLAUDE.md 文件。

  • /desktop：把当前会话继续到 Claude Desktop。

  • /chrome：管理 Claude in Chrome 的设置。

  • /mobile：显示二维码以下载 Claude 手机 App。

工程流程与自动化类 Slash 命令

  • /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：查看发布说明。

作者：SteveChen  创建时间：2026-03-15 16:07
最后编辑：SteveChen  更新时间：2026-03-15 16:12
上一篇：
下一篇：