# Claude Code 命令速查

本文档按命令来源分类，整理了所有可用命令。

---
# 影子系统（测试）
.\deploy-remote-build.ps1 -Target shadow        # 有缓存
.\deploy-remote-build.ps1 -Target shadow -NoCache  # 无缓存

# 正式系统
.\deploy-remote-build.ps1                       # 有缓存
.\deploy-remote-build.ps1 -NoCache              # 无缓存


## 目录

1. [Claude 自带命令](#1-claude-自带命令)
2. [已安装插件命令](#2-已安装插件命令)
3. [插件命令 (MCP)](#3-插件命令-mcp)
4. [项目技能 (Skills)](#4-项目技能-skills)
5. [自定义命令 (Slash Commands)](#5-自定义命令-slash-commands)

---

部署命令
# 影子系统（测试）
.\deploy-remote-build.ps1 -Target shadow        # 有缓存
.\deploy-remote-build.ps1 -Target shadow -NoCache  # 无缓存

# 正式系统
.\deploy-remote-build.ps1                       # 有缓存
.\deploy-remote-build.ps1 -NoCache              # 无缓存


## 1. Claude 自带命令

### 1.1 基础控制

| 命令 | 功能 |
|------|------|
| `/help` | 获取使用帮助信息 |
| `/status` | 查看账户和系统状态 |
| `/release-notes` | 查看最新发布说明 |
| `/exit` / `/quit` | 退出 REPL 交互模式 |

### 1.2 会话管理

| 命令 | 功能 |
|------|------|
| `/clear` | 清除对话历史 |
| `/clear reset` | 完全重置对话 |
| `/clear new` | 开始新对话 |
| `/compact` | 压缩对话历史但保留摘要 |
| `/resume` | 恢复之前的对话 |

### 1.3 上下文查看

| 命令 | 功能 |
|------|------|
| `/context` | 可视化当前上下文使用情况 |
| `/cost` | 显示当前会话的费用和持续时间 |

### 1.4 账户管理

| 命令 | 功能 |
|------|------|
| `/login` | 使用 Anthropic 账户登录 |
| `/logout` | 登出当前账户 |
| `/upgrade` | 升级到 Max 计划 |

### 1.5 项目与目录

| 命令 | 功能 | 示例 |
|------|------|------|
| `/add-dir <path>` | 添加新的工作目录 | `/add-dir /path/to/project` |
| `/init` | 使用 CLAUDE.md 初始化项目 | `/init` |

### 1.6 导入导出

| 命令 | 功能 |
|------|------|
| `/export` | 导出当前对话到文件 |
| `/memory` | 编辑 Claude 记忆文件 |

### 1.7 配置管理

| 命令 | 功能 |
|------|------|
| `/config` | 打开设置页面 |
| `/config theme` | 打开主题设置 |
| `/permissions` | 管理工具权限规则 |
| `/output-style` | 设置输出样式 |
| `/output-style:new` | 创建自定义输出样式 |
| `/hooks` | 管理钩子配置 |

### 1.8 模型选择

| 命令 | 功能 |
|------|------|
| `/model` | 查看可用模型 |
| `/model <model-name>` | 切换指定模型 |

**模型选择指导**：

| 模型 | 适用场景 |
|------|----------|
| **Opus** | 复杂推理、创意写作、复杂代码重构 |
| **Sonnet** | 日常编程、代码审查、技术文档 |
| **Haiku** | 简单查询、快速响应、基础编程 |

### 1.9 诊断工具

| 命令 | 功能 |
|------|------|
| `/doctor` | 诊断安装和设置问题 |
| `/ide` | 管理 IDE 集成状态 |

### 1.10 智能体和任务

| 命令 | 功能 |
|------|------|
| `/agents` | 管理智能体配置和创建专门化 AI 助手 |
| `/bashes` | 列出和管理后台任务 |

### 1.11 GitHub 集成

| 命令 | 功能 |
|------|------|
| `/install-github-app` | 为仓库设置 Claude GitHub Actions |
| `/pr-comments` | 从 GitHub 拉取请求获取评论 |
| `/review` | 审查拉取请求 |

### 1.12 安全与审查

| 命令 | 功能 |
|------|------|
| `/security-review` | 对当前分支的待处理更改进行完整安全审查 |
| `/privacy-settings` | 查看和更新隐私设置 |

### 1.13 终端与界面

| 命令 | 功能 |
|------|------|
| `/terminal-setup` | 为换行和视觉提示启用终端键绑定 |
| `/vim` | 在 Vim 和普通编辑模式之间切换 |
| `/statusline` | 设置 Claude Code 的状态行 UI |
| `/todos` | 列出当前待办事项 |

### 1.14 安装迁移

| 命令 | 功能 |
|------|------|
| `/migrate-installer` | 从全局 npm 安装迁移到本地安装 |

### 1.15 反馈

| 命令 | 功能 |
|------|------|
| `/feedback` | 提交关于 Claude Code 的反馈 |
| `/feedback bug` | 报告错误 |

---

## 2. 已安装插件命令

### 2.1 superpowers 插件 (v4.1.1)

**用途**：创意工作流程管理（头脑风暴 → 计划 → 执行）

| 命令 | 功能 | 使用场景 |
|------|------|----------|
| `/brainstorm` | 头脑风暴 | 创建功能、构建组件、添加功能前必须使用 |
| `/write-plan` | 创建详细实施计划 | 将头脑风暴的结果转化为可执行的小任务 |
| `/execute-plan` | 分批执行计划 | 带审查检查点，逐步执行计划 |

**推荐工作流**：
```
/brainstorm → /write-plan → /execute-plan
```

### 2.2 claude-mem 插件 (v9.0.6)

**用途**：基于文档发现的计划执行

| 命令 | 功能 | 使用场景 |
|------|------|----------|
| `/make-plan` | 创建带文档发现的实施计划 | 在实施前先发现和阅读相关文档 |
| `/do` | 使用子代理执行计划 | 部署子代理执行各个阶段的工作 |

**特点**：
- 强制先阅读文档再实施
- 防止"发明"不存在的 API
- 每个阶段都有验证检查清单

---

## 3. 插件命令 (MCP)

### 3.1 MCP 管理

| 命令 | 功能 |
|------|------|
| `/mcp` | 管理 MCP 服务器 |

### 3.2 MCP 命令格式

```
/mcp__<server-name>__<prompt-name>
```

**示例**：

| 命令 | 功能 |
|------|------|
| `/mcp__github__create_issue` | 创建 GitHub Issue |
| `/mcp__github__list_prs` | 列出 Pull Requests |
| `/mcp__database__query` | 执行数据库查询 |
| `/mcp__docker__list_containers` | 列出 Docker 容器 |

---

## 4. 项目技能 (Skills)

**存放位置**：`.claude/skills/`

### 4.1 系统维护

| 命令 | 功能 | 说明 |
|------|------|------|
| `/cleanup-temp` | 清理临时文件 | 清理 `uploads/temp/`、`uploads/assembled/` 中的临时文件，保留正常数据 |
| `/cleanup-old` | 清理旧镜像 | 清理旧的 Docker 镜像，保留构建缓存 |
| `/system-health` | 系统健康检查 | 检查 Redis、数据库、存储、网络状态 |

### 4.2 素材管理

| 命令 | 功能 | 说明 |
|------|------|------|
| `/material-status` | 查询素材状态 | 支持按作者、类型、日期、任务号查询 |

---

## 5. 自定义命令 (Slash Commands)

### 5.1 命令存放位置

**项目级命令**（团队共享）：
```
.claude/commands/
```

**个人级命令**（个人使用）：
```
~/.claude/commands/
```

### 5.2 命令文件结构

```markdown
---
description: "命令描述"
argument-hint: "<参数>"
allowed-tools: ["Read", "Edit", "Bash"]
model: "claude-3-sonnet"
---

# 命令说明

请执行以下操作：

@$1
```

### 5.3 参数占位符

| 占位符 | 功能 |
|--------|------|
| `$ARGUMENTS` | 捕获所有参数 |
| `$1`, `$2` | 访问特定位置参数 |
| `${1:-default}` | 带默认值的参数 |

### 5.4 文件引用

```
@src/config.js         # 直接引用文件内容
@$1                    # 引用参数指定的文件
@src/utils/*.js        # 引用多个文件
```

### 5.5 Bash 命令集成

```
!npm test              # 执行测试
!eslint $1             # 代码检查
!git add . && git commit -m "消息"  # 复合命令
```

### 5.6 Front Matter 配置选项

```yaml
---
# 命令描述
description: "执行特定功能的命令"

# 参数提示
argument-hint: "<必需参数> [可选参数]"

# 允许的工具
allowed-tools:
  - "Read"
  - "Edit"
  - "Bash"
  - "Glob"

# 指定模型
model: "claude-3-sonnet"

# 扩展思考模式
thinking: true

# 权限模式
permission-mode: "standard"
---
```

---

## 6. 项目部署命令

> **重要**：所有部署命令都需要在项目根目录下执行

### 6.1 部署到影子系统（测试环境）

| 场景 | 命令 | 说明 |
|------|------|------|
| **有缓存部署** | `.\deploy-remote-build.ps1 -Target shadow` | 推荐日常使用，构建速度快 |
| **无缓存部署** | `.\deploy-remote-build.ps1 -Target shadow -NoCache` | 完全重新构建，构建时间长 |

**访问地址**：http://192.168.58.20:5320

**容器名称**：`youyidian-3d-shadow`

---

### 6.2 部署到正式系统

| 场景 | 命令 | 说明 |
|------|------|------|
| **有缓存部署** | `.\deploy-remote-build.ps1` | 推荐日常使用，构建速度快 |
| **无缓存部署** | `.\deploy-remote-build.ps1 -NoCache` | 完全重新构建，构建时间长 |

**访问地址**：http://192.168.58.20:4320

**容器名称**：`youyidian-3d-material`

---

### 6.3 部署流程说明

```
1. 本地打包代码（排除 node_modules、.next、.git）
   ↓
2. 上传到构建服务器（192.168.42.134）
   ↓
3. 在构建服务器上构建 Docker 镜像
   ↓
4. 推送到本地 Registry（192.168.42.134:5000）
   ↓
5. 拉取到生产服务器（192.168.58.20）
   ↓
6. 启动容器（影子端口5320 / 正式端口4320）
```

---

### 6.4 部署后验证命令

```powershell
# 检查容器运行状态
ssh root@192.168.58.20 "docker ps | findstr youyidian-3d"

# 查看容器日志
ssh root@192.168.58.20 "docker logs youyidian-3d-shadow --tail 100"
ssh root@192.168.58.20 "docker logs youyidian-3d-material --tail 100"

# 检查 Redis 连接
ssh root@192.168.58.20 "docker exec gongxiangpan-redis redis-cli ping"

# 查看上传会话
ssh root@192.168.58.20 "docker exec gongxiangpan-redis redis-cli keys 'upload:*'"

# 查看环境变量
ssh root@192.168.58.20 "docker exec youyidian-3d-material printenv | grep -E 'DATABASE|REDIS|S3'"
```

---

### 6.5 推荐工作流

```powershell
# 1. 先部署到影子系统测试
cd "d:\AI Code\gongxiangp2"
.\deploy-remote-build.ps1 -Target shadow

# 2. 访问 http://192.168.58.20:5320 测试功能

# 3. 确认无误后部署到正式系统
.\deploy-remote-build.ps1

# 4. 访问 http://192.168.58.20:4320 验证
```

---

### 6.6 参数说明

| 参数 | 说明 |
|------|------|
| `-Target shadow` | 部署到影子系统（默认为正式系统） |
| `-NoCache` | 禁用 Docker 构建缓存，完全重新构建 |

---

### 6.7 部署失败处理

```powershell
# 查看详细错误日志
ssh root@192.168.58.20 "docker logs youyidian-3d-shadow"

# 重启容器
ssh root@192.168.58.20 "docker restart youyidian-3d-shadow"

# 回滚到上一个版本（如果需要）
ssh root@192.168.58.20 "docker stop youyidian-3d-shadow && docker rm youyidian-3d-shadow"
# 然后重新部署上一个版本的镜像
```

---

## 快捷技巧

### 常用命令组合

```
# 开发前检查
/doctor → /context → /status

# 清理和重置
/compact → /clear new

# 系统维护
/system-health → /cleanup-temp → /cleanup-old

# 创意工作流程（使用 superpowers 插件）
/brainstorm → /write-plan → /execute-plan
```

### 自动化工作流

```
# 代码审查流程
/lint && /test && /review

# 完整部署
/build && /test && /deploy
```

---

**提示**：输入 `/help` 可以随时获取完整命令列表和详细帮助。