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

@futuretea/tea-code

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

The Starting Point for Next-Gen Agents

原始使用文档
中文原文
文档目录7 节
  1. What is Tea Code CLI
  2. Install
  3. Quick Start
  4. Key Features
  5. Documentation
  6. Repository & Issues
  7. License

@futuretea/tea-code

The Starting Point for Next-Gen Agents

npm License Docs

What is Tea Code CLI

Tea Code CLI is an AI coding agent that runs in your terminal. It can read and edit code, run shell commands, search files, fetch web pages, and choose the next step based on the feedback it receives. It works out of the box with Moonshot AI's Kimi models and can also be configured to use other compatible providers.

Install

Tea Code CLI requires Node.js 22.19.0 or later. Install it with npm:

npm install -g @futuretea/tea-code

Or with pnpm:

pnpm add -g @futuretea/tea-code

On Windows, install Git for Windows before first launch because Tea Code CLI uses the bundled Git Bash as its shell environment. If Git Bash is installed in a custom location, set KIMI_SHELL_PATH to the absolute path of bash.exe.

Then, run it with a new shell session:

tea-code --version

For upgrade and uninstall instructions, see Getting started.

Quick Start

Open a project and start the interactive UI:

cd your-project
tea-code

On first launch, run /login inside Tea Code CLI and choose either Kimi Code OAuth or a Kimi Platform API key. After login, try a first task:

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

Key Features

  • npm distribution. Install and update with npm or pnpm using the independent @futuretea/tea-code package.
  • Blazing-fast startup. The TUI is ready in milliseconds, so opening a session never feels heavy.
  • Polished TUI. A carefully tuned interface designed for long, focused agent sessions.
  • Video input. Drop a screen recording or demo clip into the chat — let the agent watch instead of typing out what's hard to describe in words.
  • AI-native MCP configuration. Add, edit, and authenticate Model Context Protocol servers conversationally via /mcp-config — no hand-editing JSON.
  • Subagents for focused, parallel work. Dispatch built-in coder, explore, and plan subagents in isolated context windows; the main conversation stays clean.
  • Lifecycle hooks. Run local commands at key points — gate risky tool calls, audit decisions, fire desktop notifications, wire into your own automation.

Documentation

Repository & Issues

License

MIT

版本与发布记录

@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 是什么？

The Starting Point for Next-Gen Agents

如何安装 @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 和提交记录判断。