尧图网站建设 
1. 为什么你的 Claude Code 装不上 superpowers-marketplace如果你最近在折腾 Claude Code 的插件生态大概率刷到过 superpowers-marketplace 这个名字。它本质上是一个插件市场仓库里面托管了 Superpowers 这套技能库——覆盖 TDD、系统化调试、需求拆解、代码审查等十几种开发工作流技能。装上之后Claude Code 在处理帮我规划一个新功能这段代码为什么跑不通这类任务时会主动调用对应的技能模板而不是每次从零开始瞎猜。听起来很美好但真正动手的人会发现官方推荐的/plugin marketplace add obra/superpowers-marketplace这条命令在不少本地环境里根本走不通。我自己第一次装的时候连续撞了三个报错先是 SSH 认证失败换成 HTTPS 又卡在 SSL 证书验证好不容易在 Windows 上推进又冒出 git-bash 环境缺失。折腾了快一个小时才理清头绪。这篇就按添加市场 → 检索启用 → 配置校验三个环节把可复制的配置片段、安装命令、加载状态检查和报错排查一次讲透。适合两类人一是刚接触 Claude Code 插件机制、想搞清楚目录结构的新手二是已经试过官方命令但被网络或环境问题卡住、需要一条能落地的替代路径的开发者。下面所有路径和命令都可以直接改用户名后使用。2. TaoToken 前置准备给 Claude Code 配好可用的模型通道在动插件之前有个容易被忽略的前提Claude Code 本身要能正常发起模型请求否则插件装好了也验证不了技能触发。我建议先把模型接入这条链路理顺再回头搞插件市场这样出问题时能快速区分是插件没加载还是模型通道不通。TaoToken 在这里的角色是提供一个兼容 Anthropic 接口规范的调用入口你不需要改动 Claude Code 的插件逻辑只需要把 Base URL、API Key、Model ID 这三件套配对。具体操作是先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并进入控制台在 API Keys 页面生成一个密钥然后打开接入文档对照 Claude Code 的配置格式填写。这里有个关键点Claude Code 读取的是环境变量或 settings 文件里的配置不是插件目录里的东西。所以插件安装和模型接入是两条独立的线别混在一起排查。我见过有人插件装成功了但测试技能时一直转圈最后发现是 API Key 没配对白白怀疑了半天插件。配置时注意 Base URL 填https://taotoken.net/api不要带任何多余路径后缀Model ID 按文档里列出的可用模型名填写大小写要一致。如果你用的是 Claude Code 的 settings.json 方式配置片段大概长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }把这段合并进你现有的 settings.json别整个覆盖否则会丢掉其他配置。保存后重启 Claude Code先用一句你好确认模型能正常回复再进入插件环节。这一步过了后面插件验证才有意义。3. 可复制配置手动安装 superpowers-marketplace 的完整片段官方命令走不通时核心思路是绕开 Claude Code 的插件管理机制手动把市场目录和插件本体放到它约定的位置。Claude Code 在用户目录下的.claude/plugins/里维护两个子目录marketplaces/放市场配置superpowers/放插件代码。我们要做的就是手动把这两块填进去。先确认你的用户目录。Windows 一般是C:/Users/你的用户名macOS 和 Linux 是/home/你的用户名或~/。下面命令里的你的用户名全部替换成实际值。第一步创建市场目录并复制市场配置。假设你已经把 superpowers-marketplace 仓库克隆到了本地F:/Git/superpowers-marketplace# 确保市场目录存在 mkdir -p C:/Users/你的用户名/.claude/plugins/marketplaces/superpowers-marketplace # 把本地市场仓库内容复制进去 cp -r F:/Git/superpowers-marketplace/. C:/Users/你的用户名/.claude/plugins/marketplaces/superpowers-marketplace/第二步克隆插件本体到插件目录。这一步是重点也是 SSL 报错最容易出现的地方# 创建插件目录 mkdir -p C:/Users/你的用户名/.claude/plugins/superpowers # 进入目录并克隆 cd C:/Users/你的用户名/.claude/plugins/superpowers # 用 -c http.sslVerifyfalse 绕过本地证书链问题 git -c http.sslVerifyfalse clone https://github.com/obra/superpowers.git .注意 clone 命令最后那个.不能省它表示克隆到当前目录而不是新建子目录。如果你本地已经有 superpowers 仓库也可以直接复制过来效果一样。第三步检查目录结构是否符合预期。装完后.claude/plugins/下应该是这样的层级.claude/ ├── plugins/ │ ├── superpowers/ │ │ ├── .claude-plugin/plugin.json │ │ ├── skills/ │ │ └── README.md │ └── marketplaces/ │ └── superpowers-marketplace/ │ └── .claude-plugin/marketplace.jsonplugin.json和marketplace.json这两个文件是 Claude Code 识别插件和市场的关键缺任何一个都会导致加载失败。如果你用的是 Cline MCP 或 Codex 的 auth.json 体系同样要保证 Base URL、Key、Model ID 三件套完整插件目录只是技能来源模型通道还是走前面配好的那套。4. 验证请求确认插件加载状态与技能触发装完不代表生效必须做加载状态检查。最直接的方式是看插件目录里的文件是否齐全以及版本号能否读到。先列出技能目录确认 14 个技能都在ls C:/Users/你的用户名/.claude/plugins/superpowers/skills/正常应该能看到 brainstorming、writing-plans、systematic-debugging 之类的技能文件夹。如果这里是空的说明 clone 没成功或者路径写错了。再读版本号确认插件元数据可解析cat C:/Users/你的用户名/.claude/plugins/superpowers/.claude-plugin/plugin.json | grep version能打印出类似version: 5.0.4就说明 plugin.json 格式没问题。如果这条命令报文件不存在回去检查.claude-plugin这个隐藏目录有没有被复制漏掉。最后做一次真实的技能触发测试。重启 Claude Code输入一句帮我规划一个新功能观察它是否自动调用 brainstorming 或 writing-plans 技能。如果回复里出现了结构化的需求拆解步骤而不是泛泛而谈说明插件已经生效。这一步同时也是在验证模型通道——如果技能触发了但内容生成卡住问题多半在 API 配置而不是插件。想更直观地看模型响应可以到模型对话页面 https://taotoken.net/api 对应的对话入口发一条测试消息确认通道稳定后再回到 Claude Code 做技能测试两边对照能快速定位问题在哪一层。5. 本篇常见报错排查从 401 到 git-bash 缺失把安装过程中最常撞的几类报错集中列一下对照着排。报错一SSH authentication failed。出现在执行/plugin marketplace add obra/superpowers-marketplace时。原因是 Claude Code 尝试用 SSH 连 GitHub但本地没配 SSH 密钥。解决办法是改用 HTTPS 地址或者直接走本文的手动安装路径绕开 SSH 认证。报错二SSL certificate OpenSSL verify result: unable to get local issuer certificate (20)。这是本地证书链不完整导致的常见于公司网络或特定系统环境。临时方案是在 git 命令里加-c http.sslVerifyfalse也就是前面 clone 命令里用的那个参数。注意这只是绕过验证不是修复证书长期用建议把根证书补全。报错三Claude Code on Windows requires git-bash。Windows 上 Claude Code 依赖 git-bash 执行环境。如果你装 Git for Windows 时没按默认位置装或者没配CLAUDE_CODE_GIT_BASH_PATH环境变量就会报这个。解决方式是找到 bash.exe 的实际路径然后设置环境变量指向它set CLAUDE_CODE_GIT_BASH_PATHC:\Program Files\Git\bin\bash.exe报错四401 或 local proxy failed。这类通常不是插件问题而是模型通道配置错了。检查ANTHROPIC_BASE_URL是不是https://taotoken.net/apiAPI Key 有没有多余空格Model ID 是否拼写正确。如果报错里出现reading choices字样说明请求发出去了但响应格式不对多半是 Base URL 带了多余路径。报错五OAuth 相关提示。如果你之前用过 OAuth 登录方式配置里可能残留了冲突字段。把 settings.json 里跟 OAuth 相关的项清掉只保留 Base URL Key Model 三件套。排查顺序建议从下往上先确认模型通道通不通再看插件目录全不全最后才怀疑技能逻辑。这样能避免在插件上白费功夫。6. 后续维护与接入文档插件装好只是开始Superpowers 这类技能库更新比较频繁建议定期手动拉取。进入插件目录执行cd C:/Users/你的用户名/.claude/plugins/superpowers git pull origin main市场目录同理有新插件上架时同步更新marketplaces/superpowers-marketplace即可。同一套手动安装方法也适用于市场里的其他插件把仓库地址换掉、目录名对应改一下就行。如果你在配置模型通道时遇到拿不准的参数直接翻接入文档对照里面列了完整的 Base URL、可用 Model ID 和 settings 片段。需要生成或轮换密钥就去 API Keys 页面操作。长期跑编码和 Agent 任务的话Coding Plan 那条线更适合高频调用场景可以按自己的使用强度选。最后留个实用习惯每次改完配置先用一句简单对话验证模型通道再测插件技能。两层分开验证出问题时能少走很多弯路。 安装superpowers-marketplace插件：Claude Code插件市场配置与验证指南
1. 为什么你的 Claude Code 装不上 superpowers-marketplace如果你最近在折腾 Claude Code 的插件生态大概率刷到过 superpowers-marketplace 这个名字。它本质上是一个插件市场仓库里面托管了 Superpowers 这套技能库——覆盖 TDD、系统化调试、需求拆解、代码审查等十几种开发工作流技能。装上之后Claude Code 在处理帮我规划一个新功能这段代码为什么跑不通这类任务时会主动调用对应的技能模板而不是每次从零开始瞎猜。听起来很美好但真正动手的人会发现官方推荐的/plugin marketplace add obra/superpowers-marketplace这条命令在不少本地环境里根本走不通。我自己第一次装的时候连续撞了三个报错先是 SSH 认证失败换成 HTTPS 又卡在 SSL 证书验证好不容易在 Windows 上推进又冒出 git-bash 环境缺失。折腾了快一个小时才理清头绪。这篇就按添加市场 → 检索启用 → 配置校验三个环节把可复制的配置片段、安装命令、加载状态检查和报错排查一次讲透。适合两类人一是刚接触 Claude Code 插件机制、想搞清楚目录结构的新手二是已经试过官方命令但被网络或环境问题卡住、需要一条能落地的替代路径的开发者。下面所有路径和命令都可以直接改用户名后使用。2. TaoToken 前置准备给 Claude Code 配好可用的模型通道在动插件之前有个容易被忽略的前提Claude Code 本身要能正常发起模型请求否则插件装好了也验证不了技能触发。我建议先把模型接入这条链路理顺再回头搞插件市场这样出问题时能快速区分是插件没加载还是模型通道不通。TaoToken 在这里的角色是提供一个兼容 Anthropic 接口规范的调用入口你不需要改动 Claude Code 的插件逻辑只需要把 Base URL、API Key、Model ID 这三件套配对。具体操作是先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并进入控制台在 API Keys 页面生成一个密钥然后打开接入文档对照 Claude Code 的配置格式填写。这里有个关键点Claude Code 读取的是环境变量或 settings 文件里的配置不是插件目录里的东西。所以插件安装和模型接入是两条独立的线别混在一起排查。我见过有人插件装成功了但测试技能时一直转圈最后发现是 API Key 没配对白白怀疑了半天插件。配置时注意 Base URL 填https://taotoken.net/api不要带任何多余路径后缀Model ID 按文档里列出的可用模型名填写大小写要一致。如果你用的是 Claude Code 的 settings.json 方式配置片段大概长这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }把这段合并进你现有的 settings.json别整个覆盖否则会丢掉其他配置。保存后重启 Claude Code先用一句你好确认模型能正常回复再进入插件环节。这一步过了后面插件验证才有意义。3. 可复制配置手动安装 superpowers-marketplace 的完整片段官方命令走不通时核心思路是绕开 Claude Code 的插件管理机制手动把市场目录和插件本体放到它约定的位置。Claude Code 在用户目录下的.claude/plugins/里维护两个子目录marketplaces/放市场配置superpowers/放插件代码。我们要做的就是手动把这两块填进去。先确认你的用户目录。Windows 一般是C:/Users/你的用户名macOS 和 Linux 是/home/你的用户名或~/。下面命令里的你的用户名全部替换成实际值。第一步创建市场目录并复制市场配置。假设你已经把 superpowers-marketplace 仓库克隆到了本地F:/Git/superpowers-marketplace# 确保市场目录存在 mkdir -p C:/Users/你的用户名/.claude/plugins/marketplaces/superpowers-marketplace # 把本地市场仓库内容复制进去 cp -r F:/Git/superpowers-marketplace/. C:/Users/你的用户名/.claude/plugins/marketplaces/superpowers-marketplace/第二步克隆插件本体到插件目录。这一步是重点也是 SSL 报错最容易出现的地方# 创建插件目录 mkdir -p C:/Users/你的用户名/.claude/plugins/superpowers # 进入目录并克隆 cd C:/Users/你的用户名/.claude/plugins/superpowers # 用 -c http.sslVerifyfalse 绕过本地证书链问题 git -c http.sslVerifyfalse clone https://github.com/obra/superpowers.git .注意 clone 命令最后那个.不能省它表示克隆到当前目录而不是新建子目录。如果你本地已经有 superpowers 仓库也可以直接复制过来效果一样。第三步检查目录结构是否符合预期。装完后.claude/plugins/下应该是这样的层级.claude/ ├── plugins/ │ ├── superpowers/ │ │ ├── .claude-plugin/plugin.json │ │ ├── skills/ │ │ └── README.md │ └── marketplaces/ │ └── superpowers-marketplace/ │ └── .claude-plugin/marketplace.jsonplugin.json和marketplace.json这两个文件是 Claude Code 识别插件和市场的关键缺任何一个都会导致加载失败。如果你用的是 Cline MCP 或 Codex 的 auth.json 体系同样要保证 Base URL、Key、Model ID 三件套完整插件目录只是技能来源模型通道还是走前面配好的那套。4. 验证请求确认插件加载状态与技能触发装完不代表生效必须做加载状态检查。最直接的方式是看插件目录里的文件是否齐全以及版本号能否读到。先列出技能目录确认 14 个技能都在ls C:/Users/你的用户名/.claude/plugins/superpowers/skills/正常应该能看到 brainstorming、writing-plans、systematic-debugging 之类的技能文件夹。如果这里是空的说明 clone 没成功或者路径写错了。再读版本号确认插件元数据可解析cat C:/Users/你的用户名/.claude/plugins/superpowers/.claude-plugin/plugin.json | grep version能打印出类似version: 5.0.4就说明 plugin.json 格式没问题。如果这条命令报文件不存在回去检查.claude-plugin这个隐藏目录有没有被复制漏掉。最后做一次真实的技能触发测试。重启 Claude Code输入一句帮我规划一个新功能观察它是否自动调用 brainstorming 或 writing-plans 技能。如果回复里出现了结构化的需求拆解步骤而不是泛泛而谈说明插件已经生效。这一步同时也是在验证模型通道——如果技能触发了但内容生成卡住问题多半在 API 配置而不是插件。想更直观地看模型响应可以到模型对话页面 https://taotoken.net/api 对应的对话入口发一条测试消息确认通道稳定后再回到 Claude Code 做技能测试两边对照能快速定位问题在哪一层。5. 本篇常见报错排查从 401 到 git-bash 缺失把安装过程中最常撞的几类报错集中列一下对照着排。报错一SSH authentication failed。出现在执行/plugin marketplace add obra/superpowers-marketplace时。原因是 Claude Code 尝试用 SSH 连 GitHub但本地没配 SSH 密钥。解决办法是改用 HTTPS 地址或者直接走本文的手动安装路径绕开 SSH 认证。报错二SSL certificate OpenSSL verify result: unable to get local issuer certificate (20)。这是本地证书链不完整导致的常见于公司网络或特定系统环境。临时方案是在 git 命令里加-c http.sslVerifyfalse也就是前面 clone 命令里用的那个参数。注意这只是绕过验证不是修复证书长期用建议把根证书补全。报错三Claude Code on Windows requires git-bash。Windows 上 Claude Code 依赖 git-bash 执行环境。如果你装 Git for Windows 时没按默认位置装或者没配CLAUDE_CODE_GIT_BASH_PATH环境变量就会报这个。解决方式是找到 bash.exe 的实际路径然后设置环境变量指向它set CLAUDE_CODE_GIT_BASH_PATHC:\Program Files\Git\bin\bash.exe报错四401 或 local proxy failed。这类通常不是插件问题而是模型通道配置错了。检查ANTHROPIC_BASE_URL是不是https://taotoken.net/apiAPI Key 有没有多余空格Model ID 是否拼写正确。如果报错里出现reading choices字样说明请求发出去了但响应格式不对多半是 Base URL 带了多余路径。报错五OAuth 相关提示。如果你之前用过 OAuth 登录方式配置里可能残留了冲突字段。把 settings.json 里跟 OAuth 相关的项清掉只保留 Base URL Key Model 三件套。排查顺序建议从下往上先确认模型通道通不通再看插件目录全不全最后才怀疑技能逻辑。这样能避免在插件上白费功夫。6. 后续维护与接入文档插件装好只是开始Superpowers 这类技能库更新比较频繁建议定期手动拉取。进入插件目录执行cd C:/Users/你的用户名/.claude/plugins/superpowers git pull origin main市场目录同理有新插件上架时同步更新marketplaces/superpowers-marketplace即可。同一套手动安装方法也适用于市场里的其他插件把仓库地址换掉、目录名对应改一下就行。如果你在配置模型通道时遇到拿不准的参数直接翻接入文档对照里面列了完整的 Base URL、可用 Model ID 和 settings 片段。需要生成或轮换密钥就去 API Keys 页面操作。长期跑编码和 Agent 任务的话Coding Plan 那条线更适合高频调用场景可以按自己的使用强度选。最后留个实用习惯每次改完配置先用一句简单对话验证模型通道再测插件技能。两层分开验证出问题时能少走很多弯路。