Claude Code 速记表：从入门到精通的完整命令指南

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，可以直接在终端中理解你的代码库、编辑文件、运行命令。本文系统整理了所有命令、快捷键和配置技巧，收藏备用。

安装与更新

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 更新到最新版本
claude update

# 检查当前版本
claude --version

安装完成后，在项目目录下运行 claude 即可启动交互式会话。

启动与会话管理

Claude Code 的第一步是掌握如何启动和管理会话。

基础启动命令

常用启动参数

# 指定模型启动
claude --model claude-sonnet-4

# 单次执行模式，输出 JSON
claude -p "分析这个项目的结构" --output-format json

# 单次执行并输出流式 JSON
claude -p "生成 API 文档" --output-format stream-json

# 使用 JSON Schema 强制结构化输出
claude -p "列出所有 API 端点" --json-schema '{"type":"object","properties":{"endpoints":{"type":"array"}}}'

# 管道操作：将文件内容传给 Claude
cat error.log | claude -p "分析这个错误日志"

# 组合使用：git diff 传给 Claude 审查
git diff | claude -p "请审查这段代码改动"

交互式斜杠命令

在 Claude Code 会话中，输入 / 即可查看所有可用命令。以下是完整列表：

会话控制

模型与能力

项目与配置

工具与集成

快捷键速记表

这些快捷键可以大幅提升你的操作效率：

输入增强

操作控制

CLAUDE.md — 项目上下文配置

CLAUDE.md 是 Claude Code 中最重要的配置文件之一。它相当于给 AI 的”项目说明书”，帮助 Claude 理解你的项目约定和偏好。

快速初始化

# 在项目根目录自动生成 CLAUDE.md
claude /init

推荐内容结构

# 项目上下文

## 技术栈
- 前端：React 18 + TypeScript + Vite
- 后端：Go 1.22 + Gin
- 数据库：PostgreSQL 16

## 编码规范
- 使用 ESLint + Prettier 格式化
- 组件采用 PascalCase 命名
- API 接口使用 RESTful 风格

## 项目结构
- `src/components/` — React 组件
- `src/hooks/` — 自定义 Hooks
- `src/api/` — API 接口封装
- `server/` — Go 后端代码

## 重要约定
- 所有 API 请求通过 `src/api/request.ts` 封装
- 组件测试文件与组件同目录，以 `.test.tsx` 结尾
- 禁止直接使用 `console.log`，使用 `logger` 工具
- Git 提交信息遵循 Conventional Commits

## 常见陷阱
- 数据库迁移必须先创建备份
- 部署前必须运行 `npm run typecheck`

最佳实践

• 控制长度：保持 50-100 行，最多不超过 300 行
• 使用导入：用 @path/to/details.md 引用详细文档
• 负面指令更有效：NEVER use var 比 always use const/let 效果更好
• 持续迭代：Claude 犯错的地方，就加对应的规范

权限管理系统

Claude Code 有三级权限控制，确保操作安全：

权限类型

配置方式

# 在会话中管理权限
/permissions

# 或直接编辑配置文件
# 全局：~/.claude/settings.json
# 项目：.claude/settings.json
# 本地：.claude/settings.local.json（Git 忽略）

settings.json 示例

{
  "permissions": {
    "allow": [
      "Read",
      "Grep",
      "Glob",
      "LS"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  },
  "env": {
    "CLAUDE_MODEL": "claude-sonnet-4"
  }
}

安全提示：Deny 规则优先级最高。在团队项目中，使用项目级 settings.json 统一安全策略。

Hooks — 生命周期钩子

Hooks 允许你在 Claude 执行特定操作前后自动运行脚本，实现自动化工作流。

钩子类型

配置示例

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write $CLAUDE_FILE_PATH"
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo $CLAUDE_TOOL_INPUT | jq -r '.command' | grep -q 'rm -rf' && exit 1 || exit 0"
      }
    ]
  }
}

安全注意事项

• Hooks 以当前用户的完整权限运行，没有沙箱
• 务必对 Claude 的 JSON 输入进行验证和清理
• Shell 变量必须加引号防止注入
• 使用绝对路径，如 $CLAUDE_PROJECT_DIR

MCP 服务器配置

MCP（Model Context Protocol）让 Claude Code 可以连接外部工具和数据源。

添加 MCP 服务器

