使用说明
mensa cli
Claude AI强大的基于终端的聊天界面，使用Bun、React和Ink构建。由 Claude代理SDK 获得具有完整工具使用功能的代理体验。
想想克劳德代码，但在你的终端上有一个干净的TUI。
✨ 亮点
- 🤖 AI 代理 -Claude可以读/写文件、运行命令、搜索网络等
- 💬 会话管理 -跨终端会话继续对话
- 🔌 MCP支持 -连接到模型上下文协议服务器以扩展功能
- 💰 预算控制 -设定支出限额以管理成本
- ↩️ 撤消支持 -还原Claude所做的文件更改
- 🎨 美丽的TUI -Markdown渲染、语法高亮显示和精美的界面
📋 目录
安装
先决条件
来自npm
bun install -g mensa-cli
来源
git clone https://github.com/FujiwaraChoki/mensa-cli.git
cd mensa-cli
bun install
bun run build
bun link
快速开始
-
验证 -确保您已登录 克劳德代码.mensa使用相同的身份验证。
-
启动mensa：
mensa -
首次运行 -您将在选型过程中得到指导（建议使用Sonnet 4.5）。
-
开始聊天！ 键入您的信息，然后按Enter键。
特性
代理工具
mensa为Claude提供了强大的工具：
| 工具 | 说明 |
|---|---|
| 读/写/编辑 | 支持撤消的文件操作 |
| Bash | 执行shell命令 |
| 全球/全球 | 搜索文件和内容 |
| WebFetch/WebSearch | 浏览网页 |
| TodoWrite | 跟踪任务 |
会话管理
无缝地继续之前的对话：
mensa # Start new session
mensa --continue # Resume most recent session
mensa -c # Short form
mensa --resume <id> # Resume specific session by ID
撤消支持
犯了一个错误？使用 /undo 还原上次助理响应中的文件更改。状态栏显示何时可以撤消。
MCP集成
连接到 模型上下文协议 用于扩展功能的服务器：
# Add a filesystem MCP server
mensa mcp add fs --command "npx" --args "@modelcontextprotocol/server-filesystem ."
# Add a remote HTTP MCP server
mensa mcp add api --url "https://api.example.com/mcp" --type http
# List configured servers
mensa mcp list
查看完整 MCP文件 了解更多详情。
预算限额
设定支出限额以控制成本：
mensa budget set 5.00 # Set $5 limit
mensa budget show # View current limit
mensa budget clear # Remove limit
状态栏显示您当前的支出与预算限制。
斜杠命令
类型 / 在聊天中查看可用命令：
| 命令 | 描述 |
|---|---|
/config |
打开设置（更改型号） |
/mcp |
管理MCP服务器 |
/undo |
还原文件更改 |
/help |
显示帮助 |
配置
配置存储在 ~/.mensa/config.json:
{
"model": "claude-sonnet-4-5-20250929",
"createdAt": "2024-01-01T00:00:00.000Z",
"mcpServers": {},
"maxBudgetUsd": 10.00,
"lastSessionId": "session-uuid"
}
可用模型
使用 /config 或 /settings 在应用程序中更改模型：
| 型号 | 最适合 |
|---|---|
| 克劳德·十四行诗4.5 | 推荐用于大多数任务 |
| Claude Opus 4.5 | 复杂的推理任务 |
| Claude Haiku 4.5 | 快速、简单的任务 |
键盘快捷键
| 快捷方式 | 操作 |
|---|---|
Enter |
提交消息 |
Ctrl+C |
中断当前操作 |
Backspace |
删除字符 |
Option+Backspace |
删除单词 |
Cmd+Backspace |
删除行 |
Tab |
完整斜线命令 |
Up/Down |
浏览建议 |
文档
发展
本地运行
# Install dependencies
bun install
# Run in development mode
bun run dev
# Build the binary
bun run build
项目结构
mensa-cli/
├── src/
│ ├── index.tsx # Entry point
│ ├── App.tsx # Main app component
│ ├── components/ # React/Ink components
│ ├── hooks/ # Custom React hooks
│ ├── screens/ # Screen components
│ ├── utils/ # Utility functions
│ └── types.ts # TypeScript types
├── docs/ # Documentation
└── dist/ # Compiled binary
贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
故障排除
身份验证问题
mensa使用您的Claude Code身份验证。请确保您已登录：
- 安装 克劳德代码 如果你还没有
- 在Claude Code中完成身份验证流程
- 试着跑步
mensa再次
会话未恢复
会话存储在本地 ~/.mensa/。如果清除此目录，会话历史记录将丢失。
MCP服务器未连接
- 检查服务器是否已配置：
mensa mcp list - 验证命令/URL是否正确
- 如果需要，请检查身份验证标头
- 看 MCP文件 详细故障排除
