Claude Code 常用命令与功能详解

目录

• 一、CLI 启动命令

• 二、常用 CLI 参数

• 三、斜杠命令（Slash Commands）

• 四、键盘快捷键

• 五、模型选择与切换

• 六、记忆系统（CLAUDE.md）

• 七、权限模式

• 八、MCP 服务器管理

• 九、Hooks 钩子系统

• 十、实用技巧

一、CLI 启动命令

基本启动

命令 说明 示例 claude 启动交互式会话 claude claude "问题" 带初始提问启动 claude "解释这个项目" claude -p "问题" 非交互模式（输出后退出） claude -p "解释这个函数" claude -c 继续最近一次对话 claude -c claude -r "会话名" 恢复指定会话 claude -r "auth-refactor" claude update 更新到最新版本 claude update claude --version 查看版本号 claude -v

管道输入

可以将文件内容通过管道传给 Claude Code：

# 分析日志文件 cat logs.txt | claude -p "分析这些错误日志" # 代码审查 cat app.py | claude -p "审查这段代码的安全性"

二、常用 CLI 参数

核心参数

参数 说明 示例 -p, --print 非交互模式，输出后退出 claude -p "查询" -c, --continue 继续最近对话 claude -c -r, --resume 恢复指定会话 claude -r "会话名" --model 指定模型 claude --model opus --verbose 详细日志 claude --verbose --debug 调试模式 claude --debug --add-dir 添加额外工作目录 claude --add-dir ../libs

高级参数

参数 说明 示例 --permission-mode 设置权限模式 claude --permission-mode plan --system-prompt 替换系统提示词 claude --system-prompt "你是Python专家" --append-system-prompt 追加系统提示词 claude --append-system-prompt "使用中文回复" --max-turns 限制最大轮次（仅 -p 模式） claude -p --max-turns 3 "查询" --max-budget-usd 限制最大花费（美元） claude -p --max-budget-usd 5.00 "查询" --output-format 输出格式 claude -p --output-format json "查询" --allowedTools 指定允许的工具 claude --allowedTools "Read" "Grep" --mcp-config 加载 MCP 配置文件 claude --mcp-config ./mcp.json --json-schema 按 JSON Schema 输出结构化结果 claude -p --json-schema '{"type":"object",...}'

三、斜杠命令（Slash Commands）

在 Claude Code 交互界面中输入 / 可查看所有可用命令。

会话管理

命令 说明 /clear 清除对话历史，重新开始 /compact [指令] 压缩对话上下文（可附加压缩方向说明） /exit 退出 Claude Code /resume [会话] 恢复历史会话 /rename <名称> 重命名当前会话 /rewind 回退对话和/或代码到之前某个点 /export [文件名] 导出当前对话到文件或剪贴板 /copy 复制最后一条助手回复到剪贴板

信息查看

命令 说明 /help 查看帮助信息 /cost 显示 Token 使用统计 /status 显示版本、模型、账户信息 /context 以彩色网格可视化当前上下文使用情况 /stats 可视化每日使用量、会话历史、连续使用天数 /usage 显示套餐额度和速率限制状态 /doctor 检查 Claude Code 安装健康状况 /tasks 列出和管理后台任务 /todos 列出当前 TODO 项

配置相关

命令 说明 /config 打开设置界面 /model 选择或切换模型（左右箭头调整 effort 级别） /permissions 查看或更新权限 /memory 编辑 CLAUDE.md 记忆文件 /init 初始化项目 CLAUDE.md 指南 /mcp 管理 MCP 服务器连接 /hooks 打开交互式 Hooks 管理器 /keybindings 打开键盘快捷键配置

界面与模式

命令 说明 /theme 切换颜色主题 /vim 启用 Vim 编辑模式 /plan 进入计划模式（仅分析不修改） /fast 切换快速模式（同模型更快输出） /statusline 设置状态栏 UI /terminal-setup 安装终端特定快捷键（如 Shift+Enter） /add-dir 在会话中添加额外工作目录 /agents 管理子代理

四、键盘快捷键

通用控制

快捷键 说明 Ctrl+C 取消当前输入或生成 Ctrl+D 退出 Claude Code Ctrl+L 清屏（保留对话历史） Ctrl+G 在默认编辑器中打开提示词 Ctrl+O 切换详细输出 Ctrl+R 反向搜索命令历史 Ctrl+T 切换任务列表视图 Ctrl+B 将运行中的任务移到后台 Ctrl+V 从剪贴板粘贴图片 Esc + Esc 回退/撤销（恢复代码到之前状态） Shift+Tab 切换权限模式（自动接受/计划/普通） Alt+P 切换模型 Alt+T 切换扩展思考模式 ↑ / ↓ 浏览命令历史

