从零开始：Claude Code 完全上手指南，35+ 插件一网打尽！

工欲善其事，必先利其器。今天给大家介绍一个让你的开发效率翻倍的神器——Claude Code，以及如何一步安装 35+ 个强大插件！

🎯 前言

你是否遇到过这些问题：

• ❌ 写代码时经常卡住，不知道怎么继续
• ❌ 需要查阅大量文档才能完成一个功能
• ❌ 重复写类似的代码，浪费时间
• ❌ 代码审查依赖他人，等待时间长

如果你点了头，那么 Claude Code 就是为你准备的！

---

✨ 什么是 Claude Code？

Claude Code 是 Anthropic 公司推出的 Claude AI 命令行工具，它不是一个简单的聊天机器人，而是一个能真正帮你工作的 AI 助手！

它能做什么？

✅ 帮你写代码、改代码、调试代码
✅ 自动执行文件操作、运行命令
✅ 通过插件扩展功能（35+ 个插件！）
✅ 连接外部工具和服务（MCP 协议）
✅ 提供专业的代码审查和安全检查
✅ 自动化重复的开发任务

简单来说，它就像一个24小时在线的高级程序员助手，而且能力可以无限扩展！

---

📋 准备工作

在开始之前，请确保你的电脑已经准备好了以下工具：

系统要求

系统	支持状态
macOS	✅ 完美支持
Linux	✅ 完美支持
Windows (WSL)	✅ 推荐使用 WSL2
Windows (原生)	⚠️ 有限支持

必备软件清单

1️⃣ Node.js

Claude Code 的运行基础。

检查是否已安装：

node -v

如果看到版本号（如 v20.x.x），就跳过。如果没有，继续：

# 推荐：使用 nvm 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

2️⃣ Git

用于下载插件仓库。

检查：

git --version

安装（Ubuntu/Debian）：

sudo apt update
sudo apt install git

安装（macOS）：

# macOS 通常自带
brew install git

3️⃣ API Key 获取

Claude Code 支持官方 Anthropic API 和国内兼容 API（如 GLM、智谱等）。

方式一：使用官方 Anthropic API

1. 访问 https://console.anthropic.com/
2. 登录/注册账号
3. 进入 API Keys 页面
4. 点击 Create Key
5. ⚠️ 复制并保存这个 Key（只显示一次！）

方式二：使用国内 API（推荐国内用户）

💡 优势：访问速度快、价格更低、中文支持更好

支持的国内 API 服务商：

服务商	API 地址	特点
智谱 AI (GLM)	https://open.bigmodel.cn	国产大模型，中文优化
月之暗面 (Kimi)	https://api.moonshot.cn	长文本支持强
通义千问	https://dashscope.aliyuncs.com	阿里出品
百度文心	https://aip.baidubce.com	百度大模型
DeepSeek	https://api.deepseek.com	开源友好

以智谱 AI (GLM) 为例：

1. 访问 https://open.bigmodel.cn/
2. 注册/登录账号
3. 进入 API Keys 管理页面
4. 点击 创建 API Key
5. ⚠️ 复制并保存这个 Key

后续配置方法：在安装完成后，通过修改 settings.json 配置文件来使用国内 API，详见 第四章：配置自定义 API。

---

🚀 第一章：安装 Claude Code

方法一：npm 安装（最简单）

打开终端，执行：

npm install -g @anthropic-ai/claude-code

几秒钟后，安装完成！接下来进行登录：

claude

按提示操作：

1. 选择浏览器登录
2. 粘贴你的 API Key
3. 验证成功！

验证安装

claude --version

看到版本号就说明安装成功了！🎉

---

📁 第二章：理解 Claude Code 的结构

安装完成后，Claude Code 会创建一个配置目录：

~/.claude/
├── agents/       # 🤖 AI 代理（专家助手）
├── commands/     # ⚡ 自定义命令
├── hooks/        # 🔗 自动化钩子
├── skills/       # 🎯 技能模板
└── settings.json # ⚙️ 配置文件

它们分别是什么？

目录	作用	类比
skills/	预设提示词模板	像是"快捷短语"
agents/	专门化 AI 助手	像是"聘请专家"
commands/	自定义命令	像是"快捷方式"
hooks/	自动化触发	像是"自动化任务"

---

🔧 第三章：配置国内 API Key（国内用户必读）

为什么要配置国内 API？

