Claude使用教程
的目标是将专业软件工程中的最佳实践、系统化流程和成熟模式封装成“技能”（skills），让 AI 编程助手在协助开发时能像资深工程师一样思考和行动。它不是一个通用工具库，而是一个AI行为增强插件避免随意、临时性的代码生成强制采用 TDD（测试驱动开发）、系统化调试等工程规范在合适时机自动激活对应技能（如写功能前先写测试）
·
常用命令
1、跳过询问
claude --dangerously-skip-permissions
// 输出啰嗦信息
claude --dangerously-skip-permissions --verbose
参考： https://code.claude.com/docs/en/security
Claude Code 常用命令使用教程
执行claude --help，根据输出内容从整体结构、核心功能和典型用法三个层面进行深度解析
一、整体结构解析
帮助文档分为三大部分：
-
Usage（用法概览）
Usage: claude [options] [command] [prompt]表明该命令支持三种类型的输入：
- Options（选项）：控制运行行为的参数（如
-p,--model） - Commands（子命令）：执行特定管理任务（如
install,doctor） - Prompt（提示词）：直接给 AI 的指令（如
"用Python写一个排序函数"）
- Options（选项）：控制运行行为的参数（如
-
Arguments（位置参数）
prompt：用户输入的自然语言指令，是可选的（若不提供则进入交互模式）
-
Options（选项）与 Commands（子命令）
- Options 影响当前会话的行为（如模型选择、权限控制、输出格式等）
- Commands 是独立的管理操作（如安装、调试、配置插件等）
二、核心功能详解
1. 交互 vs 非交互模式
- 默认交互模式：运行
claude不带参数，启动 REPL（读取-求值-打印循环），适合多轮对话。 - 非交互模式（
-p/--print）：一次性执行并退出，适合脚本或管道操作。claude -p "解释这段代码" < script.py注意：
-p模式会跳过工作区信任确认，仅用于可信目录。
2. 会话管理
--continue(-c)：继续最近一次对话（按项目目录隔离）--resume [id](-r)：恢复指定会话（可交互选择）--session-id <uuid>：强制使用特定会话 ID--fork-session：恢复时创建新分支，保留原会话不变
这些功能使得开发者能在多个任务间灵活切换，避免上下文污染。
3. 模型与性能控制
--model <model>：指定模型（如sonnet,opus, 或完整名称）--fallback-model：主模型过载时自动降级（仅限-p模式）--max-budget-usd：限制 API 花费（防止意外高额账单）
实践中常将高频辅助任务交给小模型（如
haiku），主任务用sonnet，以平衡成本与效果。
4. 安全与权限
--allowed-tools/--disallowed-tools：精细控制可用工具（如只允许Bash(git:*)）--dangerously-skip-permissions：跳过所有权限确认（仅限无网络沙盒环境）--permission-mode：设置权限策略（如dontAsk自动接受编辑）
安全设计遵循“最小权限原则”，尤其在处理敏感代码库时至关重要。
5. 输出与集成
--output-format：支持text（默认）、json、stream-json（实时流）--json-schema：强制输出符合指定 JSON Schema（适合自动化解析）--ide：自动连接 IDE（如 VS Code），实现无缝开发体验
6. 项目上下文管理
--add-dir：授权访问额外目录（突破默认工作区限制）--system-prompt/--append-system-prompt：自定义系统提示词- 结合项目根目录的
CLAUDE.md文件，可持久化项目记忆
三、典型使用场景示例
场景 1：快速代码生成（非交互）
claude -p --model sonnet "用 TypeScript 写一个 LRU 缓存类" > lru.ts
场景 2：调试现有项目（交互 + 上下文）
cd my-project
claude --continue # 自动加载 CLAUDE.md 和历史会话
# 在对话中输入：@src/utils.js 优化这个函数的性能
场景 3：安全受限环境
claude \
--disallowed-tools "Bash(rm:*),Bash(curl)" \
--allowed-tools "Read,Write" \
"分析代码安全性"
场景 4：结构化输出（自动化流水线）
claude -p \
--output-format json \
--json-schema '{"type":"object","properties":{"issues":{"type":"array"}}}' \
"扫描代码中的安全漏洞"
四、与其他 AI 工具的区别
Claude Code 的独特优势在于：
- Agent 设计克制：采用单主线程 + 最多一层子任务，避免多智能体复杂性
- 工具链深度集成：通过 MCP（Model Context Protocol）扩展文件、Git、终端等能力
- 成本意识强：大量使用
haiku处理辅助任务，降低 70%+ 成本
总结
claude [options] [command] [prompt] 是一个高度可配置、安全可控、适合工程化使用的 AI 编程 CLI。它既支持快速脚本调用，也支持复杂的多轮项目协作，其设计理念强调 简单性、安全性与成本效率。对于开发者而言，掌握其选项组合（如 -p + --output-format json + --model sonnet）能极大提升自动化开发效率。
目录
Claude Code 是 Anthropic 推出的官方 CLI 工具，用于帮助开发者完成软件工程任务。它可以在终端中与 Claude 进行交互式对话，支持代码编写、调试、重构等多种功能。
安装方式
注意：通过 npm 安装的方式已弃用，请使用以下推荐方法之一。
https://github.com/anthropics/claude-code?tab=readme-ov-file#get-started
斜杠命令 slash
斜杠命令用于控制 Claude 在交互会话中的行为。
内置斜杠命令
| 命令 | 用途 |
|---|---|
/add-dir |
添加额外的工作目录 |
/agents |
管理自定义 AI 子代理 |
/bashes |
列出和管理后台任务 |
/bug |
报告 bug |
/clear |
清除对话历史 |
/compact [instructions] |
压缩对话，可选聚焦指令 |
/config |
打开设置界面 |
/context |
可视化当前上下文使用情况 |
/cost |
显示 token 使用统计 |
/doctor |
运行诊断检查 |
/exit |
退出 REPL |
/export [filename] |
导出对话到文件或剪贴板 |
/help |
获取帮助 |
/hooks |
管理钩子配置 |
/ide |
管理 IDE 集成 |
/init |
用 CLAUDE.md 指南初始化项目 |
/install-github-app |
设置 Claude GitHub Actions |
/login |
切换 Anthropic 账户 |
/logout |
退出登录 |
/mcp |
管理 MCP 服务器连接 |
/memory |
编辑 CLAUDE.md 内存文件 |
/model |
选择或切换 AI 模型 |
/output-style [style] |
设置输出样式 |
/permissions |
查看或更新权限 |
/plan |
进入计划模式 |
/plugin |
管理插件 |
/pr-comments |
查看 Pull Request 评论 |
/privacy-settings |
查看/更新隐私设置 |
/release-notes |
查看发布说明 |
/rename <name> |
重命名当前会话 |
/remote-env |
配置远程会话环境 |
/resume [session] |
恢复对话 |
/review |
请求代码审查 |
/rewind |
回退对话和/或代码 |
/sandbox |
启用沙盒 bash 工具 |
/security-review |
安全审查待处理更改 |
/stats |
可视化每日使用情况 |
/status |
打开状态标签页 |
/statusline |
设置状态栏 UI |
/teleport |
恢复远程会话 |
/terminal-setup |
安装 Shift+Enter 换行绑定 |
/theme |
更改颜色主题 |
/todos |
列出当前待办事项 |
/usage |
显示计划使用限制 |
/vim |
进入 vim 模式 |
自定义斜杠命令
项目命令（存储在仓库中）：
mkdir -p .claude/commands
echo "# 你的命令描述" > .claude/commands/your-command.md
个人命令（所有项目可用）：
mkdir -p ~/.claude/commands
echo "# 你的命令描述" > ~/.claude/commands/your-command.md
带参数的命令：
---
description: 审查 PR
argument-hint: [pr-number] [priority]
---
审查 PR #$1，优先级为 $2
使用方式：/your-command 123 high
常用命令详解
/model - 切换 AI 模型
在三个模型间切换，根据任务复杂度选择合适的模型：
| 模型 | 特点 | 适用场景 |
|---|---|---|
| opus | 最强模型，推理能力最强 | 复杂任务、架构设计、代码审查 |
| sonnet | 平衡模型，速度与能力兼顾 | 日常开发、常规编程任务 |
| haiku | 快速模型，响应最快 | 简单任务、快速问答 |
输入: /model
> 选择模型: [opus/sonnet/haiku]
/skills
skill是带目录的说明书，或者说是渐进式披露提示词的机制
/plan - 计划模式
Claude 仅生成详细的执行计划，不进行任何代码更改。适合需要审核方案后再执行的场景：
输入: /plan
> 描述你的任务，Claude 会生成包含以下内容的计划：
> - 任务目标
> - 实现步骤
> - 涉及文件
> - 潜在风险
/review - 代码审查
请求 Claude 对代码进行全面审查，包括：
- 代码质量：可读性、规范性、简洁性
- 潜在 Bug：逻辑错误、边界条件、空指针等
- 性能问题：不必要的重复计算、低效算法
- 安全风险：注入漏洞、认证问题
- 最佳实践：是否遵循项目规范
输入: /review
> Claude 会分析当前暂存的更改并提供改进建议
/security-review - 安全审查
对代码进行专门的安全审查，检查以下类型的问题：
- 注入攻击：SQL 注入、XSS、命令注入
- 认证与授权：身份验证绕过、权限提升
- 敏感数据：硬编码密钥、信息泄露
- 加密问题：弱加密算法、不安全的随机数
输入: /security-review
> Claude 会检查代码中的安全漏洞并提供修复建议
/compact [instructions] - 压缩对话
压缩历史上下文，释放 token 空间。可选传入聚焦指令，让 Claude 保留相关信息：
/compact # 压缩整个对话
/compact 专注于登录功能 # 压缩并聚焦登录相关
适用场景：对话过长、token 使用率过高、需要聚焦特定功能时。
/context - 上下文使用情况
可视化展示当前会话的 token 使用情况，包括：
- System prompt 大小
- 消息历史占用
- 当前剩余空间
- 预计可继续对话长度
输入: /context
> 显示类似这样的可视化界面：
> ┌────────────────────────────────────────┐
> │ 已使用 45% │
> │ ├─ System: 2.9k tokens │
> │ ├─ Tools: 13.1k tokens │
> │ └─ Messages: 510 tokens │
> └────────────────────────────────────────┘
/cost - Token 统计
显示当前会话的 token 消耗和预估成本：
- 累计输入/输出 token 数
- 预估会话成本
- 今日使用统计
- 剩余配额
输入: /cost
> Session so far: 15,000 tokens (~$0.05)
> Remaining: 485,000 tokens
/export [filename] - 导出对话
将会话导出保存，便于后续回顾或分享：
/export conversation.md # 导出到文件
/export # 导出到剪贴板
/resume [session] - 恢复会话
恢复之前的会话继续工作：
/resume # 列出可恢复的会话
/resume session-name # 恢复指定会话
/rename <name> - 重命名会话
为当前会话命名，便于后续识别和恢复：
/rename feature-login # 重命名为 feature-login
/mcp - MCP 服务器管理
管理 Model Context Protocol 服务器连接：
输入: /mcp
> 可执行的操作：
> - 查看已配置的 MCP 服务器列表
> - 检查各服务器的连接状态
> - 对需要认证的服务器进行 OAuth 认证
> - 清除特定服务器的认证令牌
> - 添加新的 MCP 服务器配置
/hooks - 钩子配置管理
管理自动化钩子配置，查看和修改钩子行为：
输入: /hooks
> 可执行的操作：
> - 查看当前钩子配置
> - 添加新的钩子规则
> - 编辑现有钩子
> - 禁用/启用特定钩子
> - 测试钩子行为
/todos - 待办事项管理
列出当前会话中的所有待办任务及其状态：
输入: /todos
> 任务列表：
> ✓ [完成] 阅读项目文档
> ✓ [完成] 理解代码结构
> ◐ [进行中] 实现登录功能
> ○ [待开始] 编写测试用例
/clear - 清除对话历史
清除当前会话的所有历史记录，开始全新对话：
输入: /clear
> 警告：此操作不可逆，对话历史将被清除
> 确认后继续...
/doctor - 运行诊断检查
检查 Claude Code 的安装和配置状态：
输入: /doctor
> 检查项目：
> ✓ Node.js 版本正常
> ✓ Git 配置正常
> ✓ MCP 服务器连接正常
> ✗ IDE 集成未配置（建议运行 /ide）
主 CLI 命令
核心命令
# 启动交互式会话
claude
# 运行特定提示词
claude "你的提示词"
# 自动化运行（无交互）
claude --headless --prompt "你的提示词"
# 恢复会话
claude --resume session-name
# 指定模型
claude --model opus "你的提示词"
# 从文件继续对话
claude --continue conversation.txt
# 使用系统提示词
claude --system-prompt "你是 Rust 专家" "帮我 Rust"
# 调试模式
claude --debug "你的提示词"
CLI 参数
| 参数 | 描述 |
|---|---|
--headless |
无交互 TTY 运行 |
--prompt |
直接传递提示词 |
--model |
指定模型（opus, sonnet, haiku） |
--resume |
恢复之前的会话 |
--continue |
从保存的对话继续 |
--system-prompt |
添加自定义系统提示词 |
--append-system-prompt |
附加到默认系统提示词 |
--output-format |
json, text 或 stream-json |
--dangerously-skip-permissions |
跳过权限提示 |
--dangerously-allow-all |
允许所有工具无需提示 |
--debug |
启用调试输出 |
--version |
显示版本 |
钩子配置
钩子允许你拦截和修改工具行为。
配置位置
- 项目级：
.claude/hooks.yml - 用户级：
~/.claude/hooks.yml
钩子事件
| 事件 | 描述 |
|---|---|
PreToolUse |
工具运行前 |
PostToolUse |
工具完成后 |
PermissionRequest |
请求权限时 |
Notification |
Claude 发送通知时 |
UserPromptSubmit |
用户提交提示词时 |
Stop |
对话停止时 |
SubagentStop |
子代理停止时 |
PreCompact |
上下文压缩前 |
SessionStart |
会话开始时 |
SessionEnd |
会话结束时 |
示例：PreToolUse 钩子
hooks:
PreToolUse:
- matcher: "Bash"
hooks:
- type: command
command: "./scripts/validate-command.sh"
once: true
示例：通知钩子
hooks:
Notification:
- matcher: "*"
hooks:
- type: command
command: "notify-send 'Claude' '$NOTIFICATION'"
MCP 服务器
MCP（Model Context Protocol）服务器扩展 Claude 与外部工具和数据源的连接能力。
安装 MCP 服务器
本地 stdio 服务器：
// settings.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@anthropic-ai/github-mcp-server"]
}
}
}
远程 HTTP 服务器：
{
"mcpServers": {
"remote-api": {
"url": "https://api.example.com/mcp"
}
}
}
SSE 服务器：
{
"mcpServers": {
"sse-server": {
"url": "https://example.com/sse"
}
}
}
MCP 安装范围
| 范围 | 位置 | 用途 |
|---|---|---|
| 本地 | .mcp.json |
单个项目 |
| 用户 | ~/.mcp.json |
个人工具 |
| 项目 | .claude/.mcp.json |
团队工具 |
管理 MCP 连接
使用 /mcp 命令可以：
- 查看配置的服务器
- 检查连接状态
- OAuth 认证
- 清除认证令牌
常用 MCP 服务器
- GitHub：仓库管理、PR、Issue
- PostgreSQL：数据库查询
- Sentry：错误监控
- Slack：团队沟通
- Google Drive：文件管理
IDE 集成
VS Code
- 在 VS Code 市场中搜索 “Claude Code” 并安装
- 功能：
- 侧边栏聊天面板
- 内联建议
- CodeLens 操作
- 终端集成
VS Code 命令：
Claude Code: Start Chat- 启动聊天Claude Code: Inline Edit- 内联编辑Claude Code: Generate Tests- 生成测试
键盘快捷键：
Cmd+Shift+C(Mac) /Ctrl+Shift+C(Windows)：启动聊天Cmd+I(Mac) /Ctrl+I(Windows)：内联编辑
JetBrains 系列
- 从 JetBrains Marketplace 安装
- 功能：
- 对话工具窗口
- 内联 AI 辅助
- 终端集成
终端设置
# 安装 Shift+Enter 换行支持
/terminal-setup
# 支持的终端：
# - VS Code
# - Alacritty
# - Zed
# - Warp
键盘快捷键
交互模式
| 快捷键 | 动作 |
|---|---|
Enter |
提交提示词 |
Ctrl+A |
移动到行首 |
Ctrl+E |
移动到行尾 |
Ctrl+U |
清除行 |
Ctrl+K |
清除光标到行尾 |
Ctrl+L |
清除屏幕 |
Ctrl+C |
取消输入 |
Ctrl+D |
空行时退出 |
Ctrl+R |
反向搜索历史 |
Tab |
自动补全 |
Shift+Enter |
新行（需终端设置） |
Vim 模式
| 按键 | 动作 |
|---|---|
i |
插入模式 |
Esc |
普通模式 |
: |
命令模式 |
w |
下一个词 |
b |
上一个词 |
0 |
行首 |
$ |
行尾 |
dd |
删除行 |
u |
撤销 |
Ctrl+R |
重做 |
进入 Vim 模式：/vim
常见使用场景
理解新代码库
# 获取概览
claude "解释这个代码库的结构"
# 查找特定功能
claude "找到处理用户认证的代码"
# 追踪代码流程
claude "支付处理是如何工作的？"
修复 Bug
# 描述 bug
claude "修复登录时密码为空的 bug"
# 附带错误信息
claude "修复这个错误：[粘贴错误信息]"
重构代码
claude "重构这个函数以提高性能"
claude "将这个提取为独立组件"
创建 Pull Request
claude "为当前分支的更改创建 PR 描述"
运行测试
claude "运行测试套件并修复任何失败"
计划模式
当你想让 Claude 制定计划而不做更改时：
claude --plan "重构认证系统"
扩展思考
对于复杂问题，启用扩展思考：
claude "设计新的 [复杂系统] 架构" --model opus
最佳实践
1. 使用清晰的提示词
# 推荐
claude "创建一个 React 登录组件，包含邮箱和密码字段"
# 不明确
claude "让登录能工作"
2. 使用 CLAUDE.md
在项目根目录创建 .claude/CLAUDE.md：
# 项目名称
项目描述
## 代码规范
- 使用 TypeScript
- 遵循 ESLint 规则
## 测试
- 为所有新函数编写测试
- 使用 Jest
## 命令
- `npm test` - 运行测试
- `npm run build` - 构建项目
3. 使用会话名称
/rename feature-login
4. 检查上下文使用
/context
5. 监控成本
/cost
6. 恢复会话
/resume session-name
7. 使用钩子实现自动化
# .claude/hooks.yml
hooks:
PostToolUse:
- matcher: "Bash"
hooks:
- type: command
command: "echo '工具执行: $TOOL_NAME'"
快速参考
| 任务 | 命令 |
|---|---|
| 启动 Claude | claude |
| 快速提示 | claude "你的提示词" |
| 获取帮助 | /help |
| 清除历史 | /clear |
| 检查上下文 | /context |
| 检查成本 | /cost |
| 运行诊断 | /doctor |
| 恢复会话 | /resume session-name |
| 重命名会话 | /rename name |
| 退出 | /exit |
| 代码审查 | /review |
| 安全审查 | /security-review |
| 列出待办 | /todos |
| 更改主题 | /theme |
| 配置 IDE | /ide |
| 管理插件 | /plugin |
| 管理 MCP | /mcp |
| 配置钩子 | /hooks |
| 编辑内存 | /memory |
| 导出聊天 | /export filename |
相关文档
superpowers
https://github.com/obra/superpowers 是一个专为 Claude Code（由 Anthropic 提供的 AI 编程助手）设计的 核心技能库（core skills library），名为 Superpowers。
项目简介
Superpowers 的目标是将专业软件工程中的最佳实践、系统化流程和成熟模式封装成“技能”（skills），让 AI 编程助手在协助开发时能像资深工程师一样思考和行动。
它不是一个通用工具库，而是一个AI行为增强插件，通过结构化技能引导 AI：
- 避免随意、临时性的代码生成
- 强制采用 TDD（测试驱动开发）、系统化调试等工程规范
- 在合适时机自动激活对应技能（如写功能前先写测试）
核心功能模块
1. Testing（测试）
test-driven-development：RED-GREEN-REFACTOR 循环condition-based-waiting：处理异步测试testing-anti-patterns：识别并避免坏味道测试
2. Debugging（调试）
systematic-debugging：四阶段根因分析法root-cause-tracing：从现象回溯到根本原因verification-before-completion：修复后必须验证
3. Collaboration（协作）
brainstorming：通过苏格拉底式提问优化设计writing-plans/executing-plans：先写计划再分批执行using-git-worktrees：推荐使用 worktree 进行并行开发requesting-code-review：提交前自检清单
4. Meta（元技能）
writing-skills：教你如何编写新的 Superpower 技能sharing-skills：通过 PR 贡献回社区using-superpowers：入门指南
⚡ 使用方式
安装（在 Claude Code 中）：
/plugin install superpowers@superpowers-marketplace
常用命令（Slash Commands）：
/superpowers:brainstorm—— 交互式设计讨论/superpowers:write-plan—— 生成详细实施计划/superpowers:execute-plan—— 按计划分批实现
技能会自动激活。例如：当你开始写新功能，
test-driven-development会自动介入，要求先写测试。
📜 设计哲学
- ✅ Test-Driven Development：永远先写测试
- ✅ Systematic over ad-hoc：拒绝“试试看”，坚持流程
- ✅ Evidence over claims：修复必须可验证
- ✅ Domain over implementation：先理解问题，再考虑代码
📦 技术细节
- 语言：JavaScript (54.4%)、Shell (25.2%)、TypeScript (20.4%)
- 许可证：MIT
- 最新版本：v3.3.1（2025年10月28日发布）
- GitHub 数据：⭐ 5.5k stars，🍴 388 forks
💡 为什么重要？
这个项目代表了 AI 编程助手从“代码补全器”向“工程协作者”演进的关键一步。它不只生成代码，而是嵌入工程文化与纪律，帮助团队保持高质量交付节奏。
如果你正在使用 Claude Code，强烈建议安装此插件；如果你是技术负责人或希望提升 AI 辅助编程的可靠性，这个项目也值得深入研究其技能设计模式。
需要我帮你：
- 解读某个具体技能（如
systematic-debugging）？ - 演示如何用
/superpowers:write-plan规划一个功能？ - 了解如何贡献自己的技能？
欢迎继续提问！
有“AI”的1024 = 2048，欢迎大家加入2048 AI社区
更多推荐
11
0- 0
已为社区贡献22条内容
所有评论(0)