Claude Code cli 及vscode版本的各种命令参考手册(最新推荐)实践整理

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code cli 及vscode版本的各种命令参考手册(最……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

Claude Code 各种命令参考手册

版本说明： 实际处理时，截至 2026 年 4 月，Claude Code 官方文档共收录超过 70 条内置命令与绑定技能。其中约一半为内置命令（行为由 CLI 代码实现），另一半为绑定技能（借助 Prompt 机制实现，与用户自定义 Skills 技术一致）。Claude Code 内置了超过 50 个命令，但大多数开发者只用了其中 3 到 5 个。

一、命令类型概述

进入具体命令之前，先区分 Claude Code 的三种命令形态：

Slash Commands 与 CLI Flags 的核心区别：

在会话中输入 / 即可弹出所有可用命令的交互式列表，输入 / 后接字母可实时过滤。

二、会话管理类（Session Management）

落到代码里，管理 Claude Code 交互的整个生命周期，包括清除历史、总结上下文和重命名会话。

/compactvs/clear选择策略

/compact的高级用法

• 保留的内容： CLAUDE.md 内容、任务列表项、关键决策和模式
• 丢弃的内容： 冗长的对话往返、已被替代的代码迭代
• 定向压缩示例： /compact retain the error handling patterns and auth module changes
• 采用时机： 会话超过 30 分钟、出现“上下文过大”警告、Claude 开始遗忘先前决策

三、上下文与资源管理类（Context Management）

直接影响 AI 回答质量和 Token 成本控制。

四、代码分析与质量类（Code Analysis & Quality）

直接挂钩代码质量、安全审计，对企业 IT 团队价值较高。

/diff采用说明

• 左右方向键在“当前 git diff”与“各轮 Claude 操作”间切换
• 上下键浏览文件列表

/simplify采用示例

/simplify
/simplify focus on memory efficiency   # 定向优化内存效率

/batch采用说明

从实现思路看，Claude 分析代码库后将任务拆解为 5～30 个独立单元，每个单元由独立后台 Agent 在隔离的 git worktree 中执行，完成后分别发起 PR。适用来跨模块框架迁移、批量 API 替换等场景。
示例：/batch migrate src/ from Solid to React

/init采用说明

在这个场景下，在项目根目录新建 CLAUDE.md——Claude 每次会话都会读取的持久记忆文件。每个项目从 /init 开始可消除 80% 的重复上下文设置。
执行完毕后，可立即追加具体规则：

# CLAUDE.md
Authentication - Use JWT tokens, not sessions - Store in httpOnly cookies
Testing - Write tests for all API endpoints - Use Jest, not Mocha
Error Handling - Return structured errors: { error: string, code: number }

五、模式控制类（Mode Control）

模型切换建议

省钱技巧： 实际处理时，做轻松任务（如添加注释、调整格式）时切换到 Haiku，Token 消耗可降低约 80%。

六、设置与环境管理类（Configuration & Environment）

企业部署场景下，用来统一团队设置和环境切换。

MCP 作用域

安装 LSP 插件示例

/plugin install typescript-lsp@claude-plugins-official
/plugin install pyright-lsp@claude-plugins-official
/plugin install gopls-lsp@claude-plugins-official
/plugin install rust-analyzer-lsp@claude-plugins-official

七、诊断、调试与协作类（Diagnostics & Debugging）

/doctor检查项目

1. 理解这一步时，Node.js 版本（最低 18，2026 年建议 Node.js 22）
2. API 连接性
3. 认证令牌有效性
4. 文件权限
5. Git 设置
6. VS Code 扩展和磁盘空间

调试相关 CLI Flags

八、高级开发与自动化类（Advanced Development & Automation）

九、CLI 命令与参数（CLI Commands & Flags）

基础 CLI 命令

常用 CLI Flags

十、键盘快捷键

小技巧： Esc + Esc 是救命键。AI 改完文件逻辑不对，双击 Esc 直接回退，比 Git 操作快多了。

十一、自定义 Slash Commands

新建步骤

1. 新建命令目录

# 项目级命令（仅在当前项目可用）
mkdir -p .claude/commands

# 用户全局命令（所有项目可用）
mkdir -p ~/.claude/commands

2. 新建 Markdown 文件
每个 .md 文件成为一个斜杠命令，命令名即为文件名（不含扩展名）。

命令参数

采用 $ARGUMENTS 捕获命令后的所有内容，也可采用 $0、$1 等位置语法。

示例：部署命令

.claude/commands/deploy.md：

You are a deployment assistant. Run the following:
1. Check all tests pass: `npm test`
2. Build: `npm run build`
3. Check for uncommitted changes: `git status`
4. If clean, create a git tag: `git tag v$ARGUMENTS`
5. Push with tags: `git push origin main --tags`
If anything fails, stop and report exactly what failed.

采用方式：/deploy 1.4.2

示例：代码审查命令

.claude/commands/review.md：

Review the file at $ARGUMENTS against our team standards:
- Functions under 30 lines
- No nested callbacks (use async/await)
- Error handling on every async operation
- JSDoc on all exported functions
List violations with line numbers. Be direct.

采用方式：/review src/auth/ 或 /review api/payments.js

示例：Hotfix 命令

.claude/commands/hotfix.md：

Create a hotfix for $ARGUMENTS.
1. Create branch: `git checkout -b hotfix/$ARGUMENTS`
2. Identify the bug in the codebase related to $ARGUMENTS
3. Write a minimal fix (no refactoring, surgical change only)
4. Add a regression test that would have caught this bug
5. Commit with message: `hotfix: $ARGUMENTS`
6. Show diff for review before pushing

命令解析优先级

1. 内置命令（硬编码在 CLI 中）
2. .claude/commands/（项目级）
3. ~/.claude/commands/（全局）

十二、项目技能类（Bundled Skills）

从实现思路看，借助 Prompt 机制实现的特殊命令，与用户自定义 Skills 技术一致。

十三、最常用命令速查

日常开发中采用频率最高的命令：

十四、第三方资源与社区

社区项目

• awesome-claude-code：社区整理的资源仓库，收录 88+ 实用命令、hooks、CLAUDE.md 模板等资源。

第三方命令集合

• CCPlugins：精心整理的命令集合，包含 24 条专业命令，为 Claude Code CLI 扩展企业级开发工作流。针对 Opus 4 和 Sonnet 4 模型优化。

在线资源

十五、最佳实践建议

1. 每个项目从 /init 开始：自动生成 CLAUDE.md，消除 80% 的重复上下文设置。
2. 主动执行 /compact：上下文 70-80% 时就该主动压缩，用 /context 检查用量。
3. 频繁采用 /cost：若按量计费，建议每完成一个主要任务后运行一次。
4. 善用 ! 前缀：如 !git status、!npm test，无需模型思考直接执行。
5. 给常用语言装上 LSP 插件：更早暴露类型错误、未采用导入等问题。
6. 在这个场景下，新建 3-5 个常用自定义命令：放在 ~/.claude/commands/ 下全局可用。
7. 实际处理时，给 Claude Code 配一个顺手的别名：alias cc='claude --dangerously-skip-permissions'（前提是明确知道哪些操作能放权）。
8. 结合项目来看，复杂问题时加上 ultrathink：架构讨论、链路排查、复杂调试，适合明确告诉它多想一层。
9. 技能只在需时加载：主上下文越干净，Claude 越不容易被噪音带偏。
10. 用自然语言更新记忆：不需手动编辑 CLAUDE.md，直接告诉 Claude 更新即可。

实际处理时，本文档基于 Anthropic 官方文档及社区资源整理，覆盖 Claude Code 超过 70 条内置命令与绑定技能。命令数量和功能可能随版本更新而变化，建议定期查阅官方文档拿到最新信息。

结合项目来看，总的来说，Claude这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。