# @clagentic/console 中文文档

规范地址：https://npmcn.com/package/%40clagentic/console/

版本：1\.12\.0
npm 元数据更新时间：2026-11-11T15:41:20.611Z
中文译文更新时间：2026-11-13T06:39:19.313Z
软件包许可：FSL-1\.1-MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40clagentic/console
原文对照：https://npmcn.com/package/%40clagentic/console/?lang=original
项目主页：https://clagentic.ai/tools
源码仓库：https://github.com/clagentic/clagentic-console

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

- 包体积（解压后）：5.9 MB，482 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.0\.0
- 运行依赖：9 个
- 首次发布：2026-05-13T12:48:30.417Z
- 最新版本发布：2026-11-11T15:41:20.128Z
- 近 30 天下载量：2145（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：64（近 12 个月 64 个）

## 中文简介

Claude Code和Codex的自控控制台. 多用户,基于浏览器,持续AI会话.

## 安装

```sh
npm install @clagentic/console
```

也可以使用：`pnpm add @clagentic/console`、`yarn add @clagentic/console`、`bun add @clagentic/console`

## README

![Clagentic: Console](https://npmcn.com/package/%40clagentic/console/media/logo/console-lockup-256.png)

#### 人类和AI特工共享的工作空间.

[![clagentic.ai](https://img.shields.io/badge/-clagentic.ai-00CFFF?style=flat&logoColor=white)](https://clagentic.ai/) [![License: FSL-1.1-MIT](https://img.shields.io/badge/License-FSL--1.1--MIT-blue?style=flat)](https://npmcn.com/package/%40clagentic/console/LICENSE) [![CI](https://github.com/clagentic/clagentic-console/actions/workflows/pr-checks.yml/badge.svg?branch=main)](https://github.com/clagentic/clagentic-console/actions/workflows/pr-checks.yml) ![Node.js 20+](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js&logoColor=white) [![npm version](https://img.shields.io/npm/v/@clagentic/console?style=flat&label=npm)](https://www.npmjs.com/package/@clagentic/console) [![npm downloads](https://img.shields.io/npm/dw/@clagentic/console?style=flat&label=downloads)](https://www.npmjs.com/package/@clagentic/console) [![Support on Ko-fi](https://img.shields.io/badge/Ko--fi-FF5E5B?style=flat&logo=ko-fi&logoColor=white&label=support)](https://ko-fi.com/clagentic)

Clagentic: Console是自发托管的团队工作空间,人类开发者和被命名的AI代理共享同一界面. 多个用户连接到一个单一守护进程,每个守护进程都有自己的账户和项目访问. 代理人是一等的参与者——不是你们民意调查的背景过程,而是有自己对话历史,上下文窗口,和会话状态的被命名的实体,整个团队都能看到. 每个项目,每个会话, 每个工具批准 住在你的机器上,并停留在那里.

## 特工是一等的用户

代理不需要浏览器 。 从外壳,或从控制台会话内部,代理人可以:

-   **公开会议:** `clagentic-console open-session --to reviewer@my-project --prompt "Review the open change."`
-   **消息会话 :** `clagentic-console send-input --to builder@my-project --prompt "The build passed."` 这些投入被推入会议,如果收到,会议将首先恢复.
-   **答复:** `clagentic-console send-input --reply --prompt "Done."` 回答上次留言的人.
-   **列出会议:** `clagentic-console list-sessions --state live` 显示每个会话的状态和它正在等待的任何提示.
-   **列出会议发送的内容:** `clagentic-console list-outbound --session 4f1c9d2e-7a3b-4c55-9e0a-1b2c3d4e5f60 --since 2h` 显示该会话的呼叫(以其供应商会话编号命名) `list-sessions`由 `send-input` 财务报告和审定财务报表 `open-session`:目标,即时,时间和发起. 守护进程默认保留了30天(`outboundRetentionDays` 内 `daemon.json`· ; `0` 停止记录并删除已存在的条目。 快速文本会转到守护进程每次运行时的 OS 用户; 以另一个 OS 用户( os- users mode) 运行的会话会被列出而不包含文本, 因为该文本永远不会被存储 。 见 [代理指南](https://npmcn.com/package/%40clagentic/console/docs/guides/AGENT-GUIDE.md#list-outbound)。 。 。 .
-   **调度输入 :** `clagentic-console schedule-input create --session 12 --project my-project --every 30m --count 4 --prompt "Check the build."` 将文本发送到以后的会话中,一次或重复一次总是有结束的会话中。 人们在留言箱旁边的时钟按钮上也这样做.

每一个发送的被注入的信息记录,一个特工的信息从未被记录为人类的信息. 见 [代理指南](https://npmcn.com/package/%40clagentic/console/docs/guides/AGENT-GUIDE.md) 每个动词和旗帜.

## 安装

```bash
npm install -g @clagentic/console
```

然后启动守护进程 :

```bash
clagentic-console
```

或尝试不安装:

```bash
npx @clagentic/console
```

**所需经费:** 节点.js 20+. 被认证的克洛德代码CLI,代码CLI,或者两者兼有. 编码不捆绑: 自己安装( C)`npm install -g @openai/codex`,0.148.0或更新的版本)。 控制台运行着它从 `CLAGENTIC_CONSOLE_CODEX_PATH` (绝对路径),那么 `codex` 打开 `PATH`,然后在代理拾取器中显示路径和版本.

### 邮购/系统d

在 Linux 上,一个全局 npm 安装运行一个 postinstall 脚本,用于注册并启用一个 `clagentic-console.service` 系统化单位。 脚本永远不会重新启动一个已经运行的守护进程——活动会话不会被中断. 从应用程序内部触发的自更新完全跳过重启,让系统 `Restart=always` 处理优雅关闭后的交接.

安装从不读取或写入您的 Claude 代码设置 。 让特工逃跑 `list-sessions`, (中文(简体) ), `send-input` 财务报告和审定财务报表 `open-session` 将建议的规则添加到 `permissions.allow` 在您自己的 Claude 代码设置中;见 [建议允许规则](https://npmcn.com/package/%40clagentic/console/docs/guides/AGENT-GUIDE.md#suggested-allow-rules),它也带有用于添加该设备的1.10.x安装器(# 468)的迁移注释 `list-sessions` 规则.

要跳过邮站脚本:

```bash
npm install -g @clagentic/console --ignore-scripts
```

## 它会做什么

-   **真正的团队账户.** 每个队员都有自己的登录. 多个用户同时连接到同一个Console守护进程——每个都拥有自己的会话历史,项目访问,以及工具批准流. 没有共享证书,没有每个用户安装.
    
-   **特派员作为头等舱学员.** 定义于 `.claude/agents/` 或者说 `~/.claude/agents/` 不是背景剧本——他们都是正式的参与者. 每一个都以自己的对话历史、背景窗口和状态运行。 团队成员可以喜欢的代理,直接DM,并看哪些代理活跃. 类型 `@` 在会话中输入一个名称.
    
-   **团队小组.** 一个专用的团队表面列出了每个人类用户和与控制台相连的指定代理人. 直接告诉任何参与者,看看谁在线,管理代理名册——都来自显示你项目的同名侧边栏.
    
-   **通过YOKE销售商不可知论.** YOKE适配器层将克洛德码(Claude Agent SDK),ChatGPT Codex(codex app-server JSON-RPC),以及未来的本地模型作为可互换后端. 按会话切换供应商;会话记住他们的选择. YOKE 还交叉注入指令文件 - `CLAUDE.md`, (中文(简体) ), `AGENTS.md`, (中文(简体) ), `.cursorrules`, (中文(简体) ), `COPILOT.md`, (中文(简体) ), `.github/copilot-instructions.md` ——项目背景达到任何正在运行的模型.
    
-   **多项目仪表板.** 每一次雷波在一边栏的守护进程注册. 在项目间跳转,并行运行会话,一览即可看到现场状态.
    
-   **内脏注射.** Pin 运行终端,活浏览器标签,和粘贴笔记作为活性上下文源. 它们的内容会自动流入每条消息:自您上次消息以来,终端输出作为三角洲,浏览器标签作为完整的快照. 没有手动复制。 没有额外的提示.
    
-   **循环自动化.** 写一个 `PROMPT.md`开始循环。 Clagentic:Console运行快取,评价结果,并重试直到完成或封顶. 带有标准克龙语法的排程循环来运行未被关注.
    
-   **外相触发.** 将 JSON 文件丢入 `~/.clagentic/console/external-triggers/` 以生成新的 AI 会话或向现有的会话注入信息。 用这个来给特务接通脚本,CI管道,或者其他AI进程——没有API,没有投票,只是文件的倒放.
    
-   **移动 PWA + 推取通知.** 可安装在iOS和Android上. 批准你手机上的工具电话 根据批准申请、错误和任务完成情况进行点火.
    
-   **OS级隔离 (Linux).** 在 Linux 上, 选择 : 每个用户映射到一个真实的系统账户, 文件 ACLs 通过 `setfacl`,在正确的UID/GID下处理产卵.
    
-   **MCP服务器.** 已建入问用户和浏览器服务器 。 通过用户配置的 MCP `~/.clagentic/mcp.json`在克勞德和克勞德克思分会中工作.
    
-   **你的数据,你的机器.** 会话为JSONL,设置为JSON,知识为Markdown. 无云中继,无专有数据库.
    
-   **克来特语:Lite (可选).** 若为 [文莱: 文莱](https://clagentic.ai/tools) 安装了项目设置,每个项目的入学控制表和系统设置增加了一个全局自动滚动切换。 控制台被动地检测到它——如果它不存在,没有什么变化.
    

## 开始

首先,你会被问到一个端口 并促使创建您的管理账户。 从您网络上的任何设备打开URL——团队成员可以从自己的机器上登录自己的账户.

启用系统设置中的多用户模式来激活OS级隔离(Linux)和团队管理面板. 额外的账户由管理员UI或CLI创建;每个用户获得独立的会话历史和项目访问.

对于远程接入,使用地道——分道岔,Cloudflare隧道,或您现有的VPN.

## CLI 选项

```bash
npx @clagentic/console              # Default (port 2633)
npx @clagentic/console -p 8080      # Specify port
npx @clagentic/console --yes        # Skip prompts, use defaults
npx @clagentic/console -y --pin 123456
npx @clagentic/console --add .      # Add current directory to running daemon
npx @clagentic/console --remove .   # Remove project
npx @clagentic/console --list       # List registered projects
npx @clagentic/console --shutdown   # Stop daemon
```

也可用 `clagentic-console` 如果安装在全球范围.

## 建筑

Clagentic:Console是一个自发的守护进程. 它通过克洛德特工SDK和克洛德克思通过 `codex app-server` JSON-RPC协议通过供应商不可知适配器层(YOKE),服务于HTTP/WS上的多用户网络工作空间. 会话和设置以普通的JSONL/JSON/Markdown在磁盘上直播.

```mermaid
graph LR
    subgraph Clients
      B1["Browser"]
      B2["Browser (multi-user)"]
      Phone["Phone PWA + Push"]
    end

    subgraph Daemon["Clagentic: Console Daemon (your machine)"]
      Auth["Auth + RBAC"]
      Server["HTTP / WS Server"]
      Project["Project Context"]
      YOKE["YOKE Adapter Layer"]
      MCP["Built-in MCP servers\nask-user / browser"]
      Push["Push (VAPID)"]
    end

    subgraph Vendors["Agent runtimes"]
      Claude["Claude Agent SDK"]
      Codex["codex app-server\n(JSON-RPC stdio)"]
    end

    B1 <-->|WS| Server
    B2 <-->|WS| Server
    Phone <-->|WS + push| Server
    Server --> Auth
    Server --> Project
    Project --> YOKE
    Project --> MCP
    Project --> Push
    YOKE --> Claude
    YOKE --> Codex
    Push -.-> Phone
```

关于建筑细节、序列图和关键设计决定,见 [文件/指南/建筑](https://npmcn.com/package/%40clagentic/console/docs/guides/architecture.md)。 。 。 .

## 警卫

这些是执行级属性,而不是配置选项——它们适用于每一个安装.

-   **托肯TTL(英语:Token TTL).** 多用户认证证书在30天后失效(`TOKEN_TTL_MS`) (中文(简体) ). 在TTL支持被添加前发布的tokens在第一次使用时被迁移到一个新的30天窗口,以避免升级时强制登录.
    
-   **原子写作,模式0o600.** 所有配置和状态文件( A)`users.json`, (中文(简体) ), `auth-tokens.json`通过重命名后写来写入:数据转到一个 `.tmp.<pid>` 路径,然后 `rename()` 解剖学上取代了目标. 重命名后, `chmod 0o600` 将适用。 给同一文件的同步写作按照呼叫顺序进行序列化.
    
-   **仅附审计日志.** 私自行动——用户创建、停机、吊销令牌、多用户启用/失效——被写成新线限定的JSON `~/.clagentic/console/audit.log` (模式0o600,以 `O_APPEND`) (中文(简体) ).
    
-   **逐渐关闭.** 登录失败尝试触发每个用户名的升级后退:1s,5s,30s,5min. 达到阈值会导致永久关闭,直到管理员明确解锁账户。 每个IP限制率平行运行.
    
-   **OS级隔离(Linux,多用户模式).** 每个应用程序用户映射到一个真实的系统账户. 文件控制列表通过 `setfacl`;在正确的UID/GID下进行产卵.
    

## 测试

测试套房涵盖26个测试文件的12个领域:

-   **靴子/烟雾** - 守护进程启动、配置靴子、警卫检查
-   **安全门** ——认证符号TTL,锁定阈值,PIN率限制,审计日志条目
-   **WebSocket 许可门** ——按用户按RBAC执行WS信息类型
-   **届会周期** - 会场开放、恢复、关闭和收割者行为
-   **外部触发器** ——v1和v2 触发处理,文件归档,重新启动存活
-   **调度器** ——克龙解析,循环执行,运行会计
-   **存储原子** ——同时写入序列化,原子重命名,0o600模式
-   **XSS 逃脱** —— HTML 中提供的用户控制字符串输出消毒
-   **YOKE 稳健性** ——供应商适配器错误处理和倒置路径
-   **SDK桥** ——插槽计数器,信息处理器,斜线指令丰富,工作流程和技能发现,工人停工
-   **重播** ——会话重播正确性
-   **无害环境管理进口检查** ——验证包可导入为ES模块

运行套房 : `npm test`

### 用于人工测试的局部安装(仅开发者)

> **警告:** 这是手动的,只有开发者的便利. 不要从CI,自动化脚本,系统化单元,或任何其他工具中调用. 这不是一个释放或部署机制.

在全球安装当前工作树并测试它是否为真正的最终用户安装

```bash
npm run install:local-test
```

这个运行 `npm pack` (尊重 `files` 列表中 `package.json`,所以你得到 准确的什么会运送到npm, 在全球安装 由此产生的柏油球 `npm install -g`,并去掉沥青球。 结果是与 `npm install -g @clagentic/console` - 没有连锁,没有 `node_modules` 快捷键.

测试完成后, 解除安装 :

```bash
npm uninstall -g @clagentic/console
```

## 财务问题

**"这是克劳德代码包装"** 没有 Clagentic:Console通过克洛德特工SDK和Codex通过Codex应用服务器协议驱动克洛德代码. 它增加了多会场的管弦乐,命名代理会话,计划代理,多用户支持,内置的MCP服务器,上下文注入,外出触发器,上方还有完整的浏览器UI.

**"什么是命名的探员?"** 在您的 Claude 代码配置中定义的代理( )`.claude/agents/` 或者说 `~/.claude/agents/`)是一流的团队参与者. 类型 `@` 在会话输入中看到每个已安装的代理并直接启动一个——它自己的对话历史、上下文窗口和会话状态。 团队成员可以和人类用户一起从团队小组中最喜爱的代理人和DM.

命名的代理人是 **目前只有克洛德代码.** 代码适配器没有对应的API用于每会场代理身份注射. 当您处于一个 Codex 会话时,代理切入点被隐藏. 部分代码对等(系统即时预置)被计划.

**"上下文注射如何进行?"** 在会话输入区打开上下文面板。 键入运行中的终端,浏览器标签(需要Clagentic: Console Chrome 扩展),或粘接符. 从这开始,您发送的每条消息都会自动包括这些来源的最新内容——终端输出作为自上条消息以来的三角洲,浏览器标签作为完整的页面快照. 注射发生在您的消息到达模型之前; 您不需要在您的提示中提及来源 .

**"什么是外部触发系统?"** 将 JSON 文件丢入 `~/.clagentic/console/external-triggers/`守护进程会在几秒钟内取出 v1 触发会生成新的会话, 并带有 `initialPrompt`。一个 v2 触发器可以生成一个会话,也可以通过 `sessionId`。文件存档于 `processed/` 在成功方面。 未处理的文件幸存了守护进程重启 。 用这个将克洛德接入脚本,CI管道,克龙活口,或其他AI进程.

**"它读什么指导文件?"** YOKE 扫描工程目录 `CLAUDE.md`, (中文(简体) ), `AGENTS.md`, (中文(简体) ), `.cursorrules`, (中文(简体) ), `COPILOT.md`,以及 `.github/copilot-instructions.md`每个销售商都从本地读到其中一些——克劳德读到 `CLAUDE.md`代码 `AGENTS.md`。正在运行的供应商不本地读取的文件被合并并注入到额外的上下文中,所以无论哪个供应商运行,您的项目指令都会到达模型中.

**"Claude Code和Codex之间的特征均等是否完成?"** 还没有 被命名的特工是主要漏洞——克洛德特工SDK直接曝光特工身份注射;Codex则不然. Claude Code是首要的发展目标。 Codex支持涵盖会话,工具批准,模型选择,MCP服务器,循环,以及大多数UI表面. 依赖于克洛德特工SDK内部的特征 今天没有Codex等同的特征.

**"我可以运行克洛德代码和代码 在同一工作空间?"** 对 开场时选个卖家 每场会话切换——会话记住他们的供应商.

**"我的密码会离开我的机器吗?"** 仅作为模型API调用——与直接使用CLI相同. 会话、设置和知识都留在磁盘上.

**"我的CLAUDE.md/AGENTS.md工作吗?"** 对 原生指令文件被每个供应商加载并自动合并. 非本土文件由YOKE交叉注入.

**"我能在浏览器中继续一个CLI会话吗?"** 对 CLI会话出现在侧边栏中,可以在CLI中取取.

**"我能用在手机上吗?"** 对 在iOS或Android上作为PWA安装. 推进审批通知书,出错,任务完成.

**"它与MCP服务器合作吗?"** 对 用户配置的 MCP 来源 `~/.clagentic/console/mcp.json` 加上内置的询问用户和浏览器服务器在克洛德和Codex会话中都工作.

**"多用户支持"** 是的,这是一个核心设计目标,而不是附加目标。 真实的账号,独立的会话历史,以及一个团队面板,显示每个与Console连接的人类用户和代理人. 在Linux上,启用OS级隔离:每个用户映射到一个真实的Linux账户,文件ACLs通过 `setfacl`,在正确的UID/GID下处理产卵.

**"与克来特人融合吗:"立特** 是的,可选的. [文莱: 文莱](https://clagentic.ai/tools) 将代理门,会话内存,审计线索添加到任何回放中. 如果安装了升( I)`~/.clagentic/lite/`),控制台自动检测,并在每个项目的设置中显示一个入学面板. 启用系统设置中的自动录入以连接添加上的每个工程 。 Lite从不需要——没有它,控制台正常工作.

## 支助

如果 Clagentic: 控制台对您有用: [ko-fi.com/clagentic (英语)](https://ko-fi.com/clagentic)

## 贷项

从 [克莱](https://github.com/chadbyte/clay) 由乍得根据麻省理工学院许可证使用.

## 免责声明

不隶属于Anthropic或OpenAI. 克洛德是Anthropic的商标. Codex是OpenAI的商标. 只要"如上"没有保证 用户负责遵守其AI供应商的服务条款.

## 许可证

[FSL-1.1-MIT 导弹](https://npmcn.com/package/%40clagentic/console/LICENSE) ——功能源许可证1.1,以麻省理工学院为变更许可证.

个人、内部商业、评价、研究和非商业用途免费. 提供这种工具(或一分叉)作为竞争的商业产品并不自由. 每个都在其两周年时向麻省理工学院发布自动转换.

根据麻省理工学院(麻省理工学院),在作出这一修改之前,释放的代码仍然可用([豁免/麻省理工学院.txt](https://npmcn.com/package/%40clagentic/console/LICENSES/MIT-legacy.txt)) (中文(简体) ).

## 常见问题

### @clagentic/console 是什么？

Claude Code和Codex的自控控制台\. 多用户,基于浏览器,持续AI会话\.

### 如何安装 @clagentic/console？

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

### @clagentic/console 支持 TypeScript 吗？

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

### @clagentic/console 需要什么版本的 Node\.js？

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

### @clagentic/console 可以商用吗？

@clagentic/console 使用 FSL-1\.1-MIT 许可。声明的许可为 FSL-1\.1-MIT，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @clagentic/console 的下载量有多少？

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

### @clagentic/console 还在维护吗？

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