前言

随着 AI 编程的火热，Anthropic 推出的命令行式 AI 编程助手 Claude Code（简称 CC）凭借其强大的上下文控制能力和连贯的任务执行能力，成为了开发者手中的神兵利器。

但在国内使用 Claude Code，我们难免会遇到 API 访问不稳定、模型切换繁琐等问题。今天，我们就来手把手教大家如何搭建一个完美的 Claude Code 本地环境，通过 CC Switch 管理模型供应商，并配置 MCP、Skills 和 提示词，打造一个专属的 AI 编程 Agent！

一、 基础环境搭建：安装 Claude Code

首先，我们需要在本地安装 Claude Code。这里推荐使用 Node.js 的 npm 进行全局安装（请确保电脑已安装 Node.js）。

打开终端（Terminal 或 PowerShell），输入以下命令：

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

安装完成后，输入 claude --version 验证是否安装成功。

💡 国内使用小贴士：
如果你在国内直接启动遇到地区限制或登录问题，可以找到配置文件（Windows 路径通常为 C:\Users\用户名\.claude.json），在文件中添加 "hasCompletedOnboarding": true 参数，即可跳过部分引导验证。

二、 核心神器：使用 CC Switch 对接多模型 API

由于官方 API 的访问门槛，灵活切换国内外的模型供应商（如智谱 GLM、Kimi、阿里通义等）至关重要。这里强烈推荐开源的模型管理工具 CC Switch。

1. 安装 CC Switch
前往 GitHub 官方仓库的 Releases 页面，根据你的系统下载对应的安装包（Windows 推荐下载 .msi 或 .zip 便携版）。

• GitHub 地址：https://github.com/farion1231/cc-switch

2. 配置模型供应商
下载并打开 CC Switch 后，界面非常直观：

• 点击“添加模型供应商”。
• 选择你想要接入的国内大模型（例如智谱 GLM-4.7 或 Kimi-K2.5）。
• 填入对应的 API Key（去各大模型官网申请即可）。
• 设置完成后，在 CC Switch 中一键切换，它会自动帮你更新 Claude Code 的底层配置，无需手动修改繁琐的 JSON 文件。

通过 CC Switch，你还可以集中管理 MCP 服务器和 Skills，极大提升了配置效率。

三、 能力扩展：配置 MCP (Model Context Protocol)

MCP 是 Anthropic 推出的标准协议，它让 AI 能够连接外部系统（如浏览器、数据库、本地文件等），不再局限于处理本地文本。

在 CC Switch 中，你可以非常方便地管理 MCP：

• 同步与添加： 使用 cc-switch mcp sync 或在图形界面中添加新的 MCP 服务器。
• 按需启用： 你可以为 Claude Code 单独启用或禁用某些 MCP 工具。例如，配置一个本地文件检索的 MCP，让 Claude Code 能深度理解你的项目结构。

MCP 的引入，相当于给 Claude Code 装上了“手和脚”，让它能真正操作你的开发环境。

四、 技能加持：安装与使用 Skills

Skills（技能）是将特定任务的操作流程打包成结构化单元的方法。简单来说，就是让 AI 掌握某项垂直领域的“专业技能”。

1. Skills 的安装路径
你可以手动安装 Skills。将下载好的 Skill 文件夹放入以下目录即可：

• 全局目录（推荐）： C:\Users\你的用户名\.claude\skills（所有项目均可调用）
• 项目目录： 当前项目/.claude/skills/（仅当前项目可用）

2. 推荐常用 Skills

• code-review： 专业的 AI 代码审查专家，帮你检查代码规范与潜在 Bug。
• git-expert： Git 版本控制助手，辅助生成 Commit Message 或处理冲突。
• brand-guidelines： 如果你是设计师，这个技能可以让 AI 严格遵循品牌视觉规范。

安装完成后，重启 Claude Code，在对话中输入 /skills 即可查看已加载的技能列表。

五、 个性化定制：提示词 (Prompts) 管理

为了让 Claude Code 的输出更符合我们的习惯（比如全程中文回答、特定的代码风格），配置全局提示词非常有必要。

在 CC Switch 的“提示词管理”板块，你可以轻松实现：

• 创建预设： 新建一个提示词，例如命名为“中文助手”。
• 编写内容： 填入 Always respond in Chinese-simplified 或其他你需要的系统指令。
• 一键激活： 激活该提示词后，Claude Code 就会在所有对话中遵循这一设定。

结语

通过 Claude Code + CC Switch + MCP + Skills 的组合，我们不仅解决了国内访问的难题，更构建了一个高度可扩展、高度个性化的 AI 编程环境。

如果你也在探索 AI 辅助编程，不妨试试这套组合拳，相信会极大提升你的开发幸福感！如果你在配置过程中遇到任何问题，欢迎在评论区留言交流。