Claude Code 命令速查与实践手册

、基本模型Claude Code 基本操作输入Prompt 文件--file / stdin上下文session--resume / --continue执行单次 / 交互 / 后台输出文本 / JSON / 流式 JSON / 文件核心原则输入越准确细致输出越稳定。但也不是越多越好而是恰到好处。上下文越清晰结果越一致。上下文无杂质干扰一件事一件事处理。任务越可验证风险越低。任务能通过Claude自身验证最好。二、交互式斜杠命令Slash Commands在交互模式中输入/开头的命令来控制会话行为。会话控制命令功能说明/help显示所有可用命令包含内置命令、自定义命令和 MCP 命令/clear清除当前对话上下文完全重置适合切换任务/compact [指令]压缩对话历史可指定保留重点如/compact 保留错误处理模式/undo撤销最近一次文件更改仅回退上一步多步回退用 git/exit退出会话等同 CtrlD模式切换命令功能说明/plan切换计划模式Claude 先给出方案等待确认后再执行/fast切换快速模式同一模型的速度优化设置约 2x 费用/model [名称]切换模型/model opus/model sonnet/model haiku/effort [级别]设置推理深度low/medium/high/max模型选择策略场景推荐模型简单探索、机械任务/model haiku日常编码/model sonnet复杂推理、架构设计、安全分析/model opus会话管理命令功能说明/resume恢复历史会话打开会话选择器/sessions列出所有会话查看会话历史/tasks查看后台任务/tasks id查看详情/name [名称]命名当前会话方便后续查找工具与配置命令功能说明/config查看/编辑配置打开 settings.json/permissions管理权限设置查看和修改工具权限/mcp管理 MCP 服务器添加、删除、查看 MCP 服务器/cost查看费用统计当前会话 token 和费用/keybindings编辑快捷键配置修改~/.claude/keybindings.json项目与环境命令功能说明/init初始化项目配置创建 CLAUDE.md 等项目文件/add-dir 路径添加工作目录允许访问额外目录/ide连接 IDE自动连接 VS Code / JetBrains/doctor健康检查诊断 Claude Code 安装和配置问题/status查看状态显示当前连接和配置状态账户与安装命令功能说明/login登录认证 Anthropic 账户/logout登出清除认证信息/install-github-app安装 GitHub App启用 PR 工作流集成/bug报告问题提交 bug 报告高级功能命令功能说明/listen监听模式监听外部输入/vimVim 模式启用 Vim 风格的键绑定/review代码审查审查当前变更/memory管理记忆查看/编辑 Claude 的持久记忆/terminal-setup终端设置配置终端集成!命令执行 Shell 命令如!git status在当前会话中运行自定义斜杠命令在项目目录.claude/commands/或全局~/.claude/commands/下创建.md文件---allowed-tools: Edit, Bashmodel: sonnetdescription: 审查当前分支的代码变更---审查当前分支相对于 main 的所有变更1. 检查代码质量2. 发现潜在 bug3. 给出改进建议$ARGUMENTS文件名即命令名使用$ARGUMENTS捕获命令后的参数。三、键盘快捷键快捷键功能说明ShiftTab切换权限/计划模式循环default → acceptEdits → auto → planCtrlC取消当前任务停止执行但不退出会话CtrlD退出会话等同/exitCtrlL清屏清除终端显示保留上下文CtrlR搜索历史搜索当前会话的命令历史CtrlS暂存 Prompt暂存当前输入提交其他内容后自动恢复Escape中断生成第一次中断输入 go 可继续Escape×2回溯模式进入回溯模式用方向键浏览历史自定义快捷键运行/keybindings编辑~/.claude/keybindings.json修改后即时生效无需重启。四、CLI 启动参数核心参数参数缩写功能示例--print-p单次输出模式claude -p 问题--continue-c继续最近会话claude -c--resume [id]-r恢复指定会话claude -r abc123--model 模型指定模型claude --model opus--help-h显示帮助claude -h--version-v显示版本claude -v输入与输出参数功能示例--file 路径输入文件claude --file src/api.ts 分析--output-format 格式输出格式text/json/stream-json--input-format 格式输入格式text/stream-json--json-schema schema结构化输出验证指定 JSON Schema会话与上下文参数功能示例--add-dir 目录添加工作目录claude --add-dir ../lib--name 名称-n命名会话claude -n feature-auth--fork-session分叉会话恢复时创建新会话 ID--from-pr [值]从 PR 恢复claude --from-pr 123--session-id uuid指定会话 ID使用特定 UUID--no-session-persistence禁用会话持久化仅与--print搭配--worktree [名称]-w创建 git worktree隔离工作环境--tmux创建 tmux 会话需搭配--worktree模型与行为参数功能示例--effort 级别推理深度low/medium/high/max--permission-mode 模式权限模式见权限模式说明--fallback-model 模型降级模型主模型过载时自动切换--max-budget-usd 金额费用上限仅与--print搭配--verbose详细日志显示更多运行信息--debug [过滤]调试模式--debug api,hooks--debug-file 路径调试日志文件写入指定路径工具与权限参数功能示例--allowedTools 工具允许的工具Bash(git:*) Edit--disallowedTools 工具禁止的工具Bash(rm:*)--tools 工具指定可用工具集Bash,Edit,Read或禁用所有--dangerously-skip-permissions跳过所有权限检查仅用于沙箱环境--allow-dangerously-skip-permissions允许跳过权限选项不默认跳过仅开放选项Prompt 定制参数功能示例--system-prompt 提示自定义系统提示替换默认系统提示--append-system-prompt 提示追加系统提示在默认提示后附加集成与扩展参数功能示例--agent 代理指定代理覆盖 settings 中的 agent--agents json自定义代理JSON 定义多个代理--mcp-config 配置MCP 服务器配置加载 MCP JSON 配置--strict-mcp-config严格 MCP 模式仅使用指定的 MCP--plugin-dir 路径加载插件目录指定插件路径--settings 文件加载设置文件额外的 settings.json--ide连接 IDE自动连接可用的 IDE--chromeChrome 集成启用浏览器集成--bare最小模式跳过 hooks、LSP、插件等--disable-slash-commands禁用斜杠命令禁用所有 skills子命令子命令功能claude doctor健康检查诊断安装问题claude auth管理认证claude mcp管理 MCP 服务器claude install [target]安装指定版本stable / latest / 版本号claude update检查并安装更新claude agents列出已配置的代理claude auto-mode查看 auto 模式分类器配置claude setup-token设置长期认证 tokenclaude plugin管理插件五、权限模式使用--permission-mode或 ShiftTab 在会话中切换模式行为适用场景default每次操作需确认谨慎操作初次使用acceptEdits自动接受文件编辑信任代码修改plan先计划再执行修改需确认复杂任务先审查方案auto自动执行所有操作快速迭代信任环境dontAsk不询问直接执行自动化流水线bypassPermissions跳过所有权限检查沙箱/测试环境六、运行模式1. 交互模式默认claude特点持续上下文、适合探索和迭代。2. 单次模式Printclaude -p 一个问题特点无状态、适合自动化和管道。3. 后台任务claude --background 运行测试# 查看任务/tasks# 查看详情/tasks task-id适用测试、构建、长时间分析。七、输入与输出输入方式# 文件输入claude prompt.txt# 管道输入cat diff.txt | claude -p 分析改动# 组合输入git diff | claude -p 代码审查# 多文件分析claude --file api.ts --file db.ts 分析依赖关系# 精确行范围claude --file src/api.ts:40-80 是否存在逻辑错误输出方式# JSON 输出claude -p --output-format json 生成接口定义# 流式 JSONclaude -p --output-format stream-json 生成代码# 结构化输出claude -p --json-schema {type:object,properties:{name:{type:string}}} 提取信息# 重定向claude -p 生成代码 main.ts八、工作流模板1. 多步骤执行claude 1. 设计数据库2. 实现 API3. 编写测试4. 生成文档2. 验证型工作流claude 步骤1实现功能验证是否可运行步骤2编写测试验证是否通过步骤3覆盖率检查验证是否 80%3. Bug 修复流程1. 描述问题2. 分析日志3. 定位代码4. 修复问题5. 编写测试6. 回归验证4. 重构流程1. 识别问题2. 提出重构方案3. 重写代码4. 保持行为一致5. 验证测试九、命令组合实践1. 代码审查# 交互式审查claude --file main.go 1. 性能问题2. 并发问题3. 安全问题4. 可维护性# Git diff 审查git diff main..HEAD | claude -p 审查代码变更标注风险点2. Bug 定位# 日志分析claude --file logs.txt 找出错误原因# 代码定位claude --file api.ts:40-80 这里是否有问题3. Git 集成git diff | claude -p 审查代码git log --oneline -20 | claude -p 分析变更趋势4. CI/CD 集成# 自动审查费用受控git diff main..HEAD | claude -p \--max-budget-usd 0.50 \--output-format json \代码审查输出 JSON 格式的问题列表# 降级策略claude -p --model sonnet --fallback-model haiku 生成接口5. 批处理for file in src/*.ts; doclaude -p --file $file 检查问题done十、Compact 与上下文管理长会话中上下文会逐渐膨胀影响性能和费用。使用策略场景操作上下文使用 80%/compact压缩历史切换完全不同的任务/clear清空重来需要保留特定信息/compact 保留 API 设计决策会话过长效果下降/compact后继续示例/compact 保留错误处理的修复方案和测试结果Claude 会压缩之前的对话仅保留你指定的关键信息。十一、Plan 模式实践Plan 模式让 Claude 在执行前先给出方案。启用方式# 启动时指定claude --permission-mode plan# 会话中切换/plan# 快捷键ShiftTab # 循环切换模式适用场景复杂重构先看方案再执行不熟悉的代码库先探索再修改高风险操作数据库迁移、API 变更团队协作方案可以分享讨论十二、环境变量变量功能ANTHROPIC_API_KEYAPI 密钥CLAUDE_CODE_SIMPLE简单模式--bare自动设置CLAUDE_FORMAT默认输出格式十三、参数总览参数缩写功能--print-p单次输出--continue-c继续最近会话--resume-r恢复指定会话--model指定模型--file输入文件--effort推理深度--output-format输出格式--permission-mode权限模式--allowedTools允许的工具--max-budget-usd费用上限--worktree-w创建 worktree--verbose详细日志--debug-d调试模式--help-h帮助--version-v版本十四、场景速查场景命令快速问答claude 问题单次输出管道claude -p 问题分析代码claude --file src/api.ts 分析精确分析claude --file src/api.ts:40-80 检查继续上次claude -c恢复会话claude -r切换模型/model opus压缩上下文/compact计划模式/plan或 ShiftTab快速模式/fast低推理/effort low后台任务claude --background 任务费用控制--max-budget-usd 1.00自动化-p --output-format json沙箱执行--dangerously-skip-permissions健康检查claude doctor命名会话claude -n my-feature隔离开发claude -w feature-x十五、Prompt 编写规范