返回笔记首页

Claude Code 全功能速查手册

主题配置

来源:家哥说AI / AI架构之家 原文链接:https://mp.weixin.qq.com/s/QEpMLPT9BbNXSZVlEmr35g


01 安装更新

多平台安装

平台 安装命令
macOS/Linux curl -fsSL https://claude.ai/install.sh
Homebrew brew install --cask claude-code
Windows irm https://claude.ai/install.ps1
npm(Node.js 18+) npm install -g @anthropic-ai/claude-code

启动与更新

命令 说明
cd your-project && claude 进入项目启动
claude update 更新版本
claude -c 继续上一次对话

02 快捷操作

基础控制

快捷键 功能
Enter 发送/提交
Esc 中断生成
Esc+Esc 打开回溯菜单
Ctrl+C 打开菜单
Ctrl+R 运行外部编辑器/搜索历史
Ctrl+E 退出Claude Code
Shift+Tab 自动接受
Shift+Tab+Tab 计划模式

导航与编辑

快捷键 功能
Ctrl+L 切换工具列表
Ctrl+\ 切换侧边面板
Ctrl+J/Ctrl+V 粘贴图片
Ctrl+K 显示提示词/删除光标后内容
Ctrl+A/Ctrl+E 行首/行尾
Opt+F/Opt+B 单词前后跳转
↑/↓ 浏览历史
Shift+F 模型选择器
Shift+T 扩展思考
Ctrl+Tab 后台运行任务

快速查看

快捷键 功能
Ctrl+Shift+? 查看全部快捷键

输入前缀

符号 作用
! Bash模式
@ 引用文件/文件夹
# 直接读取文件/文件夹
\ 换行不发送

03 斜杠命令

会话控制

命令 说明
/clear 清空历史
/compact 压缩Token
/resume 恢复对话
/reset 回退代码节点
/cost 查看Token与费用
/rate-limits 频率限制
/convert Token可视化

配置与工具

命令 说明
/config 设置面板
/permissions 权限管理
/vim 切换Vim模式
/init 初始化CLAUDE.md
/memory 编辑记忆文件
/review 代码审查
/doctor 环境检查
/agents 子代理管理
/mcp MCP服务器管理
/tasks 任务列表
/rewind 回滚

其他高阶

命令 说明
/insights HTML报告
/pr_comments PR反馈
/install-github-app 自动化PR审查
/teleport 会话迁移
/sandbox 安全沙箱

04 CLI启动参数

启动会话

参数 说明
claude 交互式会话
claude "query" 带提示启动
claude -c 继续对话
claude -r 恢复指定会话
claude -t Git工作树

模型与输出

参数 说明
--model sonnet/haiku/opus 指定模型
--agent my-agent 指定子代理
--permission-mode plan Plan模式启动
--max-turns N 限制轮次
--output-format text/json/stream-json 输出格式

调试与权限

参数 说明
--allowedTools 允许工具
--disallowedTools 禁用工具
--verbose 详细日志
--no-browser 禁用浏览器集成

无头模式(非交互)

命令 说明
claude -p "查询" 直接输出结果
echo "fix bug" | claude -p --output-format json 管道输入

05 权限模式

模式 说明
Normal 每次确认,最安全
Auto-Accept 自动执行,高效
Plan Mode 仅规划不执行
  • 切换方式:Shift+Tab 循环切换
  • 最佳实践:先 Plan 规划 → 检查 → 再执行

06 配置管理

优先级(高→低)

优先级 配置文件路径
1 /etc/claude-code/managed-settings.json
2 .claude/settings.json
3 .claude/settings.local.json
4 ~/.claude/settings.json

配置命令

命令 说明
claude config list 查看全部
claude config get 获取配置
claude config set 修改
claude config add 追加
claude config remove 删除

07 回溯与检查点

回滚命令

操作 说明
Esc+Esc 打开回溯
/reset/rewind 回滚

回滚选项

选项 说明
Conversation Only 仅回退对话
Code 仅回退代码
Full Rewind 全部回退

注意:检查点不追踪 Bash/外部修改,必须配合 Git。


08 扩展系统

模块 路径
记忆-项目 ~/CLAUDE.md.claude/CLAUDE.md
记忆-全局 ~/.claude/CLAUDE.md
斜杠命令-项目 .claude/commands/
斜杠命令-全局 ~/.claude/commands/
工具 Bash、Read、Write 自动调用
钩子 事件触发自动化
MCP服务器 外部工具扩展

09 钩子自动化

触发事件

事件 说明
PreToolUse 工具调用前
PostToolUse 工具调用后
SessionStart/SessionEnd 会话起止
Stop 生成停止
PreCompact 压缩前
Notification 通知时

常用示例

json
// 自动格式化(在 settings.json 中配置)

10 子代理与技能

类型 项目路径 全局路径
子代理 .claude/agents/ ~/.claude/agents/
技能 .claude/skills/ ~/.claude/skills/
类型 使用方式
斜杠命令 用户主动调用
技能 模型自动识别使用

11 MCP服务器

管理命令

命令 说明
claude mcp add 添加服务器
claude mcp list 列出
claude mcp remove 移除

常用集成:GitHub、Figma、Notion、Sentry、Vercel、Zapier 等。


12 Git工作树

核心命令

命令 说明
git worktree add <路径> <分支> 创建工作树
git worktree list 查看列表
git worktree remove <路径> 删除工作树

适用场景:并行开发多功能、热修复不中断主线、安全实验隔离。


13 高阶实操工作流

项目标准启动

  1. cd project && claude
  2. /init 初始化 CLAUDE.md
  3. Shift+Tab 进入 Plan 模式
  4. 审查计划 → 切换执行

高效调试

  • 粘贴错误栈 → 自动定位
  • cat error.log | claude -p "fix"
  • 后台任务并行处理

14 扩展阅读