Claude 代码速查表（测试版）

您掌握 Claude 代码的完整指南——几分钟内从零到高手！

在对 Claude 代码进行了大量测试后，我整理了这份全面的速查表，它将帮助您从基础用户快速进阶到高级用户，而无需浪费时间。无论您是完全的新手，还是希望精通高级功能，这份指南都能满足您的需求。

快速开始

# Windows 用户
wsl

# 安装 Claude 代码
npm install -g @anthropic-ai/claude-code

# 启动交互式 REPL
claude

# 检查版本
claude --version

📚 目录

• 🟢 第1级：基本命令
• 🟡 第2级：中级命令
• 🟠 第3级：高级命令
• 🔴 第4级：专家命令
• 🔵 第5级：高级用户命令
• 🟣 第6级：大师级命令
• 🤝 贡献
• 📄 许可证

页面

• 🤖 子代理 - 用于特定开发任务的专业化 AI 代理

---

🟢 第1级：基本命令

入门必备命令

安装与启动

# 安装 Claude 代码
curl -sL https://install.anthropic.com | sh

# 启动交互式 REPL
claude

# 使用初始提示
claude "总结这个项目"

# 检查版本
claude --version

# 更新到最新版本
claude update

基本导航

/help                     # 显示帮助和可用命令
/exit                     # 退出 REPL
/clear                    # 清除对话历史
/config                   # 打开配置面板
/doctor                   # 检查 Claude 代码安装状态

基本文件操作

# 打印模式（SDK）——执行并退出
claude -p "解释这个函数"

# 处理管道输入内容
cat logs.txt | claude -p "解释"

# 继续最近的对话
claude -c

# 通过 SDK 继续
claude -c -p "检查类型错误"

会话管理

# 根据 ID 恢复会话
claude -r "abc123" "完成这个 PR"

# 使用标志恢复会话
claude --resume abc123 "查询"

# 继续当前会话
claude --continue

键盘快捷键

Ctrl+C                    # 取消当前操作
Ctrl+D                    # 退出 Claude 代码
Tab                       # 自动补全
Up/Down                   # 导航命令历史

🟡 第2级：中级命令

配置与模型管理

模型配置

# 切换模型
claude --model sonnet                    # 使用 Sonnet 模型
claude --model opus                      # 使用 Opus 模型
claude --model claude-sonnet-4-20250514  # 使用特定模型版本

目录管理

# 添加额外的工作目录
claude --add-dir ../apps ../lib

# 验证目录路径
claude --add-dir /path/to/project

输出格式化

# 不同的输出格式
claude -p "查询" --output-format json
claude -p "查询" --output-format text
claude -p "查询" --output-format stream-json

# 输入格式化
claude -p --input-format stream-json

会话控制

# 限制对话轮次
claude -p --max-turns 3 "查询"

# 详细日志记录
claude --verbose

# 会话成本和时长
/cos                      # 显示总成本和持续时间

🟠 第3级：高级命令

工具与权限管理

工具管理

# 允许特定工具而不提示
claude --allowedTools "Bash(git log:*)" "Bash(git diff:*)" "Write"

# 禁止特定工具
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)"

# 提示获取特定工具权限
claude -p --permission-prompt-tool mcp_auth_tool "查询"

# 跳过所有权限提示（危险）
claude --dangerously-skip-permissions

斜杠命令——会话管理

/compact [instructions]   # 总结对话，可选指令
/clear                    # 重置对话历史和上下文
/exit                     # 退出 REPL
/help                     # 显示可用命令
/config                   # 打开配置面板

斜杠命令——系统

/doctor                   # 检查安装健康状况
/cos                      # 显示当前会话的成本和时长
/ide                      # 管理 IDE 集成

🔴 第4级：专家命令

MCP 和高级集成

模型上下文协议（MCP）

# 配置 MCP 服务器
claude --mcp

# 通过斜杠命令管理 MCP 服务器
/mcp                      # 访问 MCP 功能

高级管道操作

# 复杂的管道操作
git log --oneline | claude -p "总结这些提交"
cat error.log | claude -p "找出根本原因"
ls -la | claude -p "解释这个目录结构"

编程式使用

