开始之前，您需要准备
一台电脑
Windows、Mac 或 Linux 都可以
网络连接
需要能访问 AI 服务（如 Claude 或 GPT）
AI 服务账户
需要注册 Claude 或 OpenAI 账户并获取 API 密钥（后面会教您）
安装准备（安装 Node.js）
Minto 需要 Node.js 来运行。Node.js 是一个免费的程序运行环境，就像让程序跑起来的"发动机"。
检查是否已安装
打开终端（见下方说明），输入以下命令：
node --version- 如果显示
v20.x.x或更高版本 → 已安装，跳到第2步 - 如果显示"命令未找到"或版本低于 20 → 请继续安装
如何打开终端？
🍎 Mac
按 Command + 空格，输入"终端"，回车打开
🪟 Windows
按 Windows 键，输入"PowerShell"，回车打开
🐧 Linux
按 Ctrl + Alt + T 打开终端
安装 Node.js
- 访问 nodejs.org
- 点击下载 LTS 版本（长期支持版，更稳定）
- 运行下载的安装程序，一路点"下一步"即可
- 安装完成后，关闭并重新打开终端，再次运行
node --version确认安装成功
安装 Minto
在终端中输入以下命令（直接复制粘贴即可）：
npm install -g @within-7/minto等待安装完成（通常需要 1-2 分钟）。看到类似这样的输出表示成功：
added 150 packages in 45s
验证安装
minto --version显示版本号（如 0.3.6）表示安装成功！
可以在命令前加上
sudo：
sudo npm install -g @within-7/minto一键配置
Minto 支持通过配置链接一键导入团队预设的 AI 模型和工具配置，无需手动设置密钥。
运行配置命令
在终端中输入以下命令（将链接替换为团队提供的实际配置链接）：
minto setup --from https://your-team.com/minto-config.json配置命令会自动完成：
- ✅ 添加 AI 模型配置（Claude、GPT 等）
- ✅ 配置 MCP 工具服务器
- ✅ 安装团队自定义 Agent
- ✅ 应用推荐的系统设置
看到类似以下输出表示配置成功：
✓ Configuration applied successfully! • Added 3 model profiles • Added 2 MCP servers • Installed 2 agents Run "minto" to start using your configured setup.
如果您是个人用户或需要手动配置，请参阅页面底部的手动配置密钥章节。
开始使用！
配置完成！现在让我们启动 Minto：
minto您将看到欢迎界面：
◆ Minto v0.3.6 - Strategic AI · Global Excellence ❯
现在，直接用中文输入您的需求：
❯ 帮我分析一下中国咖啡市场的现状
◐ WebSearch(中国咖啡市场 2024)…
✓ WebSearch(中国咖啡市场 2024)
⎿ 找到 15 条相关结果
● 中国咖啡市场分析
• 市场规模：约1,800亿元 (2024年)
• 年均增长率：15%+
• 核心趋势：连锁扩张、精品咖啡、即饮增长
• 竞争格局：瑞幸 | 星巴克 | Manner | 库迪
🎉 恭喜！您已经成功使用 Minto 了！
试试这些任务
以下是一些您可以立即尝试的任务示例：
📊 市场研究
"分析美国宠物食品市场的规模、趋势和主要玩家"
📝 内容创作
"帮我写一封邀请客户参加新品发布会的邮件"
📈 数据分析
"分析这份销售数据，找出增长机会"
（可以把数据文件放在当前目录）
💡 战略规划
"帮我制定一个进入东南亚市场的战略方案"
🔍 竞品分析
"对比分析苹果和华为手机的市场定位和竞争策略"
📄 报告撰写
"帮我写一份Q3季度业务总结报告"
常用命令速查
在 Minto 中，您可以使用以下命令（以 / 开头）：
| 命令 | 作用 | 示例 |
|---|---|---|
/help |
显示帮助信息 | /help |
/models |
查看可用的 AI 模型 | /models |
/model |
切换到指定模型 | /model gpt-4-turbo |
/clear |
清空当前对话，重新开始 | /clear |
/compact |
压缩对话历史（对话太长时使用） | /compact |
/exit |
退出 Minto | /exit |
使用技巧
🎯 描述要具体
越具体的需求，结果越好。比如"分析美国25-35岁女性的护肤品消费趋势"比"分析护肤品市场"更好。
📂 利用文件
可以让 Minto 读取本地文件。只需说"分析当前目录下的 sales.xlsx"，它会自动读取并分析。
💾 保存结果
让 Minto 直接保存分析结果："把分析报告保存到 report.md"。
🔄 追问细化
可以基于上一个回答继续追问："能详细展开第二点吗？"或"再加上中国市场的对比"。
🧹 及时清理
开始新话题前用 /clear 清空历史，避免上下文混淆。
⚡ 选对模型
复杂分析用 Claude Opus，日常任务用 Sonnet，简单问答用 Haiku（更快更省钱）。
手动配置密钥
如果您没有团队配置链接，可以按照以下步骤手动配置 AI 密钥。
获取 AI 密钥
Minto 需要连接 AI 服务来工作。您需要获取一个 API 密钥（类似"通行证"）。
获取 Claude API 密钥（推荐）
- 访问 console.anthropic.com
- 点击 Sign Up 注册账户（已有账户直接登录）
- 完成注册后，进入 API Keys 页面
- 点击 Create Key 创建新密钥
- 复制生成的密钥（以
sk-ant-开头的字符串）
或者使用 OpenAI (GPT-4)
- 访问 platform.openai.com/api-keys
- 登录或注册 OpenAI 账户
- 点击 Create new secret key
- 复制生成的密钥（以
sk-开头）
配置密钥
将您的 API 密钥配置到系统中。根据您的操作系统选择相应方法：
🍎 Mac / 🐧 Linux
在终端中输入（将 你的密钥 替换为实际密钥）：
export ANTHROPIC_API_KEY=sk-ant-你的密钥让配置永久生效（推荐）：
echo 'export ANTHROPIC_API_KEY=sk-ant-你的密钥' >> ~/.zshrc然后重新打开终端，或运行 source ~/.zshrc
🪟 Windows (PowerShell)
$env:ANTHROPIC_API_KEY="sk-ant-你的密钥"让配置永久生效：
- 在开始菜单搜索"环境变量"
- 点击"编辑系统环境变量"
- 点击"环境变量"按钮
- 在"用户变量"中点击"新建"
- 变量名填
ANTHROPIC_API_KEY，变量值填您的密钥 - 确定保存，重新打开 PowerShell
ANTHROPIC_API_KEY 替换为 OPENAI_API_KEY，密钥换成您的 OpenAI 密钥即可。
关于费用
Claude API 按使用量收费：
- 新用户通常有免费额度可以试用
- 正常使用每月约 $5-20（取决于使用频率）
- 可以在 Anthropic Console 设置消费上限
遇到问题？
❌ "command not found: minto"
原因：Minto 没有正确安装，或 PATH 没有配置好。
解决：重新运行安装命令，如果还是不行，尝试关闭终端重新打开。
❌ "API key not found" 或 "unauthorized"
原因：API 密钥没有配置或配置错误。
解决：
- 如果有团队配置链接：运行
minto setup --from <配置链接> - 如果手动配置：检查密钥是否正确设置。运行
echo $ANTHROPIC_API_KEY（Mac/Linux）或echo $env:ANTHROPIC_API_KEY（Windows）查看。
❌ 响应很慢
原因：网络问题或请求的任务比较复杂。
解决：检查网络连接，或尝试更简单的任务。复杂分析需要更多时间是正常的。
❌ 对话太长导致错误
原因：对话历史超过了模型的上下文限制。
解决：使用 /compact 压缩对话，或 /clear 清空重新开始。
还有问题？
查看完整 FAQ