快速安装
最快的入门方式 - 无需安装:
这将直接运行最新版本,无需永久安装任何内容。
安装方法
方法 1: NPX(推荐)
无需安装即可直接运行:
优势:
- 无需安装
- 始终使用最新版本
- 不占用磁盘空间
- 适合一次性或偶尔使用
用法:
# 运行最新版本
npx megallm@latest
# 运行特定版本
npx megallm@2.5.9
# 使用环境变量
NO_BANNER=1 npx megallm@latest
方法 2: 全局安装
安装一次,随时使用:
然后使用以下命令运行:
优势:
- 启动更快(已安装)
- 可离线工作(初次安装后)
- 命令更短
- 适合频繁使用
更新:
卸载:
方法 3: 本地项目安装
作为项目依赖安装:
npm install --save-dev megallm
package.json 脚本:
{
"scripts": {
"setup-megallm": "megallm"
}
}
- 具有标准化配置的团队项目
- 版本锁定安装
- CI/CD 流水线
系统要求
运行 MegaLLM CLI 需要 Node.js 18.0.0 或更高版本
使用 Homebrew:使用 nvm(推荐):curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18
支持的平台
| 平台 | 状态 | 备注 |
|---|
| macOS | 完全支持 | Intel 和 Apple Silicon |
| Linux | 完全支持 | 所有主流发行版 |
| Windows | 完全支持 | 原生和 WSL |
支持的 Shell
| Shell | 状态 | 平台 |
|---|
| bash | 完全支持 | 所有平台 |
| zsh | 完全支持 | macOS, Linux |
| fish | 完全支持 | macOS, Linux |
| PowerShell | 完全支持 | Windows |
# 检查 Node.js 版本
node --version
# 应显示: v18.0.0 或更高
# 检查 npm 版本
npm --version
# 应显示: 9.0.0 或更高
# 运行 CLI
npx megallm@latest --version
# 或如果全局安装:
megallm --version
macOS/Linux
CLI 需要对以下目录的写权限:
~/.claude/ - Claude Code 配置~/.codex/ - Codex 配置~/.config/opencode/ - OpenCode 配置~/.bashrc, ~/.zshrc 等 - Shell 配置文件
如果遇到权限错误:
# 修复所有权
sudo chown -R $USER ~/.claude ~/.codex ~/.config/opencode
# 修复权限
chmod -R 755 ~/.claude ~/.codex ~/.config/opencode
Windows
如果遇到权限问题,请以管理员身份运行终端。
AI 工具安装
如果缺少 AI 编程工具,CLI 可以自动安装。需要的权限:
# NPM 全局安装权限
npm install -g @anthropic-ai/claude-code
npm install -g @codeium/windsurf
npm install -g opencode
# 不全局安装,使用 npx
npx @anthropic-ai/claude-code
# macOS/Linux
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
安装故障排除
Node.js 未安装或不在您的 PATH 中。解决方案:
- 从 nodejs.org 安装 Node.js
- 重启终端
- 验证:
node --version
npm 未安装或版本过旧。解决方案:# 更新 npm
npm install -g npm@latest
# 或重新安装 Node.js
您没有安装全局包的权限。解决方案:# macOS/Linux - 配置 npm 使用不同目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
source ~/.profile
sudo(不推荐):sudo npm install -g megallm
您运行的是旧版本。解决方案:# 清除 npm 缓存
npm cache clean --force
# 更新到最新版本
npm update -g megallm
# 或使用 npx 运行最新版
npx megallm@latest
npm 无法连接到注册表。解决方案:# 检查 npm 注册表
npm config get registry
# 设置注册表
npm config set registry https://registry.npmjs.org/
# 如果在代理后面
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
高级安装
离线安装
对于无互联网访问的环境:
-
在联网机器上下载:
npm pack megallm
# 创建: megallm-2.5.9.tgz
-
将文件传输到离线机器
-
从 tarball 安装:
npm install -g ./megallm-2.5.9.tgz
CI/CD 安装
对于自动化环境:
- name: 设置 Node.js
uses: actions/setup-node@v3
with:
node-version: '18'
- name: 运行 MegaLLM CLI
run: npx megallm@latest
env:
NO_BANNER: '1'
Docker 安装
在 Dockerfile 中包含:
FROM node:18
# 全局安装 megallm
RUN npm install -g megallm
# 或使用 npx
RUN npx megallm@latest --version
# 运行时配置
CMD ["megallm"]
版本管理
检查当前版本
# 如果全局安装
megallm --version
# 使用 npx
npx megallm@latest --version
安装特定版本
# 全局安装特定版本
npm install -g megallm@2.5.9
# 使用 npx 运行特定版本
npx megallm@2.5.9
版本历史
查看所有可用版本:
npm view megallm versions
删除全局安装
删除配置文件
CLI 创建的配置文件在卸载后仍会保留:
# 删除所有 MegaLLM 配置
rm -rf ~/.claude/settings.json ~/.claude.json
rm -rf ~/.codex/config.toml
rm -rf ~/.config/opencode/opencode.json
# 删除环境变量
# 编辑您的 shell 配置 (~/.bashrc, ~/.zshrc 等)
# 并删除包含以下内容的行:
# ANTHROPIC_BASE_URL
# ANTHROPIC_API_KEY
# MEGALLM_API_KEY
完全清理
要完全删除所有痕迹:
# 卸载 CLI
npm uninstall -g megallm
# 删除配置文件
rm -rf ~/.claude ~/.codex ~/.config/opencode
# 删除项目级配置
rm -rf ./.claude ./opencode.json
# 清除 npm 缓存
npm cache clean --force
下一步
