# klaudius 中文文档

规范地址：https://npmcn.com/package/klaudius/

版本：0\.45\.1
npm 元数据更新时间：2026-11-03T21:10:58.432Z
中文译文更新时间：2026-11-04T00:34:57.703Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/klaudius
原文对照：https://npmcn.com/package/klaudius/?lang=original
项目主页：https://klaudius.dev/

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

- 包体积（解压后）：424 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.15
- 运行依赖：10 个
- 首次发布：2026-04-29T11:35:11.453Z
- 最新版本发布：2026-11-03T21:10:58.121Z
- 已发布版本数：115（近 12 个月 115 个）

## 中文简介

支撑和维护一个claudius项目——一个运行在Claude Code或Codex上的自主web代理管道（端到端查找、构建、部署、扩展）。

## 安装

```sh
npm install klaudius
```

也可以使用：`pnpm add klaudius`、`yarn add klaudius`、`bun add klaudius`

## README

# Klaudius

> 一个由人工智能运营的自主网络机构。它找到需要网站的本地企业，为每个企业建立一个定制的网站，部署它，并向所有者推销——端到端。

Klaudius是一个完整的网络代理管道，由Claude Code或Codex驱动。给它一个地区，人工智能就会完成工作：它会找到没有网站的当地企业——或者一个死寂的网站，或者只有一个预订平台页面——从公共资源中收集他们的内容，为每个企业建立一个定制的Next.js网站，部署它，并发送宣传和后续行动，将构建者变成付费客户。你用简单明了的语言从你的特工内部指挥一切。

您不需要能够编写代码来运行它。非技术操作员将Klaudius作为交钥匙业务运营；网页设计师和代理商将其作为生产倍增器。它是地区不可知论的——把它指向任何人口稠密的国家，它就能用当地语言工作。

> **注意:** 这个npm包只包含CLI二进制文件。实际的项目源——代理技能、脚本、站点模板和数据库模式——由 `init` 命令，在验证许可证密钥之后 [klaudius.dev](https://klaudius.dev/)． 运行 `npm pack klaudius` 或 `npm install klaudius` 直接不会给你项目源代码。Klaudius应用程序的许可证在应用程序中运行，而不是在这里：下载它 [klaudius.dev /下载](https://klaudius.dev/download)。

## 快速启动

```bash
# 1. Get your machine ready — installs Node + Python, skipping what you already
#    have. Paste the line for your OS into Claude Code or Codex:
curl -fsSL https://klaudius.dev/setup.sh | bash      # macOS / Linux
irm https://klaudius.dev/setup.ps1 | iex             # Windows (PowerShell)

# 2. In a new terminal, scaffold the project (prompts for your licence key):
npx klaudius init my-agency

# 3. Operate the pipeline from inside your agent:
cd my-agency
claude                                # or: codex
> Run the pipeline for New Jersey.
```

setup命令将Node和Python安装到您的用户空间（不需要管理员密码），跳过您已经拥有的任何好版本，并以指向您的飞行前检查结束 `init`。这个 `init` Wizard引导您完成所有工作——定价、国家和语言、扩展渠道、部署主机以及每个人所需的凭据——然后搭建整个项目，应用数据库模式，并安装依赖项。在那之后，你从克劳德代码或法典内部操作管道。

## 命令

`init` 和 `configure` 是你自己键入的两个-都打开一个交互式向导，所以他们需要一个真正的终端，你的代理不能驱动他们。其余的你永远不需要记住：用简单的英语问你的代理（“更新Klaudius”，“检查我的安装是否健康”），它会为你运行它们。大多数 `configure`形状请求根本不需要向导——“将我的价格更改为899美元”或“将我切换到Cloudflare Pages”只是一个选项 `.env` 直接编辑您的座席制作。

```bash
npx klaudius preflight       # Re-check this machine is ready (Node, Python, pip, npm, network; on Windows also that PowerShell can run npx)
npx klaudius init [target]   # Scaffold a fresh project
npx klaudius configure       # Re-run the setup wizard against an existing project
npx klaudius update          # Pull latest template; conflicts staged for resolution
npx klaudius resolve <file>  # Record a decision on one staged conflict (/resolve-conflicts runs it)
npx klaudius doctor          # Diagnose a broken install (env, files, deps, credentials)
```

## 什么东西被架空了

-   **为您的代理提供管道技能** - - - - - - `find`， `gather`， `build`， `deploy`， `outreach`， `follow-up`， `warm-leads`，再加上一双新鲜的眼睛 `qa-reviewer` 在部署之前独立检查每个站点的代理
-   **推销技巧** 当客户转换后，他们会在客户的在线网站上进行额外的改造——一个自助服务的CMS，一个定制的预订系统，一个上线的SEO，一个自动更新的谷歌评级徽章，PDF发票
-   **一个Next.js/Tailwind网站模板** -每个定制客户端构建工作的可定制起点
-   **Python和Node脚本** -电子邮件发送者和读者，其他扩展渠道的适配器，数据库助手，公共数据收集，可交付性检查
-   **预构建的数据库模式** 对于管道的CRM -候选者，状态，外展线程，后续状态
-   **你的代理人阅读的操作手册** （`CLAUDE.md` 对于Claude Code安装， `AGENTS.md` （适用于食品法典）加上操作员文件(`DOCS.html`， `operator-guide.html`)给你

## 更新

更新包含在您的许可证中。要求您的代理“更新Klaudius”，它会提取最新的技能、脚本和模板文件，应用所有可以安全应用的内容，并引导您完成任何需要您做出决定的内容——您自己的编辑永远不会被悄无声息地覆盖。

## 先决条件

-   Node 22.15+和Python 3.10+（如果缺少，上面的setup命令将安装两者）
-   AI编码代理订阅：Claude Code （Anthropic - Pro或Max计划）或Codex （OpenAI - ChatGPT Plus或Pro）
-   一个免费层帐户，该帐户具有运行管道CRM的云数据库（安装向导将其命名并指导您创建项目）。
-   在某个地方部署站点：Vercel（默认）、Cloudflare Pages或netflix（免费层可以启动）或任何您自己的服务器
-   从Gmail， Outlook / Microsoft 365， IONOS, Fastmail， Zoho或Titan （123 Reg / Hostinger / Name.com邮件）发送外联的电子邮件帐户都可以工作。Klaudius支持电子邮件之外的进一步推广渠道-您可以在向导中选择并设置优先顺序
-   您希望从中收集的公共数据源的API密钥

完整的先决条件和设置说明 [klaudius.dev](https://klaudius.dev/)。

## 执照

每个许可证授予单个个人或单个实体。您可以将Klaudius用于您自己的商业工作，但您不得转售或重新分发源代码。全价： [klaudius.dev /条件](https://klaudius.dev/terms)。

## 支持

电子邮件 [hello@klaudius.dev](mailto:hello@klaudius.dev) -你会在24小时内得到详细的、经过深思熟虑的答复，通常更快。

## 关于

更多的在 [klaudius.dev](https://klaudius.dev/)。

## 常见问题

### klaudius 是什么？

支撑和维护一个claudius项目——一个运行在Claude Code或Codex上的自主web代理管道（端到端查找、构建、部署、扩展）。

### 如何安装 klaudius？

在项目目录运行 npm install klaudius，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 klaudius，可以用 npx klaudius 直接运行。

### klaudius 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/klaudius 是否存在。

### klaudius 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### klaudius 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.15。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### klaudius 可以商用吗？

klaudius 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### klaudius 还在维护吗？

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