本文系统整理 Anthropic 官方命令行工具Claude Code终端里的 Claude的全部常用命令、启动参数、斜杠命令、快捷键、配置文件、权限机制、MCP 与 Hook 用法并附实战示例与 FAQ。收藏这一篇日常开发基本不用再翻文档。目录启动与退出核心启动参数CLI Flags子命令Subcommands会话内斜杠命令Slash Commands键盘快捷键配置文件与 CLAUDE.md权限与权限模式MCP 工具配置Hooks 钩子自动化实战场景示例效率技巧常见问题 FAQ一、启动与退出命令作用claude进入交互式 REPL最常用claude 一句话需求带着初始 prompt 启动claude -p ...打印模式执行后直接输出结果并退出适合管道claude -c/claude --continue继续最近一次会话claude -r/claude --resume弹出历史会话列表选择恢复claude -v/claude --version查看版本claude -h/claude --help查看完整帮助退出会话输入exit或/exit快捷键Ctrl D发送 EOF或Ctrl C多次中断后退出部分环境小提示交互模式下连续两次Ctrl C可中断当前 AI 执行。二、核心启动参数CLI Flags下面是日常最常用、也是最容易忘的参数建议收藏。参数说明-p, --print打印模式执行完直接输出并退出非交互适合脚本-y, --yes自动同意所有权限提示等价于--dangerously-skip-permissions--dangerously-skip-permissions跳过所有权限确认仅在你信任的环境使用-m, --model model指定本次会话模型如claude-sonnet-4-0/claude-opus-4-0--fallback-model model主模型不可用时的备用模型--output-format fmt输出格式text默认/json/stream-json--input-format fmt输入格式text默认/stream-json--verbose输出详细日志--permission-mode mode权限模式default/acceptEdits/bypassPermissions/plan--allowedTools tools逗号分隔只允许指定工具如Bash,Edit,Read--disallowedTools tools逗号分隔禁用指定工具--mcp-config path指定 MCP 配置文件路径--add-dir dir额外授权可访问的目录可多次--system-prompt prompt覆盖系统提示词可多次--append-system-prompt prompt追加系统提示词可多次--session-id uuid指定会话 ID 以便恢复--settings json/--settings-file path注入 / 指定设置--config-file path指定配置来源-d, --debug调试模式--no-color关闭彩色输出常见组合示例# 跳过权限用指定模型跑一条任务并直接退出自动化神器claude-y-mclaude-sonnet-4-0-p给 src/ 写单元测试# 只开放读写文件禁止执行命令更安全的自动化claude-p--allowedToolsRead,Edit,Write,Glob,Grep重构 utils.ts# 以 JSON 格式输出方便被其他程序解析claude-p--output-format json解释 main.py 的入口逻辑# 把 Claude 当管道工具用caterror.log|claude-p这是一段报错给出可能原因和修复方案⚠️--dangerously-skip-permissions会放行文件写入、命令执行等敏感操作。命令越长越易手滑建议起个别名。例如在你的~/.zshrc里加alias claude-skipclaude --dangerously-skip-permissions之后claude-skip -p ...即可。三、子命令Subcommands除了交互模式Claude Code 还带几个独立子命令最常用的是mcp和config。claude mcpaddnamecommand...# 添加一个 MCP 服务器claude mcp add-jsonnamejson# 用 JSON 添加 MCP 服务器claude mcp list# 列出已配置的 MCP 服务器claude mcp getname# 查看某个 MCP 服务器详情claude mcp removename# 移除 MCP 服务器claude config getkey# 读取某项配置claude configsetkeyvalue# 设置某项配置claude config list# 列出全部配置claude update# 更新到最新版claude doctor# 诊断环境/配置问题示例# 添加本地 stdio 型 MCP 服务器claude mcpaddmy-tool -- npx-ymy-mcp-server# 查看某配置项claude config get model四、会话内斜杠命令Slash Commands在 REPL 交互界面里输入/即可触发是提效的关键武器。命令作用/help列出所有命令与用法/clear清空当前对话上下文轻量重置/compact压缩对话历史释放上下文窗口/config修改会话级配置/cost查看本次会话的 token 消耗与花费/doctor诊断运行环境/init根据项目结构生成CLAUDE.md记忆文件/login登录 / 切换账号/logout退出登录/memory编辑长期记忆文件/model切换当前使用的模型/permissions查看 / 调整权限规则/review对改动做代码评审/status查看当前状态模型、权限、目录等/vim切换 Vim 编辑模式/ide配置 / 查看 IDE 集成状态/terminal-setup安装终端集成更好看的历史、补全/mcp管理 MCP 服务器/add-dir在会话中追加可访问目录/reset重置配置到默认斜杠命令也可以在命令行直接调用例如claude /review、claude /compact。五、键盘快捷键交互模式下基于终端 UI快捷键作用Ctrl C中断当前 AI 执行连按两次退出Ctrl D发送 EOF退出会话Ctrl L清屏Ctrl R搜索历史命令↑ / ↓浏览历史输入Tab自动补全Esc取消当前输入Shift Tab循环切换权限模式default → acceptEdits → bypassPermissionsCtrl Z将 Claude 挂起fg 可恢复六、配置文件与 CLAUDE.mdClaude Code 有三层配置体系理解它能让 AI 更“懂”你的项目。1. 用户级全局~/.claude/settings.json— 所有项目共享的偏好如默认模型、主题、权限。2. 项目级.claude/settings.json项目根目录— 团队共享的仓库配置。3. 项目记忆CLAUDE.md放在仓库根目录Claude 每次启动都会读它相当于给 AI 的“项目说明书”。建议写入项目技术栈与目录结构命令约定构建、测试、lint 怎么跑代码风格与命名规范常见坑与注意事项示例CLAUDE.md# 项目说明 - 技术栈Next.js 14 TypeScript Tailwind - 构建npm run build - 测试npm test - 代码风格函数式为主禁止 any - 注意改动 API 后必须同步更新 docs/生成命令claude /init# 让 Claude 自动扫描项目并起草 CLAUDE.md七、权限与权限模式Claude 执行“危险”操作写文件、跑命令前会请求确认。四种权限模式模式行为default每个敏感操作都弹确认acceptEdits自动接受文件编辑命令仍需确认bypassPermissions全部放行等价于--dangerously-skip-permissionsplan规划模式只分析不改代码设置方式# 启动时指定claude --permission-mode acceptEdits# 会话内用 ShiftTab 循环切换或 /permissions 查看精细化权限settings.json 示例{permissions:{allow:[Bash(npm test),Bash(npm run build),Edit(~/.claude/**)],deny:[Bash(rm -rf *)]}}八、MCP 工具配置MCPModel Context Protocol让 Claude 接入外部工具/数据源数据库、浏览器、内部 API 等。添加 MCP 服务器# stdio 型最常用claude mcpaddgithub -- npx-yanthropic-ai/mcp-server-github# 带环境变量claude mcpaddmydb--envAPI_KEYxxx -- npx-ymy-db-mcp# 远程型HTTP/SSEclaude mcpaddremote-foo--transporthttp https://example.com/mcp# JSON 方式适合复杂配置claude mcp add-json my-srv{command:npx,args:[-y,pkg],env:{K:V}}管理claude mcp list# 列出全部claude mcp get my-srv# 查看详情claude mcp remove my-srv配置文件位置MCP 配置会写入~/.claude.json用户级或项目.mcp.json。九、Hooks 钩子自动化Hooks 允许在 Claude 执行某些动作前后自动触发脚本典型用途提交前自动 lint / 格式化写文件后自动跑测试记录操作审计日志配置示例settings.json{hooks:{PostToolUse:[{matcher:Edit|Write,hooks:[{type:command,command:npx prettier --write $CLAUDE_FILE_PATHS}]}]}}常用事件PreToolUse、PostToolUse、Notification、Stop。十、实战场景示例场景 1自动化修复 CI 报错claude-y-p读取 .github/workflows 的失败日志定位并修复导致 CI 失败的代码场景 2给新同事生成项目上手文档claude /init# 然后追加 /memory 说明约定场景 3评审 PRclaude /review场景 4当管道工具处理日志kubectl logs pod-xxx|claude-p--output-format text总结关键错误并给修复建议场景 5长对话压缩继续干活claude /compact# 压缩上下文claude-c# 下次继续十一、效率技巧写一份高质量的CLAUDE.md越是复杂项目越要花几分钟写清楚约定后面省下的时间是指数级的。用别名省键盘claude-skip等别名处理长参数。善用打印模式进脚本claude -p--output-format json可嵌进 CI、Git hook、定时任务。Shift Tab 切权限临时需要放行时不用退出重开。/cost控预算长任务中随时看 token 消耗。/compact续命上下文快满时压缩保留关键记忆。按项目配.claude/settings.json把团队权限、hooks 固化进仓库新人 clone 即用。十二、常见问题 FAQQ1提示command not found: claudeA确认全局安装成功npm prefix -g的 bin 目录在$PATH里或重装npm install -g anthropic-ai/claude-code。Q2--dangerously-skip-permissions安全吗A会跳过所有确认只在本机、可信目录、可信任务下使用切勿在公共/生产服务器上裸跑。Q3如何切换模型A会话内/model或启动时--model claude-opus-4-0。Q4上下文太长变慢/报错A用/compact压缩或/clear重新开始重要信息写进CLAUDE.md。Q5如何团队协作共享配置A把.claude/settings.json和CLAUDE.md提交进仓库MCP 用.mcp.json。Q6Claude 能直接改我的 Git 并提 PR 吗A可以它原生支持 Git 操作但建议用default/acceptEdits权限模式提交前自己 review。总结Claude Code 的威力在于“命令行即能力”-p让你把它当管道工具/review、/compact提供工程化工作流MCP 与 Hooks 则把它接进你的整个工具链。记住三件套——写好CLAUDE.md、管好权限模式、用好打印模式——基本就能覆盖 90% 的开发场景。如果本文对你有帮助欢迎点赞收藏也欢迎在评论区补充你常用的命令组合 本文命令基于 Claude Code 近期稳定版整理版本迭代请以claude --help为准。