Mastra Code

Mastra Code：终端驱动的智能 AI 编程代理全攻略

在现代软件开发领域，集成 AI 能力已成为提升效率的关键。Mastra Code 是一款基于终端（TUI）的 AI 编程代理，它建立在 Mastra 的 Harness、Agent 和 Memory 原语之上，旨在通过命令行界面为开发者提供深度的代码辅助功能。

What's Mastra Code

Mastra Code 是一个强大的终端 AI 编程助手，它能够直接连接到超过 70 种 AI 模型。作为一个运行在终端的智能代理，Mastra Code 不仅能理解你的指令，还能直接访问你的本地文件系统，执行代码阅读、搜索、编辑以及 Shell 命令。其核心架构由 TUI 界面、Harness 管理层、Mastra Agent 执行层以及 LibSQL 存储层组成，确保了高效的线程持久化和状态管理。

Mastra Code 的核心特性 (Features)

1. 多样化的运行模式

Mastra Code 提供了三种针对不同场景优化的模式：

• Build 模式：用于实际的编码实现和项目构建。
• Plan 模式：专注于架构分析，在编写代码前创建详细的实现计划。
• Fast 模式：以极低的延迟提供简短回答和微小编辑。

2. 强大的内置工具箱

Mastra Code 集成了多种实用工具，覆盖了开发的方方面面：

• 文件操作：支持文件查看和直接编辑。
• 搜索功能：强大的代码搜索与 Web 搜索能力。
• 系统集成：可执行 Shell 命令并管理 Git。

3. 高度可定制化与扩展性

• 配置管理：支持项目作用域的线程、MCP 服务器、钩子（Hooks）和自定义命令。
• 程序化扩展：开发者可以通过自定义模式、工具、子代理（Subagents）和存储方案来扩展 Mastra Code 的功能。

4. 跨模型工作流

支持在对话中途切换 AI 模型，方便开发者对比不同 AI 提供商（如 Anthropic 或 OpenAI）的响应质量。

如何使用 Mastra Code (How to Use)

环境准备

使用 Mastra Code 之前，请确保您的系统中已安装 Node.js 22.13.0 或更高版本。

安装步骤

您可以选择全局安装或使用 npx 直接运行：

• 使用 npm 安装： npm install -g mastracode
• 或使用 npx 运行： npx mastracode

快速上手指南

1. 启动程序：进入您的项目目录并运行命令：

   cd your-project
   mastracode
   

2. 身份验证：设置 API 密钥（例如 export ANTHROPIC_API_KEY=...）或运行 /login 通过 OAuth 认证。
3. 交互开发：在终端输入消息，Mastra Code 会以流式文本响应，并根据需要读取、编辑或运行代码。

常用快捷键

• Ctrl+C：中断当前操作。
• Ctrl+D：当编辑器为空时退出。
• Ctrl+T：切换“思考块”（Thinking blocks）的可见性。
• Ctrl+E：展开或折叠所有工具输出。
• Ctrl+F：在代理运行时发送后续消息。

应用场景 (Use Case)

• 日常编码辅助：针对代码库提问、进行代码编辑、运行测试脚本以及管理 Git 提交。
• 深度代码探索：利用 Plan 模式分析复杂的系统架构，在动手前理清逻辑。
• 快速信息查询：在 Fast 模式下快速获取编程知识或进行简单的代码微调。
• 模型效能对比：在同一对话中切换不同模型，评估各 AI 模型在特定任务下的表现。

常见问题解答 (FAQ)

Q: Mastra Code 运行需要什么环境？ A: 需要 Node.js 版本 22.13.0 或以上。

Q: 如何切换不同的 AI 模型？ A: 您可以在终端中使用 /models 斜杠命令来选择不同的 AI 模型。

Q: 如何查看当前会话的消耗情况？ A: 使用 /cost 命令可以显示当前对话的 Token 使用量及相关费用。

Q: 我可以自定义快捷命令吗？ A: 是的，Mastra Code 允许您将 Markdown 文件定义为自定义斜杠命令，具体可参考配置文档。

Q: Mastra Code 如何保存我的对话记录？ A: 它使用 LibSQL 存储层进行线程持久化、消息历史记录和观察性内存的管理。