claude-code-configuration

用途

该技能面向 Claude Desktop 与 Claude Code 的配置管理，适用于配置 Claude、搭建 MCP 服务器，或涉及 settings.json、claude_desktop_config、MCP server、Claude config 等场景。它管理 Claude Desktop 和 Claude Code 的配置文件，包括 MCP 服务器设置、项目设置与开发者选项。

配置文件位置

Claude Desktop（macOS）：

配置：~/Library/Application Support/Claude/claude_desktop_config.json
日志：~/Library/Logs/Claude/
开发者设置：~/Library/Application Support/Claude/developer_settings.json

Claude Desktop（Windows）：

配置：%APPDATA%\Claude\claude_desktop_config.json
日志：%APPDATA%\Claude\Logs\

Claude Code（项目级）：

设置：.claude/settings.json
插件市场：.claude-plugin/marketplace.json

Claude Desktop 配置

基本结构：

{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "VAR_NAME": "value"
      }
    }
  }
}

重要说明：

始终使用绝对路径——工作目录可能未定义
Windows 路径：使用正斜杠或双反斜杠
需要重启：配置更改后重启 Claude Desktop
环境变量：默认受限（USER、HOME、PATH）；需在 env 中显式设置

Claude Code 项目设置

.claude/settings.json：

{
  "enabledPlugins": ["plugin-name"],
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "company/claude-plugins"
      }
    }
  }
}

团队配置：当团队成员信任该文件夹时自动安装市场：

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company/plugins"
      }
    },
    "project-tools": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

快速校验

# Validate JSON syntax
jq empty ~/Library/Application\ Support/Claude/claude_desktop_config.json
jq empty .claude/settings.json

# Check server names
jq -r '.mcpServers | keys[]' ~/Library/Application\ Support/Claude/claude_desktop_config.json

快速排查

如果 MCP 服务器未加载：

校验 JSON 语法
确认命令路径为绝对路径
检查环境变量是否已设置
查看日志：~/Library/Logs/Claude/mcp*.log
重启 Claude Desktop

参考

针对特定场景的详细文档：

MCP Patterns——服务器配置示例（Python、Node.js、环境变量）
Troubleshooting——常见问题、日志位置、调试工具
Workflows——添加服务器、团队设置、迁移的分步指南

后续步骤

参见 EXAMPLES.md 获取真实世界的配置示例。

限制

资料未提供该技能的收费、价格、平台支持范围、效果或具体使用步骤之外的更多信息，相关内容暂未提供。