Claude Code 命令速查

一份给新手的快速参考指南，随用随查。

注意：快捷键以 macOS 为主，Windows 用户请将 Cmd 替换为 Ctrl，Option 替换为 Alt。

🚀 快速开始

安装与启动

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

# 启动（在项目目录下）
claude

# 启动并指定目录
claude /path/to/your/project

# 带初始问题启动
claude "explain this codebase"

认证相关

# 登录 Anthropic 账号
claude auth login

# 使用 API Key 方式登录（按量计费）
claude auth login --console

# 查看登录状态
claude auth status

# 退出登录
claude auth logout

# 检查版本
claude --version

# 更新到最新版
claude update

⌨️ 键盘快捷键

常规控制（macOS）

快捷键	作用	Windows 对应
`Cmd + C`	取消输入/生成	`Ctrl + C`
`Cmd + D`	退出会话	`Ctrl + D`
`Cmd + L`	清屏	`Ctrl + L`
`Cmd + O`	切换详细输出	`Ctrl + O`
`Cmd + R`	反向搜索历史	`Ctrl + R`
`Cmd + G`	在编辑器中打开提示	`Ctrl + G`
`Cmd + B`	后台运行任务	`Ctrl + B`
`Cmd + T`	切换任务列表	`Ctrl + T`
`Esc Esc`	回退/撤销	`Esc Esc`

模式切换

快捷键	作用
`Shift + Tab`	循环切换权限模式
`Option + P`	切换模型
`Option + T`	切换思考模式

权限模式说明：

default - 默认模式，需要确认
acceptEdits - 自动接受编辑
plan - 只读规划模式
dontAsk - 未允许则拒绝
auto - 自动模式（Team 计划）

📋 核心命令

文件操作

命令	作用	示例
`/open <文件>`	打开文件让 AI 查看	`/open src/main.js`
`/edit <文件>`	编辑指定文件	`/edit README.md`
`/add <文件>`	添加文件到对话上下文	`/add package.json`
`/ls`	列出当前目录文件	`/ls src/`
`/cat <文件>`	查看文件内容	`/cat .env.example`

会话管理

命令	作用
`/clear`	清空对话历史
`/compact [focus]`	压缩上下文（带焦点压缩）
`/resume`	恢复/切换会话
`/rename <name>`	命名当前会话
`/branch <name>`	分支对话（/fork 别名）
`/cost`	Token 用量统计
`/undo`	撤销上一次修改
`/redo`	重做
`/exit` 或 `Cmd+D`	退出 Claude Code

会话恢复快捷方式：

# 继续上次对话
claude -c

# 按名称恢复会话
claude -r "session-name"

# 创建命名会话
claude -n "my-feature-work"

代码操作

命令	作用	示例
`/search <关键词>`	搜索代码	`/search "function login"`
`/grep <正则>`	正则搜索	`/grep "TODO\|FIXME"`
`/run <命令>`	执行终端命令	`/run npm test`
`/test`	运行测试	`/test`
`/diff`	交互式差异查看器	`/diff`
`/copy`	复制上次回复	`/copy`
`/simplify`	自动简化代码	`/simplify`

Skills 管理

命令	作用	示例
`npx skills add <skill>`	安装 Skill	`npx skills add obra/superpowers -g -y`
`/skills`	列出可用技能	`/skills`
`/skill <name>`	使用特定 Skill	`/skill frontend-design`
`/skills reload`	热重载插件	`/skills reload`

配置与设置

命令	作用
`/config`	打开设置
`/model [model]`	切换模型（←→努力程度）
`/fast [on	off]`
`/vim`	切换 vim 模式
`/theme`	更改颜色主题
`/permissions`	查看/更新权限
`/effort [level]`	设置努力程度（low/med/high/max）
`/color [color]`	设置提示栏颜色
`/init`	创建 CLAUDE.md
`/memory`	编辑 CLAUDE.md 文件

MCP 与扩展

命令	作用
`/mcp`	管理 MCP 服务器
`/hooks`	管理钩子
`/chrome`	Chrome 集成
`/reload-plugins`	热重载插件

🎯 高级功能

Plan 模式（规划模式）

适合复杂任务，先规划再执行：

# 进入 Plan 模式
/plan

# 以计划模式启动（带参数）
claude --permission-mode plan

# 查看当前计划
/plan status

# 执行计划的某一步
/plan do 1

# 退出 Plan 模式
/plan exit

思考与努力程度：

Option + T 切换思考开/关（macOS）
Alt + T 切换思考开/关（Windows）
"ultrathink" 当前轮次最大努力程度
Cmd + O 查看思考（详细模式）
/effort 设置努力程度（low/med/high/max）

Agent 模式（代理模式）

让 AI 自主完成多步骤任务：

# 启动 Agent 执行任务
/agent 重构这个函数，添加错误处理

# 查看正在运行的 Agent
/agents

# 终止后台代理
Ctrl + F（按两次）

Git Worktrees：

# 创建独立工作分支
claude -w feature-name

# 带 tmux 创建工作分支
claude -w feature-name --tmux

特殊模式

命令	作用
`/voice`	按键说话（20种语言）
`/btw <question>`	附带提问（无上下文）
`/loop [interval]`	调度周期性任务
`/doctor`	诊断安装问题
`/pr-comments [PR]`	获取 GitHub PR 评论

