Claude Code 使用指南

本教程将指导您完成 Claude Code 的安装、模型配置、Skill 安装以及 MCP 配置，帮助您快速搭建 AI 编程助手环境。

1 npm 环境配置

1.1 安装 Node.js

访问 Node.js 官网 下载并安装 LTS 版本，安装路径建议修改为 D:\Program Files\nodejs。

安装完成后，在 Node.js 安装目录下创建全局 npm 文件夹（用于存放全局模块和缓存）：

1.2 配置环境变量

在系统环境变量中分别配置用户变量和系统变量：

用户变量（Path 中添加）：

系统变量（新建 NODE_PATH）：

1.3 安装 Claude Code

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version
# 输出示例：claude 1.x.x

# 查看帮助
claude --help

安装失败？

如果上述命令安装失败，可尝试以下命令：

npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org/ --include=optional --allow-scripts=@anthropic-ai/claude-code

2 ccswitch 配置

2.1 安装 ccswitch

ccswitch 是一款 Claude Code 的模型路由工具，支持将 Claude Code 连接到自定义模型端点。

访问 ccswitch 官网 下载并安装。

2.2 模型配置

配置 ccswitch 自定义模型需要先开启路由功能。点击设置 → 开启路由功能：

然后点击右上角 + 号新建模型配置，填入以下信息：

• 模型端点 和 API Key：可在 统一门户 → AI Hub → 能力中心 → 统一大模型网关 获取

点击 获取模型，软件会自动从 LLM 端点拉取可用模型列表，选择所需模型后保存即可：

3 Skill 安装

3.1 什么是 Skill

Skill 是 Claude Code 的结构化指令集，用于扩展 AI 编程助手的能力。每个 Skill 本质上是一个 Markdown 文件（SKILL.md），告诉 Claude Code 在特定场景下如何工作。

3.2 安装 Skill 的方式

方式一：通过 /skill 命令安装（推荐）

在 Claude Code 对话中直接输入：

/skill install <skill-name>

例如安装官方安全审查 Skill：

/skill install security-review

方式二：从 GitHub 仓库安装

/skill install https://github.com/user/skill-repo

方式三：手动安装自定义 Skill

将 Skill 文件放置到 Claude Code 的 Skills 目录：

# Windows
%USERPROFILE%\.claude\skills\

# macOS / Linux
~/.claude/skills/

3.3 自定义 Skill 示例

创建一个 my-skill/SKILL.md 文件：

# My Custom Skill

你是一个代码审查助手。当审查代码时，请遵循以下流程：

1. 检查代码风格是否符合团队规范
2. 识别潜在 bug 和性能问题
3. 给出具体的改进建议
4. 按优先级排序输出结果

安装后，在 Claude Code 中通过 /skill my-skill 即可激活。

3.4 常用 Skill 推荐

Skill	用途
security-review	安全漏洞审查
frontend	前端/UI 开发辅助
debugging	调试和问题排查
git-master	Git 操作辅助
writing-plans	开发计划生成

更多 Skill 可在 Agent Skills 官方市场 浏览和下载。

4 MCP 配置

4.1 什么是 MCP

MCP（Model Context Protocol） 是 Anthropic 推出的开放标准协议，允许 Claude Code 通过统一接口调用外部工具和服务（如数据库、API、文件系统等）。

4.2 配置 MCP Server

Claude Code 支持通过 .mcp.json 文件配置 MCP Server。在项目根目录创建配置文件：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "E:\\code\\my-project"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-token>"
      }
    }
  }
}

配置说明

• command：MCP Server 的启动命令
• args：启动参数
• env：环境变量（如 API Key）

4.3 常见 MCP Server 推荐

MCP Server	用途	安装命令
Filesystem	文件系统读写操作	npx @modelcontextprotocol/server-filesystem <path>
GitHub	管理 Issues、PR、仓库	npx @modelcontextprotocol/server-github
Postgres	数据库查询	npx @modelcontextprotocol/server-postgres
Brave Search	网络搜索	npx @modelcontextprotocol/server-brave-search
Puppeteer	浏览器自动化	npx @modelcontextprotocol/server-puppeteer

更多 MCP Server 可在 MCP 官方市场 查看。

4.4 验证 MCP 配置

配置完成后，启动 Claude Code 时会自动加载 MCP Server。在对话中可通过以下方式验证：

# 查看已加载的 MCP 工具
/mcp

如果 MCP Server 未正常加载，请检查：

• 配置文件路径是否正确
• 命令和参数是否有误
• 环境变量（如 API Key）是否已正确设置