@falkenslab/agent-kit

中文文档
0.35.0发布于 2026/11/12MITTypeScriptES Module近 30 天下载 2626

在克洛德特工SDK上方建一个代理的图书馆

中文使用文档
文档目录7 节
  1. 为什么是特工
  2. 快速启动
  3. - 密码的味道
  4. 工作上见
  5. 里面有什么东西
  6. 页:1
  7. 发展中
agent-kit logo: three blue building blocks and a coral one being set in place

代理设备

在克劳德身上建立一个AI代理,在它行动之前询问,记忆,和聊天像克劳德代码.
你写你的经纪人知道和做的; 工具包带来监督,安全,内存和接口.

npm Node.js 20+ Claude Agent SDK TypeScript License: MIT

页:1 • 妇女 埃斯帕尼奥尔文件

特工基特是建造AI特工的基础 在顶端 克劳德探员SDK。它不是一个代理本身:它一旦解决了每一个代理需要的东西(监督级别,批准,安全限制,跨会话的内存,扩展,以及像克洛德代码那样的终端聊天),所以每个代理只写属于它自己的域:它知道怎么做,用什么工具,如何说话. 老师的"Moodle"助理和"说笑话"的"海盗"猫"都是同样建造的.

为什么是特工

  • 🎚️ 你选择它独自行动的程度. 自动的,引导的(它问在别人看到或无法解除之前),一步步的,或者计划模式,它只读和计划;在同一对话中切换它们.
  • ✋ 它问一个人, 和工具包确定. 批准,选择,一个文件,一个手签;一个已经安装的扩展名的工具,可以改变事物,等待任何模型决定的肯定,答案可以持续到会话或好.
  • 🧠 它记得. 一种知识基础,随着每次会话的不断增长,它从未触及的原始文献中学习的原始文献,对人的记忆,以及每一次与人对话的回放 --continue 或者说 /resume。 。 。 .
  • 🛡️ 它保持在极限. 只有它自己的文件夹,从不保护文件,不能滑过主代理极限的子代理,隐藏在日志中的秘密,远程服务器允许,询问或拒绝.
  • 🧩 它随着扩展而增长. Claude代码插件,带有MCP服务器,技能和命令,从市场或文件夹中安装,在聊天中有自己的选项,签名和目录;不需要Git.
  • 🌐 它会说出你的语言. 它的界面是英语,西班牙语,法语或德语,它用该语言回答,除非你用另一种语言写.
  • 🖥️ 像克洛德代码那样的终极聊天, 或者根本没有. 全屏幕,活的标记下,折叠的工具呼叫,面板,历史,主题;或者桌面应用程序或网页内有自有界面的同一种代理.

快速启动

惠璶 节点.js 20岁或20岁以后 还有克劳德的账户 在与 "type": "module" 联合国 package.json数字 :

npm install @falkenslab/agent-kit tsx

另存为 agent.ts:唯一属于你经纪人的部分是顶部的谱.

import path from "node:path";
import { buildSessionOptions, ensureClaudeAuth, runChatInk, type AgentSpec, type BaseSessionConfig } from "@falkenslab/agent-kit";

const spec: AgentSpec<BaseSessionConfig> = {
  buildSystemPrompt: () => "You are a pirate cat who tells jokes. Always answer in character.",
  buildMcpServers: () => ({}), // its own MCP servers, if any
  pluginRoots: () => [], // folders with skills and commands
  buildSubagents: () => undefined, // subagents, if it delegates to any
};

await ensureClaudeAuth(); // offers to sign in with your Claude account, on Anthropic's page, if it isn't
const config: BaseSessionConfig = { mode: "guided", projectDir: process.cwd() };

// Each run gets a folder under .run/ (keep it out of git): its log, transcript and conversation.
await runChatInk((run) => buildSessionOptions(config, run.dir, spec, { run }), {
  runsDir: path.resolve(".run"),
  header: { title: "My agent" },
  mode: config.mode, // Shift+Tab cycles through guided, step by step and plan
  fullscreen: true,
});

运行它 npx tsx agent.ts:一个全屏聊天打开,用你系统的语言,代理在任何不该单独做的事情之前询问. 这个 教程 从那里拿走.

- 密码的味道

给它一个内存和一个源的文件夹, 与工具包自己的扩展:

import { knowledge, memory, sources } from "@falkenslab/agent-kit";

const spec: AgentSpec<BaseSessionConfig> = {
  // …
  extensions: [sources({ dir: "sources" }), knowledge({ dir: "knowledge" }), memory({ dir: "memory" })],
};

让它从您的市场安装扩展, 并保持它的数据离开计算机而不询问:

const config: BaseSessionConfig = {
  mode: "guided",
  projectDir: process.cwd(),
  extensionDirs: { agent: path.join(os.homedir(), ".my-agent", "extensions") },
  officialMarketplace: "falkenslab/agent-extensions",
  remoteServers: "ask",
};

做一个工具总是等待 一个人是,在每一个呼叫:

const spec: AgentSpec<BaseSessionConfig> = {
  // …
  extensionGate: { confirmTools: { canva: ["create-design", "publish-design"] } },
};

工作上见

威斯克队长,工具箱的楷模代理:一个退休的海盗猫用你的语言讲笑话,有一群子代理(一个在网络上寻找新笑话,一个评分,一个告诉时间),一个日志和自己的扩展. 他在终端,浏览器和Windows应用程序中运行.