文本编辑

快捷键 说明 Ctrl+K 删除到行尾 Ctrl+U 删除整行 Ctrl+Y 粘贴已删除文本 Alt+B 光标后移一个单词 Alt+F 光标前移一个单词

多行输入方法

方法 操作 反斜杠换行 + Enter（所有终端通用） 快捷键换行 Ctrl+J macOS Option+Enter 部分终端 Shift+Enter（iTerm2、WezTerm、Ghostty、Kitty） 粘贴模式 直接粘贴多行文本

快捷前缀

前缀 说明 / 调用斜杠命令或技能 ! Bash 模式，直接运行 Shell 命令（输出加入对话上下文） @ 文件路径提及（触发自动补全）

五、模型选择与切换

模型别名

别名 说明 default 根据账户类型推荐的默认模型 sonnet 最新 Sonnet 模型（当前 Sonnet 4.5） opus 最新 Opus 模型（当前 Opus 4.6） haiku 快速高效的 Haiku 模型 opusplan 计划模式用 Opus，执行用 Sonnet

设置模型的方式（优先级从高到低）

1. 会话中切换：输入 /model 选择模型

2. 启动时指定：claude --model opus

3. 环境变量：ANTHROPIC_MODEL=opus

4. 配置文件：在 settings.json 中设置 "model": "opus"

Effort 级别（仅 Opus 4.6）

三个级别：low（低）、medium（中）、high（高，默认）

• 在 /model 界面中用左右箭头调整

• 环境变量：CLAUDE_CODE_EFFORT_LEVEL=low|medium|high

扩展思考（Extended Thinking）

• 快捷键切换：Alt+T（需先运行 /terminal-setup）

• 始终开启：设置 "alwaysThinkingEnabled": true

• 控制预算：MAX_THINKING_TOKENS 环境变量（默认 31999，设为 0 禁用）

六、记忆系统（CLAUDE.md）

记忆层级

Claude Code 会按优先级加载以下记忆文件：

类型 路径 作用范围 项目记忆 ./CLAUDE.md 或 ./.claude/CLAUDE.md 团队共享（通过 git） 项目规则 ./.claude/rules/*.md 团队共享，模块化规则 用户记忆 ~/.claude/CLAUDE.md 个人全局，所有项目 本地项目记忆 ./CLAUDE.local.md 个人，当前项目（gitignore） 自动记忆 ~/.claude/projects/<项目>/memory/ Claude 自动保存的经验笔记

常用操作

• /memory — 在编辑器中打开记忆文件

• /init — 为当前项目初始化 CLAUDE.md

• 在 CLAUDE.md 中使用 @path/to/file 语法引入其他文件

CLAUDE.md 写什么

# 项目说明 这是一个 React + TypeScript 项目，使用 Vite 构建。 # 开发规范 - 使用中文注释 - 组件使用函数式组件 + Hooks - 代码风格遵循 ESLint 配置 # 常用命令 - `npm run dev` — 启动开发服务器 - `npm run build` — 构建生产版本 - `npm test` — 运行测试

七、权限模式

模式说明

模式 说明 default（普通） 标准模式，首次使用工具时请求权限 acceptEdits（自动接受编辑） 自动接受文件编辑操作 plan（计划模式） 仅分析，不进行任何修改 bypassPermissions（跳过权限） 跳过所有权限检查（仅在隔离环境中使用）

切换方式

• 快捷键：Shift+Tab 循环切换

• 启动时指定：claude --permission-mode plan

• 配置文件：在 settings.json 中设置 defaultMode

权限规则语法

在 settings.json 的 permissions 中配置：

{ "permissions": { "allow": [ "Read", "Glob", "Grep", "Bash(npm run *)", "Edit(/src/**/*.ts)" ], "deny": [ "Bash(rm -rf *)", "Read(./.env)" ] } }

规则格式：工具名 或 工具名(匹配模式)，评估顺序：deny → ask → allow

八、MCP 服务器管理

MCP 命令