官方 API	国内 API
⚠️ 访问可能不稳定	✅ 国内访问快速稳定
⚠️ 价格较高	✅ 价格更低
⚠️ 中文支持一般	✅ 中文优化更好
✅ 原生功能最全	✅ 兼容性好

国内 API 服务商对比

服务商	免费额度	价格	特色
智谱 AI (GLM)	100万 tokens	¥0.05/千tokens	国产首选，中文优化
DeepSeek	无限制	¥0.14/百万tokens	性价比最高
月之暗面 (Kimi)	15元免费	¥12/百万tokens	长文本支持强
通义千问	首月免费	¥0.008/千tokens	阿里出品
百度文心	200万 tokens	¥0.008/千tokens	百度生态
火山引擎 Volces	首月免费	¥0.03/千tokens	字节跳动，GLM-4.7

---

详细配置步骤

方法一：通过命令行配置（推荐）

步骤 1：获取 API Key

以智谱 AI (GLM) 为例：

1. 访问 https://open.bigmodel.cn/
2. 注册/登录账号
3. 点击左侧菜单 API Key
4. 点击 创建 API Key
5. ⚠️ 立即复制并保存（只显示一次！）

你的 API Key 格式类似：

sk-????????????????????????xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

步骤 2：创建/编辑配置文件

# 创建配置目录（如果不存在）
mkdir -p ~/.claude

# 创建或编辑配置文件
nano ~/.claude/settings.json

步骤 3：写入配置内容

在 nano 编辑器中输入以下内容：

{
  "anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/",
  "apiKey": "sk-????????????????????????????"
}

说明：

• anthropicBaseUrl：智谱 AI 的 API 地址
• apiKey：你在步骤 1 复制的 API Key

保存文件：

• 按 Ctrl + X 退出
• 按 Y 确认保存
• 按 Enter 确认文件名

步骤 4：验证配置

# 启动 Claude Code
claude

# 发送测试消息
> 你好，请用中文介绍一下你自己

如果看到 Claude 用中文回复，说明配置成功！🎉

---

方法二：使用配置脚本（批量配置）

创建自动化配置脚本：

cat > ~/.claude/configure-api.sh << 'EOF'
#!/bin/bash

echo "🚀 Claude Code 国内 API 配置工具"
echo "================================"
echo ""
echo "请选择你要配置的 API 服务商："
echo "1) 智谱 AI (GLM) - 推荐"
echo "2) DeepSeek"
echo "3) 月之暗面 (Kimi)"
echo "4) 通义千问"
echo "5) 百度文心"
echo "6) 火山引擎 Volces (需要环境变量格式)"
echo ""
read -p "请输入选项 (1-6): " choice

case $choice in
    1)
        BASE_URL="https://open.bigmodel.cn/api/paas/v4/"
        PROVIDER="智谱 AI (GLM)"
        USE_ENVaro="false"
        ;;
    2)
        BASE_URL="https://api.deepseek.com/v1"
        PROVIDER="DeepSeek"
        USE_ENVaro="false"
        ;;
    3)
        BASE_URL="https://api.moonshot.cn/v1"
        PROVIDER="月之暗面 (Kimi)"
        USE_ENVaro="false"
        ;;
    4)
        BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
        PROVIDER="通义千问"
        USE_ENVaro="false"
        ;;
    5)
        BASE_URL="https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat"
        PROVIDER="百度文心"
        USE_ENVaro="false"
        ;;
    6)
        PROVIDER="火山引擎 Volces"
        USE_ENVaro="true"
        ;;
    *)
        echo "❌ 无效的选项"
        exit 1
        ;;
esac

echo ""
echo "你选择了：$PROVIDER"
echo ""

# 创建配置目录
mkdir -p ~/.claude

# 火山引擎使用环境变量格式
if [ "$USE_ENVaro" = "true" ]; then
    echo "⚠️ 火山引擎使用环境变量格式"
    read -p "请输入 ANTHROPIC_AUTH_TOKEN: " auth_token
    read -p "请输入 ANTHROPIC_BASE_URL (默认: https://ark.cn-beijing.volces.com/api/coding): " base_url
    read -p "请输入 ANTHROPIC_MODEL (默认: glm-4.7): " model

    # 使用默认值如果输入为空
    base_url=${base_url:-"https://ark.cn-beijing.volces.com/api/coding"}
    model=${model:-glm-4.7}

    # 写入配置（环境变量格式）
    cat > ~/.claude/settings.json << EOFJSON
{
  "ANTHROPIC_AUTH_TOKEN": "$auth_token",
  "ANTHROPIC_BASE_URL": "$base_url",
  "ANTHROPIC_MODEL": "$model"
}
EOFJSON
else
    read -p "请输入你的 API Key: " api_key

    # 写入配置（标准格式）
    cat > ~/.claude/settings.json << EOFJSON
{
  "anthropicBaseUrl": "$BASE_URL",
  "apiKey": "$api_key"
}
EOFJSON
fi