# JSON 输出用于脚本
claude -p "分析代码" --output-format json

# 流式 JSON 用于实时处理
claude -p "大型任务" --output-format stream-json

# 批量处理
claude -p --max-turns 1 "快速查询"

🔵 第5级：高级用户命令

高级工作流和自动化

自定义斜杠命令

# 在 .claude/commands/ 中创建自定义命令
# 示例：.claude/commands/debug.md
/debug                    # 执行自定义调试命令
/test                     # 执行自定义测试命令
/deploy                   # 执行自定义部署命令

复杂的工具组合

# 高级工具权限
claude --allowedTools "Bash(git:*)" "Write" "Read" \
       --disallowedTools "Bash(rm:*)" "Bash(sudo:*)"

# 多个目录访问权限
claude --add-dir ../frontend ../backend ../shared

性能优化

# 限制上下文以提升性能
claude -p --max-turns 5 "专注查询"

# 经常清除上下文
/clear                    # 在任务之间使用以提高性能

# 整合对话
/compact "只保留重要部分"

🟣 第6级：大师级命令

专家自动化和自定义工作流

高级配置

# 复杂的模型和工具配置
claude --model claude-sonnet-4-20250514 \
       --add-dir ../apps ../lib ../tools \
       --allowedTools "Bash(git:*)" "Write" "Read" \
       --verbose \
       --output-format json

自动化脚本

# 脚本化的 Claude 交互
#!/bin/bash
claude -p "分析代码库" --output-format json > analysis.json
claude -p "生成测试" --max-turns 3 --output-format text > tests.txt

高级会话管理

# 会话 ID 管理
SESSION_ID=$(claude -p "开始分析" --output-format json | jq -r '.session_id')
claude -r "$SESSION_ID" "继续分析"

复杂的工作流

# 多步骤自动化
claude -p "分析项目结构" | \
claude -p "提出改进建议" | \
claude -p "制定实施方案"

---

🟤 第7级：工作流自动化

高级自动化模式和多步骤流程

自动化代码审查工作流

# 自动化 PR 审查流程
#!/bin/bash
git diff HEAD~1 | claude -p "review this PR for security issues" > security_review.md
git diff HEAD~1 | claude -p "check for performance issues" > performance_review.md
git diff HEAD~1 | claude -p "suggest improvements" > improvements.md

持续集成集成

# CI/CD 流水线集成
claude -p "analyze test coverage" --output-format json | jq '.coverage_percentage'
claude -p "generate release notes from commits" --max-turns 2 > RELEASE_NOTES.md

批量处理工作流

# 处理多个文件
find . -name "*.js" -exec claude -p "analyze this file for bugs: {}" \; > bug_report.txt

