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

以下是一份基于最新公开资料的Claude Code全干使用指南，涵盖安装、命令体系、Skills安装与管理、CLAUDE.md记忆系统、高效提示词策略以及MCP生态扩展的全流程实战指引。

一、安装与下载

环境准备

• Node.js 18.0+（仅限 npm 安装方式）

• Claude.ai 账号，需完成手机验证

• 支持 Windows、macOS、Linux（含 WSL）全平台

安装方式

方式一：原生安装（官方推荐，零依赖）

截止2026年，Anthropic已弃用 npm 安装方式，主推零依赖的原生安装器：

# macOS / Linux / WSL (稳定版)
curl -fsSL https://claude.ai/install.sh | bash

# 或安装最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装特定版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

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

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

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

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

npm install -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 启动命令

七大类斜杠命令

1. 会话管理类（日常高频）

/compact vs /clear：继续同一任务时用 /compact，切换到全新任务时用 /clear。建议在上下文用量达 70-80% 时主动压缩，不要等窗口填满。

2. 上下文与资源管理类

3. 模型与配置管理类

日常策略：Sonnet 起步（日常编码）→ 遇到复杂问题切 Opus（架构决策）→ 琐碎任务用 Haiku（低成本快速）

4. 代码分析与质量类

5. 项目初始化与诊断类

6. 工作流增强

键盘快捷键

输入 / 即可弹出所有可用命令的交互式列表，输入 / 后接字母可实时过滤。

四、Skills（技能）安装与管理

Skills 的概念

Skills 是 Claude Code 的模块化能力扩展系统，每个 Skill 由一个 SKILL.md 文件定义（Markdown + YAML frontmatter），存放于指定目录后 Claude Code 自动发现，可用 /skill-name 调用，无需编写代码或安装外部依赖。

安装方式

方式一：官方插件市场安装

# 注册官方 Skills 仓库为插件源
/plugin marketplace add anthropics/skills
# 安装文档处理包（含 pdf/xlsx/docx/pptx）
/plugin install document-skills@anthropic-agent-skills

方式二：手动安装

# 项目级 Skill（推荐团队共享，跟随 Git 版本控制）
mkdir -p .claude/skills/<skill-name>
# 放入 SKILL.md 后即刻生效

# 用户级 Skill（全局跨项目）
mkdir -p ~/.claude/skills/<skill-name>

方式三：通过 skillhub 发现与安装

pip install skillhub
skillhub search security      # 搜索安全类技能
skillhub install security-review  # 一键安装到 Claude Code

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

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

# 全局安装
npx skills add <skill-name> -g -y
# 安装到指定客户端
claude-skills install <skill-name> --client claude-code

必装 Skills（按优先级推荐）

第一梯队：通用基础型

第二梯队：开发与设计型

第三梯队：效率与发布

如何验证已安装的 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 服务器安装

# 标准安装
claude mcp add --transport http <server-name> <https://api.example.com/mcp>

# 带 Bearer Token 鉴权
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# 示例：连接 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

本地 Stdio MCP 服务器安装

# 基础安装（注意 -- 之后是服务器启动命令）
claude mcp add --transport stdio my-server -- npx -y server-package

# Python 服务器
claude mcp add --transport stdio python-server -- python3 /path/to/server.py --port 8080

# Windows 环境必须用 cmd /c 包装
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

三种作用域选择

⚠️ 注意：-- 是关键分隔符，之前是 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 mcp add --transport stdio firecrawl -- npx -y firecrawl-mcp \
  --env FIRECRAWL_API_KEY=fc-your-key-here

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

2. GitHub MCP —— 仓库操作中枢

读写 Issues、PRs、文件、搜索代码，Token 权限仅需 repo + read:org（不要给更大权限）。

claude mcp add github -- npx -y @modelcontextprotocol/server-github \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx

3. PostgreSQL MCP —— 数据库直接查询

⚠️ 严禁连接生产库，务必连接本地开发库或只读副本。连接字符串中密码含特殊字符（如 @、#）需 URL 编码。

claude mcp add --transport stdio postgres -- npx -y @modelcontextprotocol/server-postgres \
  --env POSTGRES_CONNECTION_STRING=postgresql://user:password@localhost:5432/mydb

4. Filesystem MCP —— 跨目录文件访问

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

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem \
  /absolute/path/to/projects /absolute/path/to/logs

5. Brave Search MCP —— 让 AI 能自主搜索

免费额度每月 2000 次查询，英文搜索质量优于中文。搜索结果仅为摘要文本，需要完整网页内容时需搭配 Firecrawl。

claude mcp add --transport stdio brave-search -- npx -y @modelcontextprotocol/server-brave-search \
  --env BRAVE_API_KEY=BSA_xxxxxxxxxxxxxxxx

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

MCP 组合实战案例

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

AI 的自动化流程：

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

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

安全提醒

• API Key 和数据库密码放在环境变量中，绝不写死在配置文件并提交到 Git

• GitHub Token 只给最小必要权限（repo + read:org）

• 数据库连接底线是不可逆操作的生产库，只连开发库或只读副本

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