命令 说明 claude mcp add 添加 MCP 服务器 claude mcp list 列出所有已配置的 MCP 服务器 claude mcp get <名称> 查看指定服务器详情 claude mcp remove <名称> 移除 MCP 服务器 claude mcp serve 将 Claude Code 自身作为 MCP 服务器运行 claude mcp add-from-claude-desktop 从 Claude Desktop 导入 MCP 服务器

传输类型

类型 命令 说明 HTTP（推荐） claude mcp add --transport http <名称> 远程 HTTP 服务 SSE claude mcp add --transport sse <名称> 服务器发送事件（已弃用） Stdio claude mcp add --transport stdio <名称> -- <命令> 本地进程通信

配置作用域

作用域 存储位置 是否共享 local（默认） ~/.claude.json（按项目路径） 否 project 项目根目录 .mcp.json 是（版本控制） user ~/.claude.json（全局） 否

示例

# 添加 HTTP 类型的 MCP 服务器 claude mcp add --transport http notion https://mcp.notion.com/mcp # 添加本地 stdio 类型的 MCP 服务器 claude mcp add --transport stdio my-tool -- node ./my-mcp-server.js # 添加 JSON 配置 claude mcp add-json weather '{"type":"http","url":"https://weather-mcp.example.com"}'

九、Hooks 钩子系统

钩子事件

事件 触发时机 能否阻止 SessionStart 会话开始或恢复 否 UserPromptSubmit 用户提交提示词 是 PreToolUse 工具调用执行前 是（允许/拒绝/询问） PostToolUse 工具调用成功后 否（可提供反馈） PostToolUseFailure 工具调用失败后 否 Stop Claude 完成回复 是 Notification Claude 发送通知 否 SubagentStart 子代理创建时 否（可注入上下文） SubagentStop 子代理完成时 是 SessionEnd 会话终止时 否

钩子类型

• command：运行 Shell 命令

• prompt：单轮 LLM 评估

• agent：多轮子代理（有工具访问权限）

配置位置

位置 作用范围 ~/.claude/settings.json 所有项目 .claude/settings.json 当前项目（可共享） .claude/settings.local.json 当前项目（gitignore）

管理命令：输入 /hooks 进入交互式管理界面。

十、实用技巧

1. Bash 模式（! 前缀）

在输入框中以 ! 开头可直接运行 Shell 命令，输出会加入对话上下文：

! npm test ! git status ! dir

2. 文件引用（@ 提及）

输入 @ 后跟文件路径，Claude 会自动读取该文件：

@src/app.ts 这个文件有什么问题？

3. 后台任务

• 按 Ctrl+B 将运行中的命令移到后台

• 用 /tasks 查看和管理后台任务

4. 检查点与回退

Claude 在修改文件前会自动创建 git 检查点，按 Esc + Esc 或输入 /rewind 可回退到之前的状态。

5. 上下文压缩

当对话过长时，输入 /compact 压缩上下文：

/compact 只保留和数据库相关的内容

6. Vim 模式

输入 /vim 启用 Vim 风格编辑，支持常见操作：

• 模式切换：i、I、a、A、o、O、Esc

• 导航：h/j/k/l、w、e、b、0、$

• 编辑：x、dd、D、yy、p、P

7. 自定义技能（Skills）

在以下路径创建 SKILL.md 文件，即可通过 /技能名 调用：

位置 作用范围 ~/.claude/skills/<名称>/SKILL.md 个人所有项目 .claude/skills/<名称>/SKILL.md 当前项目

8. 子代理（Subagents）

Claude Code 内置多种子代理：

子代理 说明 Explore 只读探索代码库 Plan 分析和设计方案 Bash 命令执行 general-purpose 通用多步骤任务

可在 .claude/agents/ 目录下创建自定义代理。

9. 沙箱模式

在 settings.json 中启用文件系统和网络隔离：

{ "sandbox": { "enabled": true, "network": { "allowedDomains": ["github.com", "npmjs.org"] } } }

10. 常用环境变量速查

变量 说明 ANTHROPIC_MODEL 设置模型 ANTHROPIC_BASE_URL API 基础 URL ANTHROPIC_AUTH_TOKEN API 密钥 CLAUDE_CODE_EFFORT_LEVEL Effort 级别（low/medium/high） MAX_THINKING_TOKENS 扩展思考 Token 预算 CLAUDE_CODE_DISABLE_AUTO_MEMORY 禁用自动记忆（设为 1） CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 禁用非必要网络流量（设为 1）