echo ""
echo "✅ 配置已保存到 ~/.claude/settings.json"
echo ""
echo "🔍 配置内容："
cat ~/.claude/settings.json
echo ""
echo "🎉 配置完成！现在可以运行 'claude' 开始使用了"
EOF

# 添加执行权限并运行
chmod +x ~/.claude/configure-api.sh
~/.claude/configure-api.sh

运行脚本，按提示输入你的 API Key 即可自动配置！

---

各服务商详细配置

1️⃣ 智谱 AI (GLM) - 最推荐

为什么推荐？

• ✅ 国产大模型，中文优化最好
• ✅ 免费额度大（100万 tokens）
• ✅ 响应速度快
• ✅ 支持 Claude API 兼容模式

配置文件 ~/.claude/settings.json：

{
  "anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/",
  "apiKey": "sk-????????????????????????????????"
}

获取 API Key：

1. 访问 https://open.bigmodel.cn/
2. 进入 API Key 管理页面
3. 点击"创建新的 API Key"
4. 复制 API Key

---

2️⃣ DeepSeek - 性价比之王

优势：

• ✅ 价格最低（¥0.14/百万tokens）
• ✅ 无使用限制
• ✅ 开源友好
• ✅ 支持长上下文

配置文件：

{
  "anthropicBaseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-????????????????????????????????"
}

获取 API Key：

1. 访问 https://platform.deepseek.com/
2. 进入 API Keys 页面
3. 创建 API Key

---

3️⃣ 月之暗面 (Kimi) - 长文本专家

优势：

• ✅ 支持 20万+ 长文本
• ✅ 中文理解能力强
• ✅ 首月免费使用

配置文件：

{
  "anthropicBaseUrl": "https://api.moonshot.cn/v1",
  "apiKey": "sk-????????????????????????????????"
}

获取 API Key：

1. 访问 https://platform.moonshot.cn/
2. 进入 API Keys 管理页面
3. 创建 API Key

---

4️⃣ 通义千问 - 阿里出品

优势：

• ✅ 阿里云出品，稳定可靠
• ✅ 首月免费调用
• ✅ 支持多种模型

配置文件：

{
  "anthropicBaseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "sk-????????????????????????????????"
}

获取 API Key：

1. 访问 https://dashscope.aliyuncs.com/
2. 进入 API-KEY 管理
3. 创建 API Key

---

5️⃣ 百度文心 - 百度生态

优势：

• ✅ 百度大模型
• ✅ 中文支持优秀
• ✅ 免费额度多

配置文件：

{
  "anthropicBaseUrl": "https://aip.baidubce.com/rpc/2.0/ai_custom/vr/wenxinworkshop/chat",
  "apiKey": "sk-????????????????????????????????"
}

获取 API Key：

1. 访问 https://cloud.baidu.com/product/wenxinworkshop/
2. 进入 API Key 管理页面
3. 创建应用并获取 Key

---

6️⃣ 火山引擎 Volces - 环境变量配置模式

⚠️ 特殊说明：火山引擎的 API 配置方式与其他服务商不同，需要使用环境变量格式！

优势：

• ✅ 字节跳动出品，性能强大
• ✅ 支持 GLM-4.7 等先进模型
• ✅ 兼容 Anthropic OpenAI API
• ✅ 国内访问速度快

配置方式：火山引擎使用环境变量格式配置

编辑 ~/.claude/settings.json 文件：

{
  "ANTHROPIC_AUTH_TOKEN": "????????????????????????????????????????",
  "ANTHROPIC_BASE_URL": "????????????????????????????????????????????????",
  "ANTHROPIC_MODEL": "????????"
}

配置说明：

配置项	说明	示例
ANTHROPIC_AUTH_TOKEN	认证令牌	????????????????????????????????
ANTHROPIC_BASE_URL	API 基础地址	????????????????????????????
ANTHROPIC_MODEL	使用的模型	????????

