# @ever-works/claude-code-plugin 中文文档

规范地址：https://npmcn.com/package/%40ever-works/claude-code-plugin/

版本：1\.0\.18
npm 元数据更新时间：2026-11-03T08:55:36.002Z
中文译文更新时间：2026-11-14T01:17:54.582Z
软件包许可：AGPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ever-works/claude-code-plugin
原文对照：https://npmcn.com/package/%40ever-works/claude-code-plugin/?lang=original
项目主页：https://github.com/ever-works/ever-works/tree/main/packages/plugins/claude-code#readme
源码仓库：https://github.com/ever-works/ever-works

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.1 MB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@ever-works/plugin ^1\.2\.16
- 首次发布：2026-06-06T08:18:20.547Z
- 最新版本发布：2026-11-03T08:55:35.656Z
- 近 30 天下载量：3189（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

Claude 代码生成器插件 - 代表生成到 Claude 代码的完整管道插件

## 安装

```sh
npm install @ever-works/claude-code-plugin
```

也可以使用：`pnpm add @ever-works/claude-code-plugin`、`yarn add @ever-works/claude-code-plugin`、`bun add @ever-works/claude-code-plugin`

## README

# @ever-works/claude-code-plugin (中文(简体) )

Claude代码生成器插件 - 完整的管道插件,将生成到Claude代码.

## 插件元数据

| 外地 | 数值 |
| --- | --- |
| 身份证 | `claude-code` |
| 类别 | `pipeline` |
| 能力 | `pipeline`, (中文(简体) ), `form-schema-provider` |
| 作者 | 永远工作团队 |
| 许可证 | AGPL-3.0 导弹 |
| 内建 | 对 |
| 可自动启用 | 没有 |

## Claude 代码生成器插件

完全管道插件 将整个工作代 给克洛德代码。 此插件运行一个单一的 Claude 代码会话,可以自主处理网页搜索,内容创建,以及文件生成.

## 如何运作

该插件运行了6个相继步骤 :

1.  **设置 Claude 代码** 下载和缓存 Claude 代码 CLI 二进制
2.  **准备背景** - 以现有项目和元数据创建临时工作空间并播下种子
3.  **生成项目** - 执行克洛德代码CLI作为JSON文件进行研究和生成工作项目
4.  **收集结果** - 读取生成的 JSON 文件以构建管道结果
5.  **抓取屏幕截图** - 对需要图像的项目进行截图
6.  **清理** - 取消临时工作空间

## 设置

| 设置 | 说明 |
| --- | --- |
| `oauthToken` | Claude 代码 OAuth 令牌 |
| `apiKey` | Anthropic API 键 |

### 认证

至少其中一个 `oauthToken` 或者说 `apiKey` 必须提供。 OAuth 标志优先.

**OAuth 托肯语Name** (建议):

```bash
claude setup-token
```

**API 密钥**数字 : 从一个 [control.harmanic.com (中文(简体) )](https://console.anthropic.com/)

## 使用量

启用工作插件并触发生成 `providers.pipeline: 'claude-code'`。 。 。 .

## 设置

这个 `settingsSchema` 揭露:

-   `oauthToken` (用户,秘密)——克洛德代码OAuth sord from `claude setup-token`。从env 读取 `PLUGIN_CLAUDE_CODE_OAUTH_TOKEN`。 。 。 .
-   `apiKey` (用户,秘密)——Anthropic API密钥出自Controup. harmanic.com.
-   `model` (全球)——模型别名(`sonnet`, (中文(简体) ), `opus`, (中文(简体) ), `haiku`)或明确版本(如:. `claude-sonnet-4-5-20250929`) (中文(简体) ). 默认为 `sonnet`。 。 。 .
-   `version` (隐藏) —— Claude Code CLI 版本由插件粘接; 二进制被下载并被缓存在先使用上.
-   `maxTurns` (隐藏) – 每会话最大代理转折(默认为50,范围为1-100).
-   `maxBudgetUsd` (隐藏)——可选的每代美元预算.

该插件的 **CLI 二进制** 自动管理并存储在平台的临时目录下;用户不配置二进制路径. **Auth 模式** 隐含:如果 `oauthToken` 设置插件使用 OAuth, 否则它会倒回 Anthropic API 键.

## 解决问题

| 症状 | 可能的原因是 | 修补 |
| --- | --- | --- |
| 世代从不开始/留在 `0%` | `claude-code` 未选择此工程的运行中的管道插件 | 打开工作 **插件** → `pipeline` 能力和设置 `claude-code` 作为活动管道;或 设置为全球管道默认 **设置 — 插件** |
| 步骤失败 `No AI / search / screenshot provider configured` | 管道依赖于无法启用或没有证书的能力插件 | 启用并配置工作或全球匹配能力插件( AI 提供者、 搜索、 截图、 内容提取器) |
| 步骤输出看起来错误/ 通用 | Form-field 调制未设置; 使用与工程域不符的默认管道 | 打开 **生成表单** 为工作设置特定域(类别、目标关键词、源 URL),并重运行受影响的步骤 |
| 子进程错误 : `command not found` | `Claude Code Generator` 运行 API 主机上未安装 CLI | 在 API 主机上安装 Claude 代码生成器 CLI ,并确保它启用 `PATH`; 通过运行验证 `which <cli>` 发射的同一枚炮弹 `pnpm dev:api` |
| 认证 / 设备- 自动流动站 | 上游 IDE / 浏览器中从未确认设备自动代码 | 重运行设备自动流出 **设置 – 插件 – Claude-code – 连接**,然后在代码到期前在上游服务中填写提示 |
| 主机重启后管道无法恢复 | 检查站没有继续存在(今天只有标准管道维持检查站) | 取消被卡住的运行并重新触发生成; 因为生产可靠性更可取 `standard-pipeline` |

## 地方发展

这个插件船与Ever Works平台一起内置. 从单列波根进行本地研究:

```bash
pnpm install
pnpm --filter @ever-works/claude-code-plugin build
pnpm --filter @ever-works/claude-code-plugin test
```

## 文档

-   [工程文档](https://docs.ever.works/)
-   [Ever 工程仓库](https://github.com/ever-works/ever-works)
-   [插件系统](https://npmcn.com/package/plugin/README.md)
-   [Claude 代码主页](https://github.com/anthropics/claude-code)
-   [自动控制台](https://console.anthropic.com/)
-   此插件执行 `pipeline` 定义的能力 `@ever-works/plugin`。 。 。 .

## 许可证

AGPL-3.0 导弹

## 常见问题

### @ever-works/claude-code-plugin 是什么？

Claude 代码生成器插件 - 代表生成到 Claude 代码的完整管道插件

### 如何安装 @ever-works/claude-code-plugin？

在项目目录运行 npm install @ever-works/claude-code-plugin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@ever-works/plugin（^1\.2\.16）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ever-works/claude-code-plugin 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @ever-works/claude-code-plugin 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ever-works/claude-code-plugin 可以商用吗？

@ever-works/claude-code-plugin 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @ever-works/claude-code-plugin 的下载量有多少？

根据 npm 官方下载统计，@ever-works/claude-code-plugin 在 2026/10/14 – 2026/11/12 这 30 天内被下载 3,189 次，日均约 106 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ever-works/claude-code-plugin 还在维护吗？

最新版本 1\.0\.18 发布于 2026/11/03（10 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/06/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。