# @0xmaxma/claude-gateway 中文文档

规范地址：https://npmcn.com/package/%400xmaxma/claude-gateway/

版本：2\.1\.12
npm 元数据更新时间：2026-11-06T02:49:39.422Z
中文译文更新时间：2026-11-06T00:51:15.634Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%400xmaxma/claude-gateway
原文对照：https://npmcn.com/package/%400xmaxma/claude-gateway/?lang=original
项目主页：https://github.com/0xMaxMa/claude-gateway#readme
源码仓库：https://github.com/0xMaxMa/claude-gateway

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

- 包体积（解压后）：15.4 MB，2122 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：18 个
- 首次发布：2026-05-14T02:24:36.687Z
- 最新版本发布：2026-11-06T02:31:34.274Z
- 近 30 天下载量：7797（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：166（近 12 个月 166 个）

## 中文简介

克劳德的多代理网关

## 安装

```sh
npm install @0xmaxma/claude-gateway
```

也可以使用：`pnpm add @0xmaxma/claude-gateway`、`yarn add @0xmaxma/claude-gateway`、`bun add @0xmaxma/claude-gateway`

## README

# 克劳德网关

**Claude Code的管弦乐、语音和多频道平台.**

Claude Gateway在Claude Code的员工执行任务时保持对话响应. 通过您连接的渠道交谈或键入, 跟踪进度, 并携带您的代理员的记忆和技能跨会话 .

