Skip to content

12-cli-operations.md

Latest commit

 

History

History
210 lines (142 loc) · 6.03 KB

12-cli-operations.md

File metadata and controls

210 lines (142 loc) · 6.03 KB

12. CLI 操作手册

这篇讲什么

这一章面向使用者，整理当前快照中可以从源码确认的主要 CLI/REPL 操作入口，并说明哪些能在静态源码层确认，哪些需要真实环境验证。

先给结论

这份快照足以确认 Claude Code 提供了大量 slash command 和交互式操作界面，但它并不包含一个可直接跑通的完整官方开发仓库。因此，这一章的重点是：

  • 告诉你有哪些用户操作入口。
  • 告诉你这些入口在源码里大致干什么。
  • 明确哪些操作依赖真实账号、真实服务或官方分发产物。

操作前提

在当前仓库里，先默认以下事实成立：

  • 你手里看到的是源码快照，不是完整可运行工程。
  • 没有看到完整安装和构建元数据。
  • 真实登录、远程会话、MCP 外连、IDE 联动等都需要真实环境验证。

因此，本章把操作项拆成两类：

  • 源码可确认
  • 需真实环境验证

Mermaid 图：用户操作入口图

flowchart TD
    A[用户进入 REPL] --> B[/help]
    A --> C[/login]
    A --> D[/config / /model / /permissions]
    A --> E[/mcp / /skills / /plugin]
    A --> F[/tasks]
    A --> G[/plan]
    A --> H[/review]
    B --> I[帮助与命令发现]
    C --> J[认证与账号切换]
    D --> K[设置与权限调整]
    E --> L[扩展能力管理]
    F --> M[后台任务管理]
    G --> N[计划模式工作流]
    H --> O[代码审查工作流]
Loading

常见 slash command 入口

以下命令名与基本描述可直接从源码索引确认：

命令 源码可确认的作用 证据
/help 帮助入口 src/commands/help/index.ts
/login 登录入口 src/commands/login/index.ts
/config 配置界面 src/commands/config/index.ts
/doctor 环境诊断 src/commands/doctor/index.ts
/permissions 管理工具 allow/deny 规则 src/commands/permissions/index.ts
/model 设置模型 src/commands/model/index.ts
/usage 展示 plan usage limits，仅对 claude-ai 可见 src/commands/usage/index.ts
/session 显示 remote session URL 和二维码，仅 remote mode 可见 src/commands/session/index.ts
/mcp 管理 MCP servers src/commands/mcp/index.ts
/skills 列出可用 skills src/commands/skills/index.ts
/plugin 管理插件，别名 plugins、marketplace src/commands/plugin/index.tsx
/tasks 管理后台任务，别名 bashes src/commands/tasks/index.ts
/plan 进入 plan mode 或查看当前计划 src/commands/plan/index.ts
/review 审查 pull request src/commands/review.ts
/ultrareview Web 侧远程审查路径，需启用时才出现 src/commands/review.ts

典型操作场景

1. 查看帮助

源码可确认：

  • 输入 /help
  • 命令为 local-jsx
  • 最终会渲染 HelpV2 组件

适合场景：

  • 初次进入 REPL
  • 查找可见命令
  • 理解交互界面里可做什么

2. 登录与账户切换

源码可确认：

  • /login 会打开登录对话框和 OAuth 流程。
  • 登录成功后会刷新 GrowthBook、policy limits、remote managed settings。
  • 还会重置 cost 状态、清理旧 trusted device token、更新 authVersion。

需真实环境验证：

  • 实际 OAuth 页面和令牌获取
  • 登录后远程能力是否即时可用

3. 打开配置与模型设置

源码可确认：

  • /config 打开设置界面。
  • /model 是模型切换入口，描述中会显示当前模型名。
  • /permissions 用来管理允许或拒绝的工具规则。

适合场景：

  • 调整模型
  • 检查权限模式
  • 调整 UI/行为配置

4. 诊断环境

源码可确认：

  • /doctor 打开 Doctor screen。

适合场景：

  • 排查环境问题
  • 检查某些能力为什么没有启用

5. 管理扩展能力

源码可确认：

  • /plugin 管理插件。
  • /skills 列出可用技能。
  • /mcp 管理 MCP server。

适合场景：

  • 检查某个命令是不是插件或 skill 提供的
  • 查看扩展面是否已经接入

6. 管理后台任务和子代理

源码可确认：

  • /tasks 用于列出和管理后台任务。
  • AgentTool 支持后台运行子代理，并为任务生成输出文件。

适合场景：

  • 当前会话里有后台 agent/task
  • 想切换查看某个任务执行进度

7. 进入计划模式

源码可确认：

  • /plan 是用户级入口。
  • EnterPlanModeTool 会把权限模式切换到 plan。
  • ExitPlanModeV2Tool 负责请求退出 plan mode 并进入编码阶段。

适合场景：

  • 复杂改动前先做只读探索
  • 需要明确审批节点

8. 代码审查

源码可确认：

  • /review 是 prompt 型命令。
  • 如果不给 PR 号，提示词会要求先跑 gh pr list。
  • 如果给 PR 号，提示词会要求查看 PR 详情和 diff，再输出审查结果。

需真实环境验证：

  • 本地是否安装并认证 gh
  • 目标仓库是否存在 PR

一个保守的使用顺序

如果你在真实 Claude Code 环境中上手，推荐顺序是：

  1. /help
  2. /login
  3. /config
  4. /model
  5. /permissions
  6. /doctor
  7. /skills、/plugin、/mcp
  8. /tasks

对这份快照的正确预期

对于当前仓库，文档更适合回答：

  • 有哪些入口
  • 这些入口背后连到哪些模块
  • 哪些能力属于 UI、哪些属于 tool、哪些属于远程链路

它不适合单独回答：

  • 如何完整安装官方 CLI
  • 某个命令在线上当前版本的实际输出
  • 远程功能的真实网络依赖

这一章的工作结论

当前快照已经足以还原 Claude Code 的主要用户操作面，但“能看到命令”不等于“能在本仓库直接跑通命令”。阅读源码时，把这两者分开，能避免大量误判。

延伸阅读