# 自动化文档生成
for file in src/*.py; do
    claude -p "generate docstring for $file" --output-format text >> docs.md
done

---

⚫ 第8级：集成与生态系统

IDE 集成、Git 工作流和第三方工具连接

IDE 集成命令

# VS Code 集成
/ide vscode                # 配置 VS Code 集成
/ide configure             # 设置 IDE 配置

# 自定义 IDE 命令
claude --ide-mode "explain selected code"
claude --ide-mode "refactor this function"

Git 工作流集成

# Git 钩子集成
claude -p "create pre-commit hook for code quality" > .git/hooks/pre-commit

# 高级 Git 操作
git log --oneline -10 | claude -p "create changelog from these commits"
git diff --name-only | claude -p "explain what changed in this commit"

第三方工具连接

# 数据库集成
mysql -e "SHOW TABLES" | claude -p "analyze database structure"

# Docker 集成
docker ps | claude -p "analyze running containers"
docker logs container_name | claude -p "find errors in logs"

---

⚪ 第9级：性能与优化

高级性能调优、资源管理和效率技巧

内存与资源管理

# 优化内存使用
claude -p --max-turns 1 "quick analysis"      # 单轮以提高效率
claude -p --compact-mode "analyze with minimal context"

# 资源监控
/cos                       # 查看当前会话成本
/doctor --performance      # 性能诊断

缓存与优化

# 高效复用会话
claude -c "continue previous analysis"         # 复用现有上下文
claude --cache-results "repetitive task"      # 缓存常见操作

# 并行处理
claude -p "task 1" & claude -p "task 2" & wait  # 并行执行

大规模处理

# 高效处理大型代码库
claude --add-dir . --max-context 50000 "analyze entire project"
claude --stream-output "process large dataset" | head -100

---

🔘 第10级：企业级与生产环境

生产就绪配置、团队工作流和企业级功能

团队协作

# 共享团队配置
claude --config-file team-config.json "standardized analysis"

# 团队会话共享
claude -r "team-session-id" "continue team discussion"

生产环境设置

# 生产就绪配置
claude --production-mode \
       --security-enabled \
       --audit-logging \
       --max-turns 10 \
       "production analysis"

企业安全

# 安全优先的操作
claude --disallowedTools "Bash(rm:*)" "Bash(sudo:*)" "Bash(chmod:*)" \
       --audit-mode \
       --no-external-calls \
       "secure code review"

监控与合规

# 审计与合规
claude --audit-log /var/log/claude-audit.log "compliance check"
claude --compliance-mode "analyze for security compliance"

命令参考表

CLI 命令

命令	描述	示例
claude	启动交互式 REPL	claude
claude "query"	启动带有提示的 REPL	claude "explain this project"
claude -p "query"	打印模式，执行后退出	claude -p "explain function"
claude -c	继续最近的对话	claude -c
claude -r "id" "query"	通过 ID 恢复会话	claude -r "abc123" "finish PR"
claude update	更新到最新版本	claude update
claude mcp	配置 MCP 服务器	claude mcp

CLI 标志

标志	描述	示例
--model	指定模型	--model sonnet
--add-dir	添加工作目录	--add-dir ../apps ../lib
--allowedTools	允许工具无需提示	--allowedTools "Bash(git:*)"
--disallowedTools	禁止特定工具	--disallowedTools "Bash(rm:*)"
--output-format	设置输出格式	--output-format json
--input-format	设置输入格式	--input-format stream-json
--max-turns	限制对话轮数	--max-turns 3
--verbose	启用详细日志记录	--verbose
--continue	继续会话	--continue
--resume	恢复会话	--resume abc123
--dangerously-skip-permissions	跳过所有权限提示	--dangerously-skip-permissions

斜杠命令

命令	描述
/help	显示帮助和可用命令
/exit	退出 REPL
/clear	清除对话历史
/config	打开配置面板
/doctor	检查安装健康状况
/cos	显示成本和持续时间
/ide	管理 IDE 集成
/compact [instructions]	总结对话
/mcp	访问 MCP 功能

键盘快捷键

快捷键	操作
Ctrl+C	取消当前操作
Ctrl+D	退出 Claude Code
Tab	自动补全
Up/Down	导航命令历史

最佳实践

性能提示

• 在任务之间频繁使用 /clear
• 使用 --max-turns 限制上下文
• 对于长时间对话使用 /compact
• 使用 --allowedTools 指定具体工具

安全提示

• 避免使用 --dangerously-skip-permissions
• 对于危险命令使用 --disallowedTools
• 定期审查工具权限
• 保持 Claude Code 更新

工作流提示

• 在 .claude/commands/ 中创建自定义斜杠命令
• 对于自动化使用 --output-format json
• 对于复杂工作流使用管道命令
• 对于长期运行的任务使用会话 ID

各级别最佳实践

初学者最佳实践（第1–3级）

• 从基础命令开始，逐步进阶
• 经常使用 /help 发现新功能
• 先练习简单查询，再进行复杂查询
• 在任务之间使用 /clear 保持会话专注

中级最佳实践（第4–6级）

• 掌握工具权限以确保安全
• 对于自动化脚本使用 JSON 输出
• 学习 MCP 以实现高级集成
• 为重复性任务创建自定义斜杠命令

高级最佳实践（7至10级）

• 为重复性任务实施自动化工作流
• 使用企业级功能进行团队协作
• 监控性能并优化资源使用
• 在生产环境中遵循安全最佳实践

专业技巧与窍门

效率提示

• 使用 Ctrl+C 取消长时间运行的操作
• 组合多个标志以实现复杂配置
• 使用管道进行多步骤数据处理
• 缓存常用操作以提升性能

安全专业提示

• 始终对危险命令使用 --disallowedTools
• 在生产环境中启用审计日志记录
• 定期审查工具权限
• 对敏感操作使用 --security-enabled

工作流专业提示

• 为常见自动化模式创建模板
• 对于长时间运行的协作任务使用会话 ID
• 在自动化脚本中实施适当的错误处理
• 记录自定义工作流以便团队共享

常见问题排查

安装问题

# 检查安装
claude --version
claude /doctor

# 如需重新安装
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

性能问题

# 清除上下文以提升性能
/clear

# 限制上下文大小
claude -p --max-turns 3 "聚焦查询"

# 使用紧凑模式
/compact "仅保留关键内容"

权限问题

# 查看当前权限
claude --list-permissions

# 重置权限
claude --reset-permissions

# 配置特定权限
claude --allowedTools "Bash(git:*)" --disallowedTools "Bash(rm:*)"

🤝 贡献

我们欢迎各位贡献！请参阅 Claude Code 文档以获取相关指南。

贡献方式

• 🐛 报告漏洞或问题
• 📝 改进文档
• ✨ 添加新的命令示例
• 🔧 测试命令并报告结果

📄 许可证

本 cheat sheet 根据 MIT 许可证提供。

⭐ 支持

如果这份 cheat sheet 对您有所帮助，请与其他开发者分享！如果您通过这份 cheat sheet 掌握了 Claude Code，请：

• ⭐ 点赞我们的 GitHub 仓库
• 📢 分享给其他开发者
• 💬 在评论区留下反馈
• 🔄 关注以获取更新

资源与进一步学习

如需更多 Claude Code 资源，请访问 Anthropic 官方文档：

• Claude Code 官方文档
• Claude Code GitHub 仓库
• Anthropic API 文档
• MCP 文档

最后更新：2025年7月

Claude Code 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 Linux、macOS 或 Windows (需安装 WSL)。
  • Windows 用户提示：建议先启用 WSL (Windows Subsystem for Linux) 以获得最佳兼容性。
• 前置依赖：
  • Node.js & npm：必须安装 Node.js (包含 npm 包管理器)。
  • 终端：推荐使用现代终端工具 (如 iTerm2, Windows Terminal, GNOME Terminal)。
• 网络环境：由于服务由 Anthropic 提供，国内用户可能需要配置网络代理以确保安装和连接稳定。

安装步骤

您可以选择以下任一方式进行安装：

方式一：使用官方安装脚本（推荐）

这是最简便的安装方式，适用于 macOS 和 Linux 环境。

curl -sL https://install.anthropic.com | sh

方式二：使用 npm 全局安装

如果您已经配置好 Node.js 环境，可以使用 npm 进行安装。

npm install -g @anthropic-ai/claude-code

验证安装

安装完成后，运行以下命令检查版本以确认安装成功：

claude --version

提示：如需更新到最新版本，可运行 claude update。

基本使用

安装成功后，您可以通过以下几种模式快速开始使用：

1. 启动交互式会话 (REPL)

直接输入 claude 进入交互模式，适合多轮对话和复杂任务处理。

claude

进入后，您可以直接使用自然语言提问，或使用斜杠命令（如 /help, /exit）。

2. 单次执行模式 (Print Mode)

适合在命令行中直接获取结果并退出，常用于脚本集成或快速查询。

# 直接跟随提示词
claude "summarize this project"

# 分析特定函数
claude -p "explain this function"

3. 管道流式处理

将其他命令的输出直接传递给 Claude Code 进行分析。

# 分析日志文件
cat logs.txt | claude -p "explain"

# 总结 Git 提交记录
git log --oneline | claude -p "summarize these commits"

4. 常用快捷键

在交互式会话中，以下快捷键能提升操作效率：

• Ctrl+C：取消当前操作
• Ctrl+D 或输入 /exit：退出会话
• Tab：自动补全命令
• Up/Down：浏览历史命令

5. 会话管理

• 继续最近的对话：

  claude -c
  

• 恢复指定会话：

  claude -r "abc123" "Finish this PR"