🚀 命令行高级用法

无头模式（非交互式）

# 执行单次查询后退出
claude -p "分析这个项目的架构"

# 带预算限制
claude -p --max-budget-usd 5 "重构这个函数"

# JSON 格式输出
claude -p --output-format json "列出所有 API 端点"

# 流式 JSON 输出
claude -p --output-format stream-json --include-partial-messages "任务"

# 限制轮数
claude -p --max-turns 3 "分析代码"

# 禁用会话持久化
claude -p --no-session-persistence "一次性任务"

管道输入

# 从文件读取输入
cat file.txt | claude -p "分析这个文件"

# 结合其他命令
ls *.js | claude -p "这些文件是做什么的"

# 查看日志
tail -100 app.log | claude -p "找出错误原因"

自定义系统提示词

# 追加自定义提示词
claude --append-system-prompt "Always use TypeScript"

# 从文件追加
claude --append-system-prompt-file ./style-rules.txt

# 完全替换系统提示词
claude --system-prompt "You are a Python expert"

# 从文件加载完整提示词
claude --system-prompt-file ./custom-prompt.txt

工具限制与权限

# 仅允许特定工具
claude --tools "Bash,Edit,Read"

# 禁用所有工具
claude --tools ""

# 允许特定工具无需确认
claude --allowedTools "Bash(git log *)" "Bash(git diff *)" "Read"

# 禁用特定工具
claude --disallowedTools "Bash(rm *)" "Edit"

# 跳过权限检查（谨慎使用）
claude --dangerously-skip-permissions

# 启用 auto mode
claude --enable-auto-mode

模型与性能

# 指定模型
claude --model sonnet
claude --model opus
claude --model claude-sonnet-4-6

# 设置努力程度
claude --effort high
claude --effort max    # Opus 4.6 可用

# 快速模式
claude --bare -p "快速查询"

# 详细日志
claude --verbose

# 调试模式
claude --debug "api,mcp"

多目录与插件

# 添加额外工作目录
claude --add-dir ../shared ../utils

# 从目录加载插件
claude --plugin-dir ./my-plugins

# 禁用所有技能
claude --disable-slash-commands

MCP 配置

# 指定 MCP 配置文件
claude --mcp-config ./mcp.json

# 仅使用指定配置
claude --strict-mcp-config --mcp-config ./mcp.json

# 配置 MCP 服务器
claude mcp

远程控制与 Web 会话

# 启动远程控制服务器
claude remote-control --name "My Project"

# 交互式会话 + 远程控制
claude --remote-control "My Project"

# 创建 Web 会话
claude --remote "Fix the login bug"

# 接管 Web 会话到本地
claude --teleport

# 从 PR 恢复会话
claude --from-pr 123

子代理 (Subagents)

# 列出所有子代理
claude agents

# 动态定义子代理
claude --agents '{"reviewer":{"description":"Code reviewer","prompt":"You are a code reviewer"}}'

# 设置队友显示模式
claude --teammode in-process

🔧 配置与调试

配置文件

文件	作用
`CLAUDE.md`	项目级配置，告诉 AI 项目背景
`~/.claude/settings.json`	用户级全局配置
`~/.claude/settings.local.json`	仅本地配置
`.claudeignore`	忽略文件，类似 .gitignore

重要环境变量

变量	说明
`ANTHROPIC_API_KEY`	API 密钥
`ANTHROPIC_MODEL`	模型选择
`CLAUDE_CODE_EFFORT_LEVEL`	努力程度（low/med/high）
`MAX_THINKING_TOKENS`	思考 Token 上限（0=关闭）
`CLAUDE_CODE_SIMPLE`	启用简化模式

调试命令

# 查看系统提示词
/debug prompt

# 查看当前上下文
/debug context

# 性能分析
/debug perf

# 从调试日志排查问题
/debug [desc]

💡 使用技巧

1. 快速引用代码

1 2	查看 @src/main.js 的第 10-20 行分析一下 @package.json 里的依赖

2. 使用 @ 引用文件

1 2	帮我优化 @src/utils/helper.js 里的代码看看 @README.md 里的 API 说明

3. 批量操作

1 2	把 src 目录下所有 .js 文件改成 .ts 查找并替换所有 console.log 为 logger.debug

4. 快速添加目录

1 2	把 config 目录下的所有文件加进来 /add config/

5. 上下文管理

1 2	记住这个函数叫工具函数，后面会用到基于我们刚才讨论的优化方案，修改代码

6. 代码简化（必用）

每次大的修改后，或 AI 生成一批代码后，运行：

/simplify

这会自动清理未使用的 import、冗余变量、提取共用逻辑。

❓ 常见问题

Q: Claude Code 和网页版有什么区别？
A: Claude Code 是终端工具，能直接操作你的本地文件和运行命令；网页版只能对话。

Q: 如何让它记住项目规范？
A: 在项目根目录创建 CLAUDE.md 文件，写入项目介绍、技术栈、编码规范等。

Q: 不小心让它改错了代码怎么办？
A: 使用 /undo 命令撤销，或用 Git 回滚。建议在重要项目里先提交再使用。

📚 参考资源

💬 提示：在 Claude Code 里随时输入 ? 或 /help 查看可用命令。