让开源，少一点语言距离。
npm包中文文档

@futuretea/tea-code

中文文档
2.4.1发布于 2026/11/01MITES Module构建来源已验证近 30 天下载 2326

下Gen 代理的起点

中文使用文档
中文原文
文档目录7 节
  1. 什么是"茶"代码CLI
  2. 安装
  3. 快速启动
  4. 关键特性
  5. 文档
  6. 仓库和问题
  7. 许可证

@futuretea/tea-code( 未来代码)

下Gen 代理的起点

npm License Docs

什么是"茶"代码CLI

Tea Code CLI是一个在你的终端运行的AI编码代理. 它可以读取并编辑代码,运行 shell 命令,搜索文件,取取网页,并根据收到的反馈选择下一步. 它与"月光AI"的"木乃伊"模型一起在盒子外工作,也可以被配置成使用其他相容的提供商.

安装

茶法CLI要求节点.js 22.19.0或更晚. 用 npm 安装它 :

npm install -g @futuretea/tea-code

或与平按:

pnpm add -g @futuretea/tea-code

在窗口上安装 窗口的 Git 在第一次发射之前,因为"茶"代码CLI使用被捆绑的"基特·巴什"作为其外壳环境. 如果 Git Bash 安装在一个自定义位置, 设置 KIMI_SHELL_PATH 到绝对路径 bash.exe。 。 。 .

然后用新的 shell 会话运行:

tea-code --version

关于升级和卸载指令,见 开始。 。 。 .

快速启动

打开一个工程并启动交互式 UI :

cd your-project
tea-code

在第一次发射时,运行 /login 在Tea Code CLI内部选择Kimi Code OAuth或Kimi平台 API 键. 登录后, 请尝试第一个任务 :

Take a look at this project and explain the main directories.

关键特性

  • npm发行. 使用独立的 npm 或 pnpm 安装和更新 @futuretea/tea-code 软件包.
  • 快速启动. TUI在毫秒内就绪,所以开会从未感到沉重.
  • 波兰TUI. 为长而有重点的代理会话设计的仔细调制的界面.
  • 视频输入. 将屏幕录音或演示剪辑放入聊天中——让代理看而不是打出在文字中难以描述的内容.
  • AI-本土MCP配置. 以对话方式通过 /mcp-config ——无手编JSON.
  • 用于重点突出,平行工作的分剂. 内置调度 coder, (中文(简体) ), explore,以及 plan 孤立上下文窗口中的子代理; 主对话保持干净.
  • 寿轮钩子. 在关键点运行本地命令——闸机危险工具呼叫,审计决定,起火桌面通知,接通自己的自动化.

文档

仓库和问题

许可证

麻省理工学院

版本与发布记录

@futuretea/tea-code 共发布 11 个版本，首次发布于 2026/07/30；过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
2.4.1latest2026/11/0115 天前
2.4.02026/10/2917 天前
2.3.22026/10/2521 天前
2.3.12026/10/2323 天前
2.1.12026/10/091 个月前
0.4.02026/09/052 个月前

其他发布通道：rc → 0.1.0-rc-da73f37d68aa0996e6c9543d4c1e00d5412b05b5。

关于 @futuretea/tea-code 的常见问题

@futuretea/tea-code 是什么？

下Gen 代理的起点

如何安装 @futuretea/tea-code？

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

@futuretea/tea-code 支持 TypeScript 吗？

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

@futuretea/tea-code 支持 ESM 还是 CommonJS？

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

@futuretea/tea-code 需要什么版本的 Node.js？

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

@futuretea/tea-code 可以商用吗？

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

@futuretea/tea-code 的下载量有多少？

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

@futuretea/tea-code 还在维护吗？

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