获取 API Token：

1. 访问 火山引擎控制台
2. 注册/登录账号
3. 进入 API 密钥管理 页面
4. 创建新密钥或复制现有密钥
5. 复制 Access Key ID 作为 ANTHROPIC_AUTH_TOKEN

可选模型：

模型	说明
glm-4.7	最新的 GLM-4.7 模型（推荐）
glm-4	GLM-4 模型
glm-3-turbo	GLM-3 Turbo 模型（快速）

完整配置示例（包含 MCP 服务器）：

{
  "ANTHROPIC_AUTH_TOKEN": "????????????????????????????????",
  "ANTHROPIC_BASE_URL": "????????????????????????",
  "ANTHROPIC_MODEL": "????????",
  "timeout": 120000,
  "mcpServers": {
    "mcp-use": {
      "command": "node",
      "args": ["/mnt/e/Code/claude-repos/mcp-use/dist/index.js"],
      "description": "通用MCP工具集"
    }
  }
}

---

配置验证与测试

验证步骤

# 1. 查看配置文件
echo "=== 当前配置 ==="
cat ~/.claude/settings.json
echo ""

# 2. 检查 JSON 格式是否正确
echo "=== JSON 格式检查 ==="
python -m json.tool ~/.claude/settings.json || echo "❌ JSON 格式错误"
echo ""

# 3. 启动测试
echo "=== 启动 Claude Code 测试 ==="
echo "在打开的 Claude Code 中输入：你好"
claude

预期输出

如果配置正确，你会看到：

欢迎使用 Claude Code！

>

输入 你好 后，应该得到中文回复：

> 你好
你好！我是 Claude，由 Anthropic 开发的 AI 助手。我可以帮助你写代码、解答问题...

---

常见配置错误排查

错误 1：API Key 格式不对

症状：提示 “API Key 无效”

解决：

# 检查 API Key 是否包含引号
cat ~/.claude/settings.json | grep apiKey

# 正确格式（无引号在值内）
"apiKey": "sk-????????????????????????????????"

# 错误格式
"apiKey": "sk-????????????????????????????????"

错误 2：API 地址格式错误

症状：提示 “无法连接到 API”

解决：

# 检查地址格式
cat ~/.claude/settings.json | grep anthropicBaseUrl

# 智谱地址必须以 / 结尾
"anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/"  ✅ 正确
"anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4"   ❌ 错误

错误 3：配置文件路径错误

症状：配置不生效

解决：

# 确认配置文件位置
ls -la ~/.claude/settings.json

# 如果不存在，创建
touch ~/.claude/settings.json

错误 4：JSON 格式错误

症状：Claude Code 无法读取配置

解决：

# 使用 Python 验证 JSON 格式
python -m json.tool ~/.claude/settings.json

# 如果有错误，会提示具体位置
# 例如：Expecting ',' delimiter: line 3 column 5 (char 32)

---

📝 API 配置格式说明

Claude Code 支持两种 API 配置格式，请根据你使用的服务商选择正确的格式：

格式一：标准格式（推荐）

大多数国内 API 服务商使用此格式：

{
  "anthropicBaseUrl": "https://api.example.com/v1",
  "apiKey": "sk-????????????????????????????????"
}

适用于：

• ✅ 智谱 AI (GLM)
• ✅ DeepSeek
• ✅ 月之暗面 (Kimi)
• ✅ 通义千问
• ✅ 百度文心

格式二：环境变量格式

⚠️ 注意：此格式主要兼容 OpenAI 风格的 API

{
  "ANTHROPIC_AUTH_TOKEN": "????????????????????????????????????????",
  "ANTHROPIC_BASE_URL": "????????????????????????????????????????????????",
  "ANTHROPIC_MODEL": "????????"
}

适用于：

• ✅ 火山引擎 Volces
• ✅ 其他兼容 OpenAI 环境变量格式服务商

格式对比

配置项	标准格式	环境变量格式
API 地址	anthropicBaseUrl	ANTHROPIC_BASE_URL
认证信息	apiKey	ANTHROPIC_AUTH_TOKEN
模型选择	defaultModel	ANTHROPIC_MODEL

切换格式示例

如果你需要从标准格式切换到环境变量格式：

标准格式：

{
  "anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/",
  "apiKey": "sk-????????????????????????????????"
}

切换为环境变量格式（火山引擎）：

