Claude Code 终极使用指南 (截止2026年5月20日)以下是一份基于最新公开资料的Claude Code全干使用指南涵盖安装、命令体系、Skills安装与管理、CLAUDE.md记忆系统、高效提示词策略以及MCP生态扩展的全流程实战指引。一、安装与下载环境准备Node.js 18.0仅限 npm 安装方式Claude.ai 账号需完成手机验证支持 Windows、macOS、Linux含 WSL全平台安装方式方式一原生安装官方推荐零依赖截止2026年Anthropic已弃用 npm 安装方式主推零依赖的原生安装器# macOS / Linux / WSL (稳定版)curl-fsSLhttps://claude.ai/install.sh|bash# 或安装最新版curl-fsSLhttps://claude.ai/install.sh|bash-slatest# 安装特定版本curl-fsSLhttps://claude.ai/install.sh|bash-s1.0.58macOS 也可用 Homebrewbrew install --cask claude-codeWindows 下使用 PowerShell原生命令# 稳定版irmhttps://claude.ai/install.ps1|iex# 最新版((scriptblock)::Create((irmhttps://claude.ai/install.ps1)))latest方式二npm 全局安装传统方式npminstall-ganthropic-ai/claude-code验证安装与初始化claude--version# 确认版本号正确输出即安装成功执行claude启动后按提示完成 OAuth 认证浏览器登录 Claude 账号即可令牌自动缓存后续无需重复登录。二、配套软件与工具链Claude Code 生态已有许多第三方增强工具可以显著提升使用体验ccflare使用情况仪表板可视化交互操作Claude Squad同时管理多个 Claude Code 实例ccusage分析 Claude Code 使用情况与成本CCometixLine终端底部实时状态栏显示模型类型、Git 分支状态、上下文使用率等Rust 编写通过npm install -g cometix/ccline安装后在~/.claude/settings.json中配置即可使用claude-sound-fx声音提示插件支持Jarvis、GLaDOS等12种主题音效包任务完成、错误等7种触发事件claude-dev-toolkit58个AI 驱动自定义命令的开发工具包能自动化完整软件开发工作流codesight一键解决 Claude Code 理解项目项目所浪费的大量 Token4000 下载cc-switch国内用户适配与模型切换工具支持 GitHub 下载安装三、命令体系与常用命令Claude Code 内置超过 50 个命令大多数开发者仅使用其中 3-5 个。这些命令按形态分三类CLI 标志、斜杠命令、键盘快捷键。CLI 启动命令命令说明claude启动交互模式claude task运行一次性任务claude -p query查询后退出claude -c继续最近对话claude commit自动创建 Git 提交claude update手动更新版本claude mcp add ...添加 MCP 服务器claude mcp list列出已安装 MCP七大类斜杠命令1. 会话管理类日常高频命令功能说明/clear清除对话历史清除对话历史与命令历史从零开始/compact上下文压缩保留关键决策与模式回收 Token/resume恢复历史会话指定会话名继续/btw侧边提问不打断主任务的临时询问/compactvs/clear继续同一任务时用/compact切换到全新任务时用/clear。建议在上下文用量达70-80%时主动压缩不要等窗口填满。2. 上下文与资源管理类命令功能/context以彩色网格展示当前上下文用量/cost展示 Token 用量与费用按 API Key 计费团队必备/memory编辑CLAUDE.md记忆文件3. 模型与配置管理类命令功能/model切换模型Sonnet 4.6 / Opus 4.6 / Haiku 4.5/config调整权限、行为偏好与输出风格/permissions查看与更新工具权限日常策略Sonnet 起步日常编码→ 遇到复杂问题切 Opus架构决策→ 琐碎任务用 Haiku低成本快速4. 代码分析与质量类命令功能/diff交互式差异查看器展示当前未提交修改及 Claude 每轮操作变动/review对改动代码进行 Code Review/security-review安全审计注入攻击、认证缺陷等/simplify并行启动三个审查 Agent检查代码复用性、质量与效率后自动修复/batch大规模代码改造的并行编排命令将任务拆解为 5-30 个独立单元自动发起 PR5. 项目初始化与诊断类命令功能/init扫描代码库自动生成CLAUDE.md/doctor检查安装健康状况与环境诊断/debug开启当前会话调试日志并分析/stats可视化每日用量与模型偏好统计/plan进入计划模式输出方案供确认不立即修改代码6. 工作流增强命令功能/add-dir添加额外工作目录/autofix-pr持续监听 PR 的云端 AgentCI 失败时自动推送修复/insights生成项目使用分析报告交互模式、常见摩擦点等/schedule云端定时任务支持对话式配置流程键盘快捷键快捷键功能Ctrl C打断 AI 执行Ctrl R搜索命令历史Ctrl O切换详细输出模式Shift Tab切换权限模式信任模式 / 确认模式Esc Esc撤销上一次文件改动紧急回退Shift Enter多行输入跨平台通用输入/即可弹出所有可用命令的交互式列表输入/后接字母可实时过滤。四、Skills技能安装与管理Skills 的概念Skills 是 Claude Code 的模块化能力扩展系统每个 Skill 由一个SKILL.md文件定义Markdown YAML frontmatter存放于指定目录后 Claude Code 自动发现可用/skill-name调用无需编写代码或安装外部依赖。安装方式方式一官方插件市场安装# 注册官方 Skills 仓库为插件源/plugin marketplaceaddanthropics/skills# 安装文档处理包含 pdf/xlsx/docx/pptx/plugininstalldocument-skillsanthropic-agent-skills方式二手动安装# 项目级 Skill推荐团队共享跟随 Git 版本控制mkdir-p.claude/skills/skill-name# 放入 SKILL.md 后即刻生效# 用户级 Skill全局跨项目mkdir-p~/.claude/skills/skill-name方式三通过 skillhub 发现与安装pipinstallskillhub skillhub search security# 搜索安全类技能skillhubinstallsecurity-review# 一键安装到 Claude CodeSkill 安装目录自动映射~/.claude/skills/name/SKILL.md。方式四通过 skills 命令行工具安装# 全局安装npx skillsaddskill-name-g-y# 安装到指定客户端claude-skillsinstallskill-name--clientclaude-code必装 Skills按优先级推荐第一梯队通用基础型Skill功能典型用法pdfPDF 读取、提取、合并、拆分、OCR 识别/pdf 提取这份合同的所有条款整理成表格xlsxExcel/表格数据处理、清洗、图表、格式化/xlsx 清洗这份CSV并生成汇总报表docxWord 文档创建与编辑支持与 PDF 配合形成文档流水线/docx 把技术规范转成Word格式data-analysis全链路数据分析探查→质检→执行→报告/data-analysis 分析这份销售数据找出GMV趋势第二梯队开发与设计型Skill功能frontend-design生产级前端界面与组件支持 React / HTML / CSSpptx幻灯片生成社区高价值 Skillpr-review自动 PR 审查与单元测试建议refactor多文件重构生成分支补丁与提交计划security-review深度安全审计OWASP、注入攻击等第三梯队效率与发布Skill功能seoSEO 审计与内容优化changelog基于 Conventional Commits 自动生成发布记录tdd测试驱动开发流程先编写失败测试再实现代码spec编码前生成完整规格说明如何验证已安装的 Skills在 Claude Code 会话中输入/skills即可列出所有已安装的技能并查看其描述。五、CLAUDE.md 记忆系统什么是 CLAUDE.mdCLAUDE.md是一个Markdown文件文件名严格区分大小写CLAUDE 大写、.md 小写。Claude Code 在每次会话开始时自动读取将其中内容作为持久化项目上下文注入。这样就不必每次开新会话都重新解释一遍项目的技术栈和偏好规则。配置文件的优先级Claude Code 的配置遵循明确层次CLAUDE.local.md最高优先级个人偏好应加入.gitignore项目根目录CLAUDE.md核心推荐纳入 Git 版本控制团队共享~/.claude/CLAUDE.md用户全局默认所有项目生效同目录下更具体的配置会覆盖更泛化的配置与 settings.json 的分工CLAUDE.md自然语言指令告诉 Claude“做什么”项目规范、编码约定、工作流约定settings.json结构化配置控制 Claude Code 工具本身的行为权限规则、钩子声明、环境变量CLAUDE.md 最佳结构建议总长度控制在 300 行以内关键部分五大块# 项目概述 - 一句话项目定位 - 语言/框架/包管理/数据库/缓存 # 编码规范 - TypeScript strict mode禁止 any - 使用命名导出不用默认导出 - CSS 统一用 Tailwind 工具类不新建自定义 CSS 文件 # 构建与测试命令 - 开发启动npm run dev - 单元测试npm run test - 端到端测试npm run test:e2e - 代码检查npm run lint # 禁止事项核心红线 - DO NOT 修改 config/ 下的任何文件 - DO NOT 未经审批更改依赖版本 - NEVER 提交 .env 文件 # Git 工作流 - 分支Gitflow 模式 - Commit Message严格遵循 Conventional Commits如 feat: / fix: / chore:关键技巧在关键规则前加IMPORTANT:或YOU MUST:进行强调可大幅提升规则遵循率使用path/to/file.md语法导入外部文件将详细指引拆分成独立文件在主线文件中引用保持主干文件精干在.claude/rules/目录下放置模块化规则文件如code-style.md、testing.md、security.mdClaude Code 会自动加载无需手动导入生成初始文件最快的方式在项目中运行/initClaude 会自动扫描代码库生成初始版本在生成基础上删除不需要的内容比从零开始更高效如果某条规则容易被忽略把它从CLAUDE.md移到Hooks钩子Hook 是硬约束不会被忽略六、有效提示词的写法核心结构OCA 原则高效的 Claude Code 提示词遵循OCA 结构Objective目标明确要达成的结果Context上下文关键约束和项目背景Expected预期成功的具体衡量标准典型坏提示“fix the bug” —— 信息严重不足典型好提示“src/auth.ts中的login函数当传入空白 token 时报TypeError请分析根因并修复修复后运行npm run test确认通过”五大场景提示词模板1. 项目初始化请阅读项目的 README.md、package.json 和主要目录 了解项目架构和技术栈暂时不要编写任何代码。2. 新功能开发分步确认我需要开发【功能描述】请按以下步骤 1. 先阅读相关代码了解现有架构 2. 制定详细的实现计划 3. 实现核心功能 4. 编写测试 5. 更新文档 每完成一步暂停等待我确认。3. 测试驱动开发我要实现【功能描述】。请先基于期望的输入输出编写测试用例 确保测试会失败然后再实现功能代码使测试通过。4. Bug 修复标准格式报错信息【粘贴完整报错】 出错位置【文件路径或组件名】 触发条件【什么操作导致报错】 要求 1. 找根因不要只注释掉报错 2. 修完后运行【测试命令】验证 3. 说明改了什么、为什么这么改5. 跨文件重构把【功能/组件名】从【当前实现方式】改成【目标方式】。 涉及文件 - 【文件A】需要改【具体内容】 - 【文件B】需要改【具体内容】 改完后运行【测试命令】确认没有破坏其他功能。进阶技巧分步确认Agent 模式复杂任务让 Claude 按步骤执行每步暂停等待确认避免一次性推理出错子代理分工大而全的提示词易让 AI 过载可拆分为多个专业化子代理分别处理不同模块专注比聪明更重要约束反而能提升质量计划模式先行执行复杂任务前使用/plan让 Claude 先输出完整操作方案确认无误后再执行上下文负载管理谨慎使用import和.claude/rules/模块化系统每个会话的上下文空间极其宝贵确保不同专业的细节按需加载而非一次性全塞进上下文七、MCP 的连接与推荐MCP 是什么MCPModel Context Protocol是 Anthropic 推出的开放标准为 Claude Code 提供标准化的外部工具与数据源接入能力。MCP 使 Claude Code 不再是一个单纯的对话工具而是可以连接数据库、操作 GitHub、运行浏览器、处理本地文件的自动化工作站。三种传输方式方式建议程度适用场景典型示例HTTP强烈推荐云端 MCP 服务器跨网络通信兼容性最佳Notion、GitHub、SentryStdio推荐本地进程直接系统访问Python/Node.js 脚本、本地数据库SSE不推荐已弃用旧版远程服务连接Asana已有HTTP替代方案的应优先使用HTTP连接命令与作用域远程 HTTP MCP 服务器安装# 标准安装claude mcpadd--transporthttpserver-namehttps://api.example.com/mcp# 带 Bearer Token 鉴权claude mcpadd--transporthttp secure-api https://api.example.com/mcp\--headerAuthorization: Bearer your-token# 示例连接 Notionclaude mcpadd--transporthttp notion https://mcp.notion.com/mcp本地 Stdio MCP 服务器安装# 基础安装注意 -- 之后是服务器启动命令claude mcpadd--transportstdio my-server -- npx-yserver-package# Python 服务器claude mcpadd--transportstdio python-server -- python3 /path/to/server.py--port8080# Windows 环境必须用 cmd /c 包装claude mcpadd--transportstdio my-server -- cmd /c npx-ysome/package三种作用域选择作用域配置存储位置适用场景local默认~/.claude.json与当前目录绑定单项目专属工具project项目根目录.mcp.json可提交 Git团队共享工具user全局配置个人所有项目通用⚠️ 注意--是关键分隔符之前是 Claude Code 自身参数之后是 MCP 服务器的启动命令与参数。管理与维护命令claude mcp list# 列出所有已安装 MCP 服务器claude mcp getserver# 查看指定服务器详细配置claude mcp removeserver# 移除服务器claude mcp add-from-claude-desktop# 从 Claude Desktop 一键导入仅 macOS/WSL 五大必装 MCP 服务器推荐1. Firecrawl MCP —— 网页内容提取将网页转为清洁文本去除导航、广告等噪音。免费额度每月 500 次。配置简单动态页面需加waitFor参数。claude mcpadd--transportstdio firecrawl -- npx-yfirecrawl-mcp\--envFIRECRAWL_API_KEYfc-your-key-hereAPI Key 可在 firecrawl.dev 免费注册领取。2. GitHub MCP —— 仓库操作中枢读写 Issues、PRs、文件、搜索代码Token 权限仅需reporead:org不要给更大权限。claude mcpaddgithub -- npx-ymodelcontextprotocol/server-github\--envGITHUB_PERSONAL_ACCESS_TOKENghp_xxxxxxxxxxxx3. PostgreSQL MCP —— 数据库直接查询⚠️严禁连接生产库务必连接本地开发库或只读副本。连接字符串中密码含特殊字符如、#需 URL 编码。claude mcpadd--transportstdio postgres -- npx-ymodelcontextprotocol/server-postgres\--envPOSTGRES_CONNECTION_STRINGpostgresql://user:passwordlocalhost:5432/mydb4. Filesystem MCP —— 跨目录文件访问突破 Claude Code 的工作目录限制读写指定目录。参数中列出允许访问的目录必须使用绝对路径。claude mcpadd--transportstdio filesystem -- npx-ymodelcontextprotocol/server-filesystem\/absolute/path/to/projects /absolute/path/to/logs5. Brave Search MCP —— 让 AI 能自主搜索免费额度每月 2000 次查询英文搜索质量优于中文。搜索结果仅为摘要文本需要完整网页内容时需搭配 Firecrawl。claude mcpadd--transportstdio brave-search -- npx-ymodelcontextprotocol/server-brave-search\--envBRAVE_API_KEYBSA_xxxxxxxxxxxxxxxxAPI Key 可在 brave.com/search/api 注册获取。MCP 组合实战案例需求“帮我调研市面上的表单构建工具看看哪个适合我们项目”AI 的自动化流程Brave Search 搜索open source form builder 2026Firecrawl 爬取候选工具文档页GitHub MCP 查看各仓库活跃度Star 数、最近提交、Issue 数量PostgreSQL MCP 查询现有表单模块表结构做对比Filesystem MCP 将调研结果写入本地文档整个过程只需一句话无需任何人工干预。安全提醒API Key 和数据库密码放在环境变量中绝不写死在配置文件并提交到 GitGitHub Token只给最小必要权限repo read:org数据库连接底线是不可逆操作的生产库只连开发库或只读副本通过以上七个方面的系统配置你可以将 Claude Code 从基础编程助手升级为完整的自动化 AI 编码工作站实现生产力质的飞跃。建议先完成安装和CLAUDE.md初始化再逐步安装核心 Skills 和 MCP每一步都能感受到效率的明显提升。