当前位置： 首页 > news >正文

Claude Code 终极使用指南 (截止2026年5月20日)

news 2026/6/2 11:14:30

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.58

macOS 也可用 Homebrew：brew install --cask claude-code

Windows 下使用 PowerShell（原生命令）：

# 稳定版irmhttps://claude.ai/install.ps1|iex# 最新版&((scriptblock)::Create((irmhttps://claude.ai/install.ps1)))latest

方式二：npm 全局安装（传统方式）

npminstall-g@anthropic-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-toolkit：58个AI 驱动自定义命令的开发工具包，能自动化完整软件开发工作流
  • codesight：一键解决 Claude Code 理解项目项目所浪费的大量 Token，4000+ 下载
  • 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 个独立单元自动发起 PR

5. 项目初始化与诊断类

命令功能
/init扫描代码库自动生成CLAUDE.md
/doctor检查安装健康状况与环境诊断
/debug开启当前会话调试日志并分析
/stats可视化每日用量与模型偏好统计
/plan进入计划模式，输出方案供确认，不立即修改代码

6. 工作流增强

命令功能
/add-dir添加额外工作目录
/autofix-pr持续监听 PR 的云端 Agent，CI 失败时自动推送修复
/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-skills@anthropic-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 Code

Skill 安装目录自动映射：~/.claude/skills/<name>/SKILL.md。

方式四：通过 skills 命令行工具安装

# 全局安装npx skillsadd<skill-name>-g-y# 安装到指定客户端claude-skillsinstall<skill-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 / CSS
pptx幻灯片生成（社区高价值 Skill）
pr-review自动 PR 审查与单元测试建议
refactor多文件重构，生成分支补丁与提交计划
security-review深度安全审计（OWASP、注入攻击等）

第三梯队：效率与发布

Skill功能
seoSEO 审计与内容优化
changelog基于 Conventional Commits 自动生成发布记录
tdd测试驱动开发流程（先编写失败测试，再实现代码）
spec编码前生成完整规格说明

如何验证已安装的 Skills

在 Claude Code 会话中输入/skills即可列出所有已安装的技能并查看其描述。

五、CLAUDE.md 记忆系统

什么是 CLAUDE.md

CLAUDE.md是一个Markdown文件（文件名严格区分大小写：CLAUDE 大写、.md 小写）。Claude Code 在每次会话开始时自动读取，将其中内容作为持久化项目上下文注入。这样就不必每次开新会话都重新解释一遍项目的技术栈和偏好规则。

配置文件的优先级

Claude Code 的配置遵循明确层次：

  1. CLAUDE.local.md（最高优先级，个人偏好，应加入.gitignore）
  2. 项目根目录CLAUDE.md（核心推荐，纳入 Git 版本控制，团队共享）
  3. ~/.claude/CLAUDE.md（用户全局默认，所有项目生效）
  4. 同目录下更具体的配置会覆盖更泛化的配置

与 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.md），Claude Code 会自动加载，无需手动导入
  • 生成初始文件最快的方式：在项目中运行/init，Claude 会自动扫描代码库生成初始版本，在生成基础上删除不需要的内容比从零开始更高效
  • 如果某条规则容易被忽略，把它从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 是什么

MCP（Model Context Protocol）是 Anthropic 推出的开放标准，为 Claude Code 提供标准化的外部工具与数据源接入能力。MCP 使 Claude Code 不再是一个单纯的对话工具，而是可以连接数据库、操作 GitHub、运行浏览器、处理本地文件的自动化工作站。

三种传输方式

方式建议程度适用场景典型示例
HTTP强烈推荐云端 MCP 服务器，跨网络通信，兼容性最佳Notion、GitHub、Sentry
Stdio推荐本地进程，直接系统访问Python/Node.js 脚本、本地数据库
SSE不推荐（已弃用）旧版远程服务连接Asana（已有HTTP替代方案的应优先使用HTTP）

连接命令与作用域

远程 HTTP MCP 服务器安装

# 标准安装claude mcpadd--transporthttp<server-name><https://api.example.com/mcp># 带 Bearer Token 鉴权claude mcpadd--transporthttp secure-api https://api.example.com/mcp\--header"Authorization: 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-y@some/package

三种作用域选择

作用域配置存储位置适用场景
local（默认）~/.claude.json（与当前目录绑定）单项目专属工具
project项目根目录.mcp.json（可提交 Git）团队共享工具
user全局配置个人所有项目通用

⚠️ 注意：--是关键分隔符，之前是 Claude Code 自身参数，之后是 MCP 服务器的启动命令与参数。

管理与维护命令

claude mcp list# 列出所有已安装 MCP 服务器claude mcp get<server># 查看指定服务器详细配置claude mcp remove<server># 移除服务器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_KEY=fc-your-key-here

API Key 可在 firecrawl.dev 免费注册领取。

2. GitHub MCP —— 仓库操作中枢
读写 Issues、PRs、文件、搜索代码，Token 权限仅需repo+read:org（不要给更大权限）。

claude mcpaddgithub -- npx-y@modelcontextprotocol/server-github\--envGITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx

3. PostgreSQL MCP —— 数据库直接查询
⚠️严禁连接生产库，务必连接本地开发库或只读副本。连接字符串中密码含特殊字符（如@、#）需 URL 编码。

claude mcpadd--transportstdio postgres -- npx-y@modelcontextprotocol/server-postgres\--envPOSTGRES_CONNECTION_STRING=postgresql://user:password@localhost:5432/mydb

4. Filesystem MCP —— 跨目录文件访问
突破 Claude Code 的工作目录限制，读写指定目录。参数中列出允许访问的目录，必须使用绝对路径。

claude mcpadd--transportstdio filesystem -- npx-y@modelcontextprotocol/server-filesystem\/absolute/path/to/projects /absolute/path/to/logs

5. Brave Search MCP —— 让 AI 能自主搜索
免费额度每月 2000 次查询，英文搜索质量优于中文。搜索结果仅为摘要文本，需要完整网页内容时需搭配 Firecrawl。

claude mcpadd--transportstdio brave-search -- npx-y@modelcontextprotocol/server-brave-search\--envBRAVE_API_KEY=BSA_xxxxxxxxxxxxxxxx

API Key 可在 brave.com/search/api 注册获取。

MCP 组合实战案例

需求：“帮我调研市面上的表单构建工具，看看哪个适合我们项目”

AI 的自动化流程：

  1. Brave Search 搜索open source form builder 2026
  2. Firecrawl 爬取候选工具文档页
  3. GitHub MCP 查看各仓库活跃度（Star 数、最近提交、Issue 数量）
  4. PostgreSQL MCP 查询现有表单模块表结构做对比
  5. Filesystem MCP 将调研结果写入本地文档

整个过程只需一句话，无需任何人工干预。

安全提醒

  • API Key 和数据库密码放在环境变量中，绝不写死在配置文件并提交到 Git
  • GitHub Token只给最小必要权限（repo + read:org）
  • 数据库连接底线是不可逆操作的生产库，只连开发库或只读副本

通过以上七个方面的系统配置，你可以将 Claude Code 从基础编程助手升级为完整的自动化 AI 编码工作站，实现生产力质的飞跃。建议先完成安装和CLAUDE.md初始化，再逐步安装核心 Skills 和 MCP，每一步都能感受到效率的明显提升。

http://www.cnnetsun.cn/news/2489214.html

相关文章：

  • 告别滚动截图烦恼：Chrome全网页截图插件使用指南
  • 17 ThingsBoard网关设备-子设备数据模型实战：核心价值+完整落地指南
  • 为什么现在能加薪10%~15%，已经算不错结果？
  • ViGEmBus虚拟游戏控制器驱动：终极安装与使用指南
  • 抖音下载神器终极指南：批量无水印下载工具完整教程
  • 3大核心技术解析：深度剖析ncmdumpGUI的NCM文件解密与音频转换
  • Tessent Shell命令实战：从create_patterns到report_statistics，一份给芯片测试工程师的速查手册
  • C语言指针系列(四):字符指针、数组指针与函数指针数组
  • 别急着升级Android Studio！手把手教你降级AGP 8.3.0-alpha01到8.1.3，解决版本不兼容报错
  • 浏览器里的微信：当网页版不再只是传说
  • 终极指南：30天重置JetBrains IDE试用期的完整解决方案
  • 国内使用Claude Code免登录使用企业级功能，实现模型全兼容
  • 开源智慧树刷课插件：三分钟搞定自动学习，让在线课程不再烦人
  • Fansly Downloader：3分钟掌握离线收藏创作者内容的完整解决方案
  • 30天学会AI工程师｜Day 15：当工具不止一个时，AI 工程的问题就不只是“能不能用”
  • 快速安装 Ollama三种方法（本地模型管理器）
  • 从模型文件到孪生场景：一个Three.js三维模型管理系统的完整产品化思考
  • 别再用错电位器了！聊聊那个带‘神秘第四脚’的电动双联电位器（附Python仿真）
  • 论文写得像流水账？资深教授推荐这几个AI写作辅助软件
  • 深入eDP协议栈：从PSR SDP发送到Main Link开关，一次搞懂屏幕自刷新的完整信令流程
  • Scroll Reverser：彻底解决Mac设备滚动方向冲突的终极方案
  • 机器学习神经网络激活函数知识点选型：从ReLU到Sigmoid全解析
  • 如何在macOS上免费导出微信聊天记录：WeChatExporter完整指南
  • 从ICM42688P到MPU6000：详解Betaflight/iNav飞控中那些‘奇怪’的IMU旋转配置
  • 发票OCR识别总是失败？一文解决90%的常见问题（附Python/Java调试指南）
  • 百度网盘提取码一键获取：3分钟学会的免费智能查询方案
  • 文字识别提取工具怎么选？2026 年免费和付费工具完整测评对比
  • C语言知识点与题库
  • 从零到一：手把手教你用ESP32和Arduino IDE配置BLE的GAP广播与GATT服务
  • 【为风光储一体化系统注入精准“心跳”的隐形力量】