1. 为什么你的 Claude Code 装了 MCP 和 Skills 却像没装一样很多人第一次接触 Claude Code都是被“命令行里的 AI 编程助手”这个定位吸引进来的。它跟编辑器插件最大的区别在于Claude Code 能自己控制上下文、连续执行多步任务还能通过 MCP 调用外部工具、通过 Skills 复用固定流程。听起来很美好但真正动手时问题往往出在配置这一层——settings.json 写错一个字段MCP 就永远显示 failedSkills 放错目录Claude 根本不会加载模型切换没配好每次都要手动改环境变量。这篇就聚焦一件事把 Claude Code 接入 MCP 与 Skills 的本地配置全流程走通。面向的是刚接触 AI 编程工具、Node.js 装过但不算熟的开发者。我会给出 settings.json 和 config.toml 的可复制骨架、CC Switch 切换配置的操作步骤以及用一次实际调用验证 MCP 与 Skills 是否生效的检查动作。照着配完你至少能确认三件事MCP 连上了、Skills 被识别了、模型能一键切换。先明确三个概念后面配置才不会晕。Claude Code简称 CC是 Anthropic 出的命令行 AI 编程助手靠claude命令启动支持切换模型和调用外部工具。MCPModel Context Protocol是一个让 AI 访问外部系统的协议浏览器、数据库、代码仓库都能接进来AI 不再只盯着本地文件。Skills 则是把某类任务的操作流程、脚本、参考资料打包成结构化单元相当于可复用的“超级提示词”同类任务不用每次重复沟通。这三者配合起来Claude Code 才从“会聊天的命令行”变成“能干活的工作台”。而把它们串起来的就是配置文件。2. 前置准备Node.js、TaoToken 与目录约定在写配置之前先把地基打好。Claude Code 依赖 Node.js 运行MCP 服务器大多通过 npx 拉起所以 Node.js 是硬性前提。装好后在命令行验证node --version npm --version建议 Node.js 18 以上npx 能正常调用。如果版本太低MCP 服务器启动时会报奇怪的模块错误排查起来很费时间。接下来是模型接入。Claude Code 本身需要配置模型来源这里我用 TaoToken 作为统一入口它同时提供对话和 API 能力配置方式对新手比较友好。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 这个不加 UTM。你需要先去控制台创建一个 API Key后面 settings.json 里会用到。目录约定也要提前说清楚因为 Claude Code 的配置分两层全局配置在用户目录下项目配置在项目根目录的.claude/里。全局的 settings.json 影响所有项目项目的 settings.json 只影响当前仓库。Skills 同理全局放~/.claude/skills/项目放.claude/skills/。MCP 的配置则通常写在项目级的.mcp.json或 settings.json 的 mcpServers 字段里。我建议新手先用全局配置跑通再往项目里搬。这样出问题时影响面小也容易回滚。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的核心配置文件是 settings.json。它一般放在~/.claude/settings.json全局或项目根目录.claude/settings.json项目级。下面是一个可以直接抄的骨架重点看 env 和 mcpServers 两块{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_API_Key, ANTHROPIC_MODEL: claude-sonnet-4-5 }, mcpServers: { chrome-devtools: { command: npx, args: [-y, chrome-devtools-mcplatest] }, filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, ./] } }, permissions: { allow: [Bash(npm run *), Read, Write] } }几个字段说明一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 端点ANTHROPIC_AUTH_TOKEN填你创建的 KeyANTHROPIC_MODEL指定默认模型。mcpServers 里每个键就是一个 MCP 服务器command 是启动命令args 是参数。filesystem 这个 MCP 我特意加了./表示只允许访问当前目录避免 AI 乱翻文件。如果你用的是 CC Switch 这类模型管理工具它可能会生成一个 config.toml 来管理多套配置。典型骨架长这样[[providers]] name taotoken base_url https://taotoken.net/api api_key 你的_TaoToken_API_Key model claude-sonnet-4-5 [[providers]] name backup base_url https://taotoken.net/api api_key 备用_Key model claude-haiku-4-5config.toml 的作用是把多套模型配置存起来切换时不用手改 settings.json。CC Switch 读取这个文件后你点一下就能换 provider。注意 base_url 和 api_key 要跟 settings.json 保持一致否则切换后会出现鉴权失败。Skills 的配置不在 settings.json 里而是靠目录结构。一个 Skill 就是一个文件夹核心是 SKILL.md.claude/skills/ └── code-review/ ├── SKILL.md ├── scripts/ │ └── lint.sh └── references/ └── checklist.mdSKILL.md 里写元数据和执行指南Claude 会根据描述判断什么时候加载这个 Skill。放对目录它才会被识别。4. 用 CC Switch 切换配置并验证 MCP 与 Skills 生效配置写完接下来是切换和验证。CC Switch 的安装包在它的 release 页面下载装好后打开它会读取你本地的 config.toml 或 settings.json。操作步骤大致是先添加 provider把 TaoToken 的 base_url、api_key、model 填进去然后在主界面选中要用的 provider点应用最后重启 Claude Code 让配置生效。切换完成后验证分三步走。第一步确认模型通了。在命令行执行claude -p 用一句话说明你当前使用的模型如果返回正常内容说明 base_url 和 api_key 没问题。如果报 401多半是 Key 填错或没生效回去检查 settings.json 的 env 字段。第二步确认 MCP 连上了。启动 Claude Code 后输入斜杠命令/mcp正常情况下会列出已配置的 MCP 服务器状态显示 connected。如果显示 failed先看 npx 能不能单独跑起来npx -y chrome-devtools-mcplatest --help能跑说明是 Claude Code 的配置路径问题不能跑说明是 Node.js 或网络问题。第三步确认 Skills 被识别。在 Claude Code 里输入/skills或者直接问它“你现在有哪些可用的 skill”。如果列表里出现了你放在.claude/skills/下的名字说明加载成功。没出现就检查目录层级必须是.claude/skills/skill-name/SKILL.md少一层都不行。我实测下来最容易翻车的是 MCP 的 args 写法。比如 filesystem 服务器路径参数如果写成绝对路径但目录不存在启动就会静默失败。建议先用相对路径./跑通再改成具体目录。5. 本篇常见错排查从 401 到 Skill 不加载配置过程中遇到的报错八成集中在这几类。第一类鉴权失败。表现是claude -p返回 401 或 invalid api key。原因通常是 ANTHROPIC_AUTH_TOKEN 没填、填了多余空格、或者 CC Switch 切换后没重启。解决方法是直接打开 settings.json 核对然后claude update更新到最新版再试。第二类MCP 显示 failed。先看/mcp的具体报错信息。如果是command not found说明 npx 不在 PATH 里如果是超时可能是网络问题换个 MCP 服务器测试。还有一种情况是 MCP 服务器启动了但握手失败这时候把 args 里的-y去掉试试有些包需要交互确认。第三类Skills 不加载。最常见的原因是目录放错。Claude Code 只认.claude/skills/不认.claude/skill/或skills/。另外 SKILL.md 的文件名必须全大写写成 skill.md 也不会被识别。如果目录对了还是不加载检查 SKILL.md 的 frontmatter 是否有 name 和 description 字段缺了这两个元数据Claude 无法判断何时调用。第四类模型切换后行为异常。比如切换 provider 后回答风格突变或直接报错。这通常是 config.toml 里 model 字段跟 base_url 不匹配比如把只支持某类模型的端点配了另一个模型名。解决方法是回到 CC Switch 里逐个 provider 测试确认每个组合都能单独跑通。第五类权限拦截。Claude Code 默认会询问是否允许执行某些操作如果你在 settings.json 的 permissions.allow 里没放行MCP 调用会被卡住。建议初期先手动确认跑通后再把常用命令加进 allow 列表。6. 配好之后把配置沉淀成可复用资产走到这里你应该已经能确认 MCP 连上了、Skills 被识别了、模型能切换了。但配置这件事跑通一次不算完关键是让它可复用。我的做法是把全局 settings.json 当成模板每开一个新项目只复制需要的 MCP 和 Skills 进去项目级的.claude/目录跟着仓库走。这样换机器时clone 下来就能用不用重新配一遍。CC Switch 的 config.toml 也建议纳入版本管理但 api_key 用环境变量占位别直接提交明文。如果你还想深入下一步可以去看 TaoToken 的接入文档把 API Key 管理和模型对话调通API Keys 页面在 https://taotoken.net/console/api-keys 接入文档在 https://taotoken.net/doc 。想先试试模型对话效果的可以直接用 https://taotoken.net/models 。长期做编码和 Agent 任务的Coding Plan 在 https://taotoken.net/coding-plan 。Claude Code 相关的 Anthropic 接入说明在 https://taotoken.net/claudecode-anthropic 。配置这东西第一次配觉得繁琐配顺了就是肌肉记忆。真正拉开差距的不是你会不会写 settings.json而是你有没有把常用流程沉淀成 Skills让 AI 每次都用同一套标准干活。