![Claude Gateway](https://npmcn.com/package/%400xmaxma/claude-gateway/resource/claude_gateway.jpeg)

[文档](https://0xmaxma.github.io/claude-gateway/) • 妇女 [快速启动](https://0xmaxma.github.io/claude-gateway/guide/quickstart.html) • 妇女 [API 参考](https://0xmaxma.github.io/claude-gateway/api/)

## 特征

-   🔎 **联合评估** ——代理商,职工共享的可选打字选择,分数和名词评价以及范围化整合,具有直接或相容的上游资质. 见 [Jev 设置](https://0xmaxma.github.io/claude-gateway/guide/jev.html)。 。 。 .
    
-   🪄 **代理管弦乐引擎** ——在工人执行持久任务时进行响应性对话. 仪表板将代理/工人的代号用途分开,提供附有缓存和工具细节的每期报告。 没有开关的现有配置自动升级; 明确 `false` 仍然是选择退出。 见 [管弦乐设置](https://0xmaxma.github.io/claude-gateway/reference/orchestration-settings.html)。 。 。 .
    
-   🔥 **代理指挥** ——在可重复使用的工人执行持久任务的同时,保持对话响应,报告进展情况,接受后续指示,支持取消. 见 [协调与任务](https://0xmaxma.github.io/claude-gateway/guide/orchestration.html)。 。 。 .
    
-   ⚙️ **工人的用具** ——在准备就绪时自动将GPT工人传送到本地的Codex,克洛德代码在发送到主机或内部的应用容器之前会回落. Claude代码上还有谈话特工 见 [工人的用具](https://0xmaxma.github.io/claude-gateway/guide/worker-harnesses.html)。 。 。 .
    
-   🧰 **纸板** - 装入 [点心](https://github.com/michael-denyer/pstack-claude) Claude 代码插件只针对您所设置的代理 `/pstack-setup`,以每个代理模型工作表,子代理作为网关任务和现场审查小组状态。 见 [纸板](https://0xmaxma.github.io/claude-gateway/guide/pstack.html)。 。 。 .
    
-   🎙️ **语音对话** ——通过按代理模式和声音进行语音识别和语音回答,直接或上游提供者,现场或录音语音输入,以及音频重播. 见 [语音设置](https://0xmaxma.github.io/claude-gateway/guide/voice.html)。 。 。 .
    
-   🧠 **技能自我改进** ——代理从自己的工作中学习可再用的技能:在实质性转会后,背景审查员创建或更新技能,为下回转会热重装. 得到证明的保镖(从未超过人类写作技能),每天封顶,接受审计 `SKILLS_LEARNED.md`。见 [`gateway.skillLearning`](https://0xmaxma.github.io/claude-gateway/reference/memory-settings.html#gateway-skilllearning)
    
-   📚 **知识基础(双行道记忆)** ——每名代理SQLite/FTS5可搜索档案通过曝光 `memory_search` 编号 : `memory_get` MCP工具,所以代理人员回忆到不符合总注入核心的注释;块会携带出处失效而索引被刷新出出自网关事件回路. 见 [`gateway.knowledge`](https://0xmaxma.github.io/claude-gateway/reference/memory-settings.html#gateway-knowledge)
    
-   🌙 **夜梦** ——长期内存的背景整合:仅由印刷品审查员向安全应用员写作的操作建议 `MEMORY.md` 编号 : `USER.md` (支持、限值损失、预算超出时净负数)。 定型收缩,预算规模的挤压,和 Staleness GC保持内存接近预算而不会忘记——存档条目仍然可以搜索. 见 [`gateway.dreaming`](https://0xmaxma.github.io/claude-gateway/reference/memory-settings.html#gateway-dreaming)
    
-   🤖 **多剂** ——从一个单一的网关运行多个bot,每个网关都有孤立的会话
    
-   🔒 **孤立的内存模式** - 为许多无关的发送者服务的代理人 `USER.md`编号 :`MEMORY.md` 每个对话,共享内存,技能,克龙,代理和app工具被关闭;一个应用代理也在自己的沙盒容器中运行每个对话,每个信道工具只回复由来的对话. 设定 `agents[].isolateMemory` 或 `services.agent.isolate_memory` 在应用程序 `app.yaml`。见 [孤立内存模式](https://0xmaxma.github.io/claude-gateway/reference/memory-settings.html#isolated-memory-mode)
    
-   🔌 **多渠道 MCP** – 每个频道的模块化工具系统(Telegram, Discord, LINE, Slack, WhatsApp, Cron, 技能, 可扩展到更多)
    
-   📥 **海峡入侵恢复** ——不可用附件保存消息和可读文件;Telegram/Discord接收器重试隔离对话并归档 stale startup 队列而不执行旧请求. 见 [内部复苏](https://0xmaxma.github.io/claude-gateway/api/orchestration.html#channel-ingress-recovery)。 。 。 .
    
-   ⏳ **供应商出厂接纳** ——持久冷却约束重复报告/推论失败,保留排队输入和任务结果,并曝光等待状态而不再重启运行的工人. 见 [供应商录用设置](https://0xmaxma.github.io/claude-gateway/reference/orchestration-settings.html#provider-admission)。 。 。 .
    
-   🧩 **代理技能** – 通过 SKILL.md 文件可扩展技能系统;代理在运行时可以使用热重装从 URL 创建、删除并安装技能
    
-   🎭 **代理身份** 通过工作空间标记文件定义个性、语气和规则
    
-   📡 **实时状态信息** 实时状态更新,显示工具的使用、思维和进度
    
-   ⌨️ **打字指标** ——代理工作时连续打入动画(Telegram and Discord)
    
-   🌊 **流出 API** - SSE(服务员-恒星事件)实时响应流的终点
    
-   ↪️ **自动前进** ——代理文本输出即使没有明确的回复工具调用也自动传输到Telegram
    
-   ⏰ **心跳/ 预定任务** ——通过HERTBEAT.md + REST API提供基于核心的主动信息和重复任务;代理任务向Telegram, Discord 或两者都提供输出
    
-   💬 **持续聊天历史** - 双层存储:会话背景(`.jsonl`\+ 永久 SQLite DB 带有 FTS5 全文搜索;存活 `/compact` 和会议驱逐
    
-   🧹 **自动清理** ——可配置的留存政策每天排出超过N天的信息和媒体文件
    
-   🗄️ **长期记忆** ——会间持续记忆系统
    
-   🔄 **配置自动移徙** ——配置格式改变时自动进行计划迁移
    
-   🔐 **访问控制** 许可列表、开放或对等的Telegram访问政策
    
-   🌐 **HTTP API 密码** —— REST API 有基于密钥的外部集成认证
    
-   🛍️ **应用程序存储** ——在网关上安装,更新并主机多克编程应用程序;应用程序在 `/app/:name/:portName/*`,用于主机脚本的可选 Unix 套接字桥,以及可选的 AI 代理注入
    
-   ⬆️ **自更新日期** ——检查更新版本 `claude-gateway` 财务报告和审定财务报表 `claude-code` 然后通过一个API呼叫(不需要SSH或 shell访问)触发更新,或者从终端启动 `claude-gateway update` 编号 : `claude-gateway claude update`; 网关跟随 npm `stable` ditt-tag( 秒数) (`--latest` (最新版本)
    
-   💾 **持续会期** ——通过重启保存并恢复对话历史
    
-   🖥️ **PTY 外壳( 包装外壳模式)** ——可选交互式伪地后端(`gateway.headless: false`用于需要真实 TTY 的工具;包括活浏览器查看器(xterm.js)和 a `/api/v1/sessions/:sessionId/screen` 将可见屏幕作为纯文本返回的结束点 —— 代理可以进行测试, 以检测挂起状态、 菜单或意外输出, 不解析 ANSI 逃生代码 ; a `/cli` 聊天命令(Telegram/Discord/LINE)为单一代理打开同一取景器,代理瞄准镜和没有管理键;app代理和管弦乐总是保持无头
    

## 开始吧

安装有频道支持的节点.js 22+, Bun, 和一个经认证的克洛德代码 CLI. 管弦乐在Linux,macOS,和Windows上运行. 应用程序需要多克/ 构成; 一些语音格式需要 `ffmpeg`。 。 。 .

```bash
npm install -g @0xmaxma/claude-gateway
claude-gateway gateway start
```

在另一个终端:

```bash
claude-gateway agents create
```

跟着 [快速启动](https://0xmaxma.github.io/claude-gateway/guide/quickstart.html),则 [启用管弦乐](https://0xmaxma.github.io/claude-gateway/guide/orchestration.html), (中文(简体) ), [连接频道](https://0xmaxma.github.io/claude-gateway/guide/channels.html),可选择 [配置语音](https://0xmaxma.github.io/claude-gateway/guide/voice.html)。 。 。 .

## 学多点

| 专题 | 文档 |
| --- | --- |
| 配置和全权证书 | [配置](https://0xmaxma.github.io/claude-gateway/reference/configuration.html) |
| 代理人、工人和任务控制 | [管弦](https://0xmaxma.github.io/claude-gateway/guide/orchestration.html) |
| 平台符号和频道设置 | [频道](https://0xmaxma.github.io/claude-gateway/guide/channels.html) |
| STT, TTS, 供应商和重放 | [语音](https://0xmaxma.github.io/claude-gateway/guide/voice.html) |
| 请求、响应、流和权限 | [API 参考](https://0xmaxma.github.io/claude-gateway/api/) |
| 运行、升级和故障排除 | [业务](https://0xmaxma.github.io/claude-gateway/guide/operations.html) |
| 来源建设和捐款 | [发展](https://0xmaxma.github.io/claude-gateway/reference/development.html) |

API的文档在文档网站上生活. [CLI 命令引用](https://0xmaxma.github.io/claude-gateway/reference/cli.html) 是生成的命令引用。 要编辑或预览此网站,请参见 [网站开发](https://npmcn.com/package/%400xmaxma/claude-gateway/website/README.md)。 。 。 .

### 安装卫生

运行 `claude-gateway doctor` 检查启动、语音和可选的 Codex 依赖性,即使 服务器已关闭 。 使用 `claude-gateway doctor fix` 用于支持当地维修和 丢失的安装 `ffmpeg`编号 :`ffprobe`。修理要求确认,绝不 启动或重新启动网关。 见 [诊断和维修](https://0xmaxma.github.io/claude-gateway/guide/troubleshooting.html#gateway-will-not-start-doctor-and-repair)。 。 。 .

浏览器语音可以在导航后恢复未听到的已核准回复. 保留客户 每会话模式/默特意图并重新连接回放收据;见 [语音恢复协议](https://npmcn.com/package/%400xmaxma/claude-gateway/website/api/voice.md#resume-browser-voice-after-navigation)。 。 。 .

浏览器重放在原声之前可供核准口头答复使用 录音完成,包括中断的回放。 明确的重放可以生成 缺少与配置的 TTS 提供者的音频( 正常的提供者收费适用) . 见 [重放和重播控制](https://npmcn.com/package/%400xmaxma/claude-gateway/website/api/voice.md#retained-speech-replay)。 。 。 .

### 安全模式调查

运行 `claude-gateway safemode --name investigation --prompt "Inspect this gateway problem"` 进行本地互动Claude密码调查 而不阻止网关. 使用 `--cli codex` 选择代码x, `--model` 覆盖本地模式,以及 `--resume investigation` 回到同样的调查。 保护安全模式 建立/启动证据并使用单独的源快照。 会话 ID 是 当地Claude代码/编码; `safemode rename ID NEW_NAME` 更改别名 没有打扰到谈话。 无头收购, 请求ID和信任的操作员代理控制在 [安全模式指南](https://npmcn.com/package/%400xmaxma/claude-gateway/website/guide/safemode.md). 受信任的代理人可以发现明确指派的调查,并作为网关管理的任务追踪,自动完成报告和对话控制.

作为网关管理,Paired桌面 MCP连接器也可以通过Jev运行 计算机 使用任务, 并获得本地应用程序的同意和相同的共享思维 配置 。 见 [计算机使用连接器](https://npmcn.com/package/%400xmaxma/claude-gateway/website/guide/jev.md#computer-use-connectors)。 。 。 . 没有Jev,计算机使用可以选择每个步骤,由代理商自己的模型通过 `gateway.computerUse`; 见 [没有Jev的计算机使用](https://npmcn.com/package/%400xmaxma/claude-gateway/website/guide/jev.md#computer-use-without-jev)。 。 。 .

### 计算机使用同意

计算机能力发现列表 在线计算机配对而不要求访问. 一个由网关管理的计算机任务只有在启动时才要求访问. 桌面 然后所有者选择应用程序(或明确选择所有应用程序)和 a 会期。 拒绝执行;单靠配对和发现永远不会 启动桌面动作。 任务等待取消和所有权的批准 检查活动,而不是要求用户在设置中预先访问.

## 常见问题

### @0xmaxma/claude-gateway 是什么？

克劳德的多代理网关

### 如何安装 @0xmaxma/claude-gateway？

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

### @0xmaxma/claude-gateway 支持 TypeScript 吗？

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

### @0xmaxma/claude-gateway 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @0xmaxma/claude-gateway 需要什么版本的 Node\.js？

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

### @0xmaxma/claude-gateway 可以商用吗？

@0xmaxma/claude-gateway 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @0xmaxma/claude-gateway 的下载量有多少？

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

### @0xmaxma/claude-gateway 还在维护吗？

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