easy-agent

环境要求

• Node.js 22 或更高版本
• npm 包管理器
• 至少一个受支持模型提供商的凭据（Anthropic / OpenAI 兼容 / Gemini / 本地模型）
• 可选：macOS 或 Linux 环境可使用官方安装脚本（脚本本身不安装 Node.js）

安装与启动步骤

1. 1全局安装 eagent

   通过 npm 全局安装 eagent 包，--ignore-scripts 会跳过包的生命周期脚本，安装后同时提供 eagent 和 easy-agent 两个命令。

   npm install -g --ignore-scripts eagent

   复制

2. 2确认安装成功

   运行版本命令，能打印出版本号说明可执行文件已进入 PATH；若提示找不到命令，检查 npm 全局 bin 目录是否在 PATH 中。

   eagent --version

   复制

3. 3临时免安装试用

   不想全局安装时可用 npx 直接拉取最新版本运行，适合快速体验；正式使用仍建议全局安装。

   npx --yes eagent@latest

   复制

4. 4或用官方安装脚本

   macOS/Linux 上可执行安装脚本，它会检查 Node.js、以 --ignore-scripts 方式安装同一个 npm 包并验证 eagent 是否在 PATH 上。

   curl -fsSL https://raw.githubusercontent.com/ConardLi/easy-agent/main/install.sh | sh

   复制

5. 5设置模型凭据

   使用原生 Anthropic 模型时只需设置环境变量即可，token 替换为你自己的真实凭据；可选再用 ANTHROPIC_MODEL 指定默认模型名。

   export ANTHROPIC_AUTH_TOKEN="your-token"
   export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

   复制

6. 6进入项目并启动

   切换到你的代码仓库目录后直接运行 eagent 进入交互式 REPL；首次在该目录使用时会询问是否信任此文件夹，信任后才应用项目级配置。

   cd your-project
   eagent

   复制

7. 7命令行无头调用

   把任务作为 prompt 传入即可无头执行，适合放进 CI 或 shell 脚本；加 --output-format json 可输出机器可读结果，也可用管道传入内容。

   eagent -p "summarize this repo" --output-format json
   git diff | eagent -p "review this patch"

   复制

8. 8配置多模型档案

   在 settings.json 中定义命名模型档案，支持 openai-chat、gemini 等协议与本地模型地址，之后用 --model 或 REPL 内 /model 切换。

   {
     "defaultModel": "gpt",
     "models": {
       "gpt": {
         "protocol": "openai-chat",
         "model": "gpt-5.1",
         "baseURL": "https://api.openai.com/v1",
         "apiKey": "${OPENAI_API_KEY}"
       },
       "gemini": {
         "protocol": "gemini",
         "model": "gemini-2.5-pro",
         "apiKey": "${GEMINI_API_KEY}"
       },
       "ollama": {
         "protocol": "openai-chat",
         "model": "qwen2.5-coder",
         "baseURL": "http://localhost:11434/v1"
       }
     }
   }

   复制

关键配置

如何确认成功

运行 eagent --version 能打印版本号；进入 REPL 后执行 /doctor 和 /config list 可检查配置与运行时健康状态。

常见问题

注意事项

• 安装命令带有 --ignore-scripts，不会执行包的安装脚本，属于项目有意设计的安全行为。
• 凭据建议通过环境变量注入，配置里可用 ${OPENAI_API_KEY} 这类占位符引用，不要在 settings.json 中硬编码明文密钥。
• 在 REPL 中可用 Ctrl+D 退出，输入 /help 查看全部命令与快捷键。
• 除 Anthropic 外还支持 OpenAI 兼容接口、Gemini 与本地模型，模型层不绑定单一厂商。