gongxiangp2/.claude/Claude-命令速查.md
chenpei 4e89b57798 feat(upload): optimize upload UI and performance
- Expand batch upload list area and optimize preview image layout
- Improve upload speed tracking and display (server-side & client-side)
- Reduce network detection log noise
- Optimize Docker build process (caching, env validation)
- Add shadow environment deployment support
2026-01-28 15:07:50 +08:00

11 KiB
Raw Permalink Blame History

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 自带命令
  2. 已安装插件命令
  3. 插件命令 (MCP)
  4. 项目技能 (Skills)
  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 命令文件结构

---
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 配置选项

---
# 命令描述
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 部署后验证命令

# 检查容器运行状态
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 推荐工作流

# 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 部署失败处理

# 查看详细错误日志
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 可以随时获取完整命令列表和详细帮助。