{
  "ANTHROPIC_AUTH_TOKEN": "????????????????????????????????????????",
  "ANTHROPIC_BASE_URL": "????????????????????????????????????????????????",
  "ANTHROPIC_MODEL": "????????"
}

---

进阶配置选项

完整的 settings.json 配置示例（标准格式）：

{
  "anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/",
  "apiKey": "sk-????????????????????????????????",
  "defaultModel": "claude-3-5-sonnet",
  "timeout": 120000,
  "mcpServers": {
    "mcp-use": {
      "command": "node",
      "args": ["/mnt/e/Code/claude-repos/mcp-use/dist/index.js"],
      "description": "通用MCP工具集"
    }
  }
}

配置项	说明	可选值
anthropicBaseUrl	API 服务器地址	各服务商地址
apiKey	API 密钥	你的 API Key
defaultModel	默认模型	claude-3-5-sonnet 等
timeout	超时时间（毫秒）	120000（2分钟）
mcpServers	MCP 服务器配置	见下文

---

一键配置所有内容

如果你希望一次性配置 API 并添加 MCP 服务器，使用这个脚本：

cat > ~/.claude/quick-setup.sh << 'EOF'
#!/bin/bash

echo "🚀 Claude Code 快速配置脚本"
echo "=========================="
echo ""

# 创建配置目录
mkdir -p ~/.claude

# 输入 API 信息
read -p "请输入 API 服务商名称 (zhipu/deepseek/kimi/qianwen/wenxin): " provider
read -p "请输入你的 API Key: " api_key

# 设置 API 地址
case $provider in
    zhipu)
        base_url="https://open.bigmodel.cn/api/paas/v4/"
        ;;
    deepseek)
        base_url="https://api.deepseek.com/v1"
        ;;
    kimi)
        base_url="https://api.moonshot.cn/v1"
        ;;
    qianwen)
        base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
        ;;
    wenxin)
        base_url="https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat"
        ;;
    *)
        echo "❌ 未知的服务商，使用默认智谱"
        base_url="https://open.bigmodel.cn/api/paas/v4/"
        ;;
esac

# 创建配置文件
cat > ~/.claude/settings.json << EOFJSON
{
  "anthropicBaseUrl": "$base_url",
  "apiKey": "$api_key",
  "defaultModel": "claude-3-5-sonnet",
  "timeout": 120000
}
EOFJSON

echo "✅ 配置已保存"
echo ""
echo "📄 配置文件内容："
cat ~/.claude/settings.json
echo ""
echo "🎉 完成！现在运行 'claude' 开始使用"
EOF

chmod +x ~/.claude/quick-setup.sh
~/.claude/quick-setup.sh

---

配置完成后，继续阅读下一章节：安装 35+ 个强大插件

---

🔌 第四章：安装 35+ 个强大插件

现在到了最激动人心的部分——安装插件！

我们将安装以下类型的插件：

📦 核心插件（5个）
   └─ claude-code-templates
   └─ claude-flow
   └─ everything-claude-code
   └─ ...

🎨 资源集合（10+个）
   └─ awesome-claude-skills
   └─ awesome-claude-code
   └─ awesome-claude-agents
   └─ ...

🤖 MCP 服务器（10+个）
   └─ mcp-use（通用工具）
   └─ firecrawl（网页抓取）
   └─ playwright（浏览器自动化）
   └─ ...

步骤 1：创建下载目录

mkdir -p /mnt/e/Code/claude-repos
cd /mnt/e/Code/claude-repos

步骤 2：一键克隆所有仓库

复制以下命令执行（一次性下载所有插件）：

# === 核心插件 ===
git clone --depth 1 https://github.com/davila7/claude-code-templates.git
git clone --depth 1 https://github.com/ruvnet/claude-flow.git
git clone --depth 1 https://github.com/affaan-m/everything-claude-code.git

# === Awesome 系列资源集合 ===
git clone --depth 1 https://github.com/ComposioHQ/awesome-claude-skills.git
git clone --depth 1 https://github.com/hesreallyhim/awesome-claude-code.git
git clone --depth 1 https://github.com/VoltAgent/awesome-claude-code-subagents.git
git clone --depth 1 https://github.com/vijaythecoder/awesome-claude-agents.git
git clone --depth 1 https://github.com/langgptai/awesome-claude-prompts.git