# 添加到项目级配置
claude mcp add-json my-server '{"command":"npx","args":["-y","@my/mcp-server"]}' --scope project

# 添加到用户级配置
claude mcp add-json my-server '{"command":"npx","args":["-y","@my/mcp-server"]}' --scope user

# 列出已配置的 MCP 服务器
claude mcp list

常用 MCP 服务器推荐

配置文件位置

Skills 自定义技能

Skills 允许你创建可复用的指令集，就像给 Claude 定义”技能”。

创建 Skill

<!-- .claude/skills/deploy/SKILL.md -->
---
name: deploy
description: 部署项目到生产环境
---

## 部署步骤

1. 运行测试：`npm run test`
2. 构建项目：`npm run build`
3. 检查构建产物
4. 部署到服务器：`rsync -avz dist/ user@server:/var/www/`
5. 验证部署状态

使用方式

在对话中引用 Skill 文件路径，Claude 会自动读取并执行其中的步骤。

实用工作流示例

1. 代码审查工作流

# 审查最近的提交
git diff HEAD~1 | claude -p "审查这次提交的代码改动，关注安全性和性能问题"

# 审查 PR
claude -p "查看并审查当前分支与 main 的差异"

2. Debug 工作流

# 传入错误日志
cat app.log | claude -p "分析最近的错误，找出根本原因"

# 直接在会话中 Debug
claude "项目运行报错 TypeError: Cannot read property 'map' of undefined，帮我排查"

3. 文档生成工作流

# 生成 API 文档
claude -p "为 src/api/ 目录下的所有接口生成 Markdown 文档"

# 生成 README
claude -p "基于项目结构和 package.json 生成 README.md"

4. 重构工作流

# 启动会话进行重构
claude "我想将 src/utils.js 拆分为多个模块文件，每个功能独立"

# 批量重命名
claude "将项目中所有使用 camelCase 的 CSS 类名改为 kebab-case"

环境变量参考

常见问题排查

1. “上下文太长”怎么办？

# 使用 /compact 压缩对话
/compact

# 查看上下文使用情况
/context

# 或直接清除开始新对话
/clear

2. 如何在企业环境中使用？

Claude Code 支持通过 AWS Bedrock 或 Google Vertex AI 访问，无需直接连接 Anthropic API：

# 配置 AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

# 配置 Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

3. Claude 不遵守我的 CLAUDE.md？

• 检查文件位置是否在项目根目录
• 使用 /memory 命令确认是否正确加载
• 精简内容，超过 300 行效果会下降
• 用更明确的否定指令（NEVER、DO NOT）

4. 权限经常弹窗确认太烦？

# 在会话中切换到自动模式
Shift + Tab

# 或在 settings.json 中预设 Allow 列表

一图速记

┌─────────────────── Claude Code 速记 ───────────────────┐
│                                                         │
│  启动      claude / claude "任务" / claude -p "查询"      │
│  继续      claude -c（最近）/ claude -r <id>（指定）       │
│                                                         │
│  会话      /clear  /compact  /cost  /context  /exit      │
│  模型      /model  /effort  /plan                        │
│  配置      /init  /memory  /permissions  /config         │
│  工具      /mcp  /hooks  /agents  /pr-comments           │
│                                                         │
│  快捷键    @文件  !命令  Esc中断  Esc×2回退               │
│           Ctrl+R搜索  Ctrl+V图片  Shift+Tab权限          │
│                                                         │
│  配置文件  CLAUDE.md       → 项目上下文/规范              │
│           settings.json   → 权限和环境配置               │
│           .mcp.json       → MCP 服务器配置               │
│           hooks/          → 生命周期自动化               │
│           skills/         → 自定义技能指令               │
│                                                         │
└─────────────────────────────────────────────────────────┘

总结

Claude Code 不只是一个”AI 聊天框”，它是一个完整的开发环境增强工具。掌握以上命令和配置后，你可以：

• 提升效率：用斜杠命令快速控制会话
• 保障安全：通过权限系统和 Hooks 防护危险操作
• 团队协作：用 CLAUDE.md 和项目配置统一开发规范
• 无限拓展：通过 MCP 和 Skills 连接任何外部工具

建议把本文收藏为书签，在日常使用中随时查阅。也可以打印出来贴在显示器旁边 📌

提示：Claude Code 更新频率很高，建议定期运行 claude update 保持最新版本，使用 /help 查看最新命令列表。