Captain Whiskers in Windows Terminal: his logo with the mode and the agent-kit version at the top, his crew at work in the middle, a task list under the spinner, and the framed prompt and status bar at the bottom

见 尽他所能有截图 对于一个真正的, 宫城 是Moodle教师的助手:它分数、回答论坛、构建内容、总结课程, 监督、记忆、安全和聊天都来自工具箱;Miyagi带来了它所知道的关于Moodle的东西.

里面有什么东西

区域举个例子
* 模式和大门自主地,有指导地,分步骤地,有计划地;有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有计划地,有指导地,有指导地,有指导地,有指导地
环中人批准、选择、自由文本、文件、手动步骤、MCP引出表单、没有键盘的主机响应文件
QQ 记忆一个知识库(一个LLM wiki), 源保持获得, 人物记忆, 运行恢复与 --continue 财务报告和审定财务报表 /resume
++ 扩展使用 MCP 服务器( 本地、 npm 、 远程 OAuth) 的 Claude 代码插件、 技能、 命令和子代理; 范围、 锁定、 工作空间信任、 选项、 市场和目录
• 警卫一个文件瞄准门, 拒绝路径, 子代理门, 一个远程服务器门, 与跑者自己的 Claude 代码隔离
副代理人仅宣布类型,在前景中,没有主要代理的 Bash
++ 接口一个全屏墨水聊天,一个平版读行聊天,一个进度视图,一个向导,一个主题;一个桌面应用程序和网页的聊天控制器;一个MCP服务器,所以其他代理可以询问它的东西
语文界面、答复和扩展服务器的英文、西班牙文、法文和德文

每一个出口,用它需要的和它给予的,都是在 API 参考。 。 。 .

页:1

发展中

设计决定 和SDK行为 通过人工检查 背后的几个保障 .minispec/。 。 。 .

命令它会做什么
npm run build将工具包构建为 dist/
npm run typecheck检查类型而不构建
npm run lint检查代码样式
npm test运行所有测试( 一个文件 : npx tsx --test test/tui/promptErrors.test.ts(中文(简体) )
npm run docs:install安装文档站点的依赖性( 一次)
npm run docs:start在本地服务文档站点, 重新加载更改
npm run docs:build构建文档站点( 断开链接失败)

在代理机中尝试修改套件而不发布,请指其 package.json 切换为本地克隆"file:../agent-kit"运行 npm run build 每次改变之后.

与克洛德密码合作的工具包通过Falken实验室的自身技能(承诺、核实、更新文件、发布、同步问题,以及READMEs、网站和Markdown的家用风格),来自 falkenslab/falkenslab-插件 市场。 安装一次,所有法尔肯实验室的仓库:

claude plugin marketplace add falkenslab/falkenslab-plugins
claude plugin install falkenslab-dev@falkenslab-plugins
claude plugin install falkenslab-style@falkenslab-plugins
每个插件带来什么, 以及留在这个寄存器
  • 🔧 falkenslab- dev 数据数字 : commit, (中文(简体) ), verify, (中文(简体) ), update-docs, (中文(简体) ), release, (中文(简体) ), sync-issues, (中文(简体) ), upgrade-deps 财务报告和审定财务报表 add-tool。 。 。 .
  • 🎨 falkenslab 样式数字 : falkenslab-docs, (中文(简体) ), falkenslab-site-style, (中文(简体) ), falkenslab-terminal-screenshots 财务报告和审定财务报表 markdown-writing。 。 。 .

在克洛德代码内,同样与 /plugin marketplace add falkenslab/falkenslab-plugins 财务报告和审定财务报表 /plugin install falkenslab-dev@falkenslab-plugins· ; /plugin marketplace update falkenslab-plugins 带来他们的最新版本。 这个寄存器只保存作为代理 Kit 自己的技能, in .claude/skills/ (单位:千美元)add-export、迷你电视剧和 upgrade-sdk),而其释放对一般的附加内容是: CLAUDE.md。 。 。 .

由法尔肯实验室团队制作

版本与发布记录

@falkenslab/agent-kit 共发布 30 个版本,首次发布于 2026/09/28;过去 12 个月发布了 30 个版本。

版本发布日期距今
0.35.0latest2026/11/122 天前
0.34.02026/11/104 天前
0.33.02026/11/095 天前
0.32.02026/10/2916 天前
0.31.02026/10/2816 天前
0.30.12026/10/2619 天前

关于 @falkenslab/agent-kit 的常见问题

@falkenslab/agent-kit 是什么?

在克洛德特工SDK上方建一个代理的图书馆

如何安装 @falkenslab/agent-kit?

在项目目录运行 npm install @falkenslab/agent-kit,或使用 pnpm add / yarn add / bun add。

@falkenslab/agent-kit 支持 TypeScript 吗?

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

@falkenslab/agent-kit 支持 ESM 还是 CommonJS?

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

@falkenslab/agent-kit 需要什么版本的 Node.js?

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

@falkenslab/agent-kit 可以商用吗?

@falkenslab/agent-kit 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@falkenslab/agent-kit 的下载量有多少?

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

@falkenslab/agent-kit 还在维护吗?

最新版本 0.35.0 发布于 2026/11/12(2 天前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/09/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。