# === 官方资源 ===
git clone --depth 1 https://github.com/anthropics/claude-cookbooks.git
git clone --depth 1 https://github.com/anthropics/claude-code-action.git
git clone --depth 1 https://github.com/anthropics/claude-plugins-official.git

# === 学习资源 ===
git clone --depth 1 https://github.com/shareAI-lab/learn-claude-code.git
git clone --depth 1 https://github.com/ChrisWiles/claude-code-showcase.git

# === 工具和框架 ===
git clone --depth 1 https://github.com/SuperClaude-Org/SuperClaude_Framework.git
git clone --depth 1 https://github.com/AndyMik90/Auto-Claude.git
git clone --depth 1 https://github.com/eyaltoledano/claude-task-master.git
git clone --depth 1 https://github.com/thedotmack/claude-mem.git
git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git
git clone --depth 1 https://github.com/frankbria/ralph-claude-code.git
git clone --depth 1 https://github.com/diet103/claude-code-infrastructure-showcase.git
git clone --depth 1 https://github.com/disler/claude-code-hooks-mastery.git
git clone --depth 1 https://github.com/OneRedOak/claude-code-workflows.git

# === MCP 服务器 ===
git clone --depth 1 https://github.com/zilliztech/claude-context.git
git clone --depth 1 https://github.com/czlonkowski/n8n-mcp.git
git clone --depth 1 https://github.com/CoplayDev/unity-mcp.git
git clone --depth 1 https://github.com/54yyyu/zotero-mcp.git
git clone --depth 1 https://github.com/BrowserMCP/mcp.git
git clone --depth 1 https://github.com/mcp-use/mcp-use.git
git clone --depth 1 https://github.com/BeehiveInnovations/pal-mcp-server.git
git clone --depth 1 https://github.com/firecrawl/firecrawl-mcp-server.git
git clone --depth 1 https://github.com/executeautomation/mcp-playwright.git
git clone --depth 1 https://github.com/tadata-org/fastapi_mcp.git

# === 额外的 awesome-claude-skills ===
git clone --depth 1 https://github.com/BehiSecc/awesome-claude-skills.git BehiSecc-awesome-claude-skills
git clone --depth 1 https://github.com/travisvn/awesome-claude-skills.git travisvn-awesome-claude-skills

💡 提示：--depth 1 表示浅克隆，只下载最新版本，更快更省空间。

步骤 3：一键安装所有插件

创建并运行安装脚本：

cat > /tmp/install-claude-plugins.sh << 'EOF'
#!/bin/bash

REPO_DIR="/mnt/e/Code/claude-repos"
CLAUDE_DIR="$HOME/.claude"

echo "🚀 开始安装 Claude Code 插件..."
echo ""

# 创建目录
mkdir -p $CLAUDE_DIR/agents $CLAUDE_DIR/commands $CLAUDE_DIR/hooks $CLAUDE_DIR/skills

# 安装函数
install_repo() {
    local repo=$1
    if [ -d "$REPO_DIR/$repo/.claude" ]; then
        for dir in agents commands hooks skills; do
            if [ -d "$REPO_DIR/$repo/.claude/$dir" ]; then
                cp -r $REPO_DIR/$repo/.claude/$dir/* $CLAUDE_DIR/$dir/ 2>/dev/null
            fi
        done
        echo "✅ $repo 安装完成"
    fi
}

# 核心插件
install_repo "claude-code-templates"
install_repo "claude-flow"
install_repo "everything-claude-code"

# 其他插件
for repo in awesome-claude-skills awesome-claude-code awesome-claude-agents \
             claude-cookbooks learn-claude-code claude-code-showcase \
             BehiSecc-awesome-claude-skills travisvn-awesome-claude-skills \
             SuperClaude_Framework Auto-Claude claude-task-master claude-mem \
             oh-my-claudecode ralph-claude-code claude-code-infrastructure-showcase \
             claude-code-hooks-mastery claude-code-workflows; do
    install_repo "$repo"
done

# 显示结果
echo ""
echo "🎉 安装完成！"
echo "📊 统计："
echo "   Agents: $(ls -1 $CLAUDE_DIR/agents/ 2>/dev/null | wc -l)"
echo "   Commands: $(ls -1 $CLAUDE_DIR/commands/ 2>/dev/null | wc -l)"
echo "   Skills: $(ls -1 $CLAUDE_DIR/skills/ 2>/dev/null | wc -l)"
echo "   Hooks: $(ls -1 $CLAUDE_DIR/hooks/ 2>/dev/null | wc -l)"
EOF

chmod +x /tmp/install-claude-plugins.sh
bash /tmp/install-claude-plugins.sh

安装完成后，你会看到类似这样的输出：

✅ claude-code-templates 安装完成
✅ claude-flow 安装完成
✅ everything-claude-code 安装完成
...
🎉 安装完成！
📊 统计：
   Agents: 45
   Commands: 31
   Skills: 50+
   Hooks: 1

---

🔧 第五章：配置 MCP 服务器

什么是 MCP？

MCP = Model Context Protocol（模型上下文协议）

它让 Claude Code 能连接到强大的外部工具：

🌐 网页抓取 (firecrawl)
🤖 浏览器自动化 (playwright)
📚 数据库操作
🔧 外部 API 调用

配置步骤

1. 编辑配置文件

nano ~/.claude/settings.json

2. 添加 MCP 配置

{
  "mcpServers": {
    "mcp-use": {
      "command": "node",
      "args": ["/mnt/e/Code/claude-repos/mcp-use/dist/index.js"],
      "description": "通用MCP工具集"
    },
    "firecrawl": {
      "command": "node",
      "args": ["/mnt/e/Code/claude-repos/firecrawl-mcp-server/dist/index.js"],
      "env": {
        "FIRECRAWL_API_KEY": "你的API密钥"
      },
      "description": "网页抓取服务"
    },
    "mcp-playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/mcp-playwright"],
      "description": "浏览器自动化"
    }
  }
}

3. 安装依赖

# Node.js MCP 服务器
cd /mnt/e/Code/claude-repos/mcp-use && npm install
cd /mnt/e/Code/claude-repos/firecrawl-mcp-server && npm install

# Python MCP 服务器
pip install pal-mcp-server
pip install fastapi-mcp

---

💡 第六章：如何使用这些插件

使用 Skills（技能）

Skills 是预设的提示词模板，让 Claude 用最佳方式帮助你。

# 使用 TDD（测试驱动开发）技能
claude --skill tdd "帮我写一个用户认证函数，并编写单元测试"

# 使用安全审查技能
claude --skill security-review "审查这个文件的安全性"

# 使用 Python 审查技能
claude --skill python-review "审查这段 Python 代码"

使用 Agents（代理）

Agents 是专门化的 AI 专家，各有专长！

# 使用代码审查专家
claude --agent code-reviewer "审查这个文件"

# 使用安全专家
claude --agent security-reviewer "检查安全问题"

# 使用测试专家
claude --agent tester "帮我写测试用例"

使用 Commands（命令）

Commands 是自定义命令，一键完成常见任务。

# 运行测试
claude test

# 代码检查
claude lint

# 部署
claude deploy

查看可用资源

# 在 Claude Code 中
> /skills    # 列出所有技能
> /agents    # 列出所有代理
> /help      # 查看帮助

---

🎨 第七章：热门插件介绍

1. TDD 工作流

功能：强制遵循测试驱动开发流程

claude --skill tdd "实现一个计算器"

Claude 会：

1. 先写测试用例
2. 运行测试（失败）
3. 写代码让测试通过
4. 重构优化

2. SPARC 方法论

功能：系统化的开发方法论

S - Specification（规范）
P - Pseudocode（伪代码）
A - Architecture（架构）
R - Refinement（优化）
C - Coding（编码）

3. 安全审查

功能：自动检测安全漏洞

claude --skill security-review "审查这段代码"

检测项目：

• SQL 注入
• XSS 攻击
• 敏感信息泄露
• 权限问题

4. 浏览器自动化（Playwright MCP）

功能：让 Claude 操作浏览器

> 打开 https://example.com
> 截图保存为 screenshot.png
> 填写表单：用户名 test，密码 123456
> 点击登录按钮

5. 网页抓取（Firecrawl MCP）

功能：智能抓取网页内容

> 抓取 https://example.com 的文章内容
> 提取所有链接

---

📖 第八章：常用命令速查

基本命令

命令	作用
claude	启动 Claude Code
claude --version	查看版本
claude --help	查看帮助
claude --exit	退出

使用插件

命令	作用
claude --skill <name>	使用特定技能
claude --agent <name>	使用特定代理
claude --directory <path>	指定工作目录

对话中的命令

/skills    # 列出所有技能
/agents    # 列出所有代理
/help      # 帮助信息
/clear     # 清屏
/exit      # 退出

---

❓ 第九章：常见问题解决

Q1: 如何切换到国内 API？

A: 编辑 settings.json 配置文件：

nano ~/.claude/settings.json

{
  "anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/",
  "apiKey": "你的智谱API密钥"
}

Q2: 国内 API 哪个好用？

A: 推荐顺序：

1. 智谱 AI (GLM) - 国产首选，中文优化好
2. DeepSeek - 性价比高，开源友好
3. 月之暗面 (Kimi) - 长文本处理强
4. 通义千问 - 阿里出品，稳定可靠

Q3: 国内 API 提示认证失败？

A: 检查以下几点：

# 1. 确认 API Key 正确
cat ~/.claude/settings.json | grep apiKey

# 2. 检查 API 地址格式
# 必须以 / 结尾（智谱）
"anthropicBaseUrl": "https://open.bigmodel.cn/api/paas/v4/"

# 3. 确认 API Key 有效
# 登录对应平台检查 Key 状态

Q4: 安装后找不到命令？

# 添加到 PATH
export PATH=$PATH:$(npm config get -g prefix)/bin

# 永久生效（编辑 ~/.bashrc）
echo 'export PATH=$PATH:$(npm config get -g prefix)/bin' >> ~/.bashrc
source ~/.bashrc

Q2: API Key 无效？

# 重新登录
claude auth login

Q3: 克隆仓库超时？

# 等待网络恢复，或使用代理
export https_proxy=http://proxy:port
git clone ...

Q4: MCP 服务器启动失败？

# 检查配置
cat ~/.claude/settings.json | python -m json.tool

# 检查依赖
npm list | grep mcp
pip list | grep mcp

---

🎯 第十章：实战示例

示例 1：从零创建一个 Web API

claude --skill tdd --agent backend-dev "创建一个用户管理的 REST API"

Claude 会：

1. 设计 API 接口
2. 编写测试用例
3. 实现 API 逻辑
4. 添加安全验证
5. 生成文档

示例 2：代码审查和优化

claude --agent code-reviewer @main.py

Claude 会：

1. 分析代码质量
2. 发现潜在问题
3. 提出优化建议
4. 自动修复（如果安全）

示例 3：网页自动化测试

claude --skill e2e "为登录页面编写自动化测试"

Claude 会：

1. 使用 Playwright 编写测试
2. 模拟用户操作
3. 验证功能正确性
4. 生成测试报告

---

📊 第十一章：插件清单总览

已安装的 35+ 插件

类别	数量	代表插件
核心框架	5	claude-flow, everything-claude-code
资源集合	10+	awesome-claude-skills, agents, prompts
学习资源	5+	learn-claude-code, claude-cookbooks
MCP 服务器	10+	firecrawl, playwright, zotero
工具框架	5+	Auto-Claude, claude-task-master

安装统计

📦 仓库总数：35+
🤖 Agents：45+
⚡ Commands：30+
🎯 Skills：50+
🔗 Hooks：1+

---

🚀 总结

你现在拥有：

✅ Claude Code 完整安装
✅ 35+ 个插件仓库
✅ 45+ 个专业 AI 代理
✅ 50+ 个实用技能
✅ 10+ 个 MCP 服务器
✅ 强大的自动化能力

下一步建议：

1. 探索插件

   claude
   > /skills
   

2. 尝试实战

   claude --skill tdd "写一个小功能"
   

3. 阅读文档

   • 各插件的 README.md
   • Claude Code 官方文档

4. 分享经验

   • 把你觉得好用的插件分享给团队
   • 自定义你的专属技能

---

📚 参考资源

官方资源

• Claude Code 官方文档
• MCP 协议规范
• Anthropic API 文档

国内 API 服务商

• 智谱 AI (GLM) - 推荐国内用户
• DeepSeek - 高性价比
• 月之暗面 (Kimi) - 长文本专家
• 通义千问 - 阿里出品
• 百度文心 - 百度大模型

---

💬 交流与反馈

如果你在安装或使用过程中遇到问题，欢迎：

• 🔍 查看 常见问题
• 💬 在评论区提问

---

💡 最后的小提示：Claude Code 的强大之处不在于工具本身，而在于你如何利用它。花时间探索各个插件，找到最适合你的工作流，你会发现开发效率有质的飞跃！

🎉 祝你在 AI 辅助开发的道路上越走越远！

---

觉得有用？别忘了点赞收藏！

有问题？评论区见！