常见问题

一般问题

什么是 MegaLLM CLI?

MegaLLM CLI 是一个交互式设置工具,用于配置 AI 编码助手(Claude Code、Codex/Windsurf 和 OpenCode)以使用 MegaLLM AI 服务。它自动化配置过程,安全管理 API 密钥,并在不同平台上提供无缝的设置体验。

支持哪些 AI 工具?

CLI 目前支持:

Claude Code - 系统级和项目级配置
Codex/Windsurf - 仅系统级配置
OpenCode - 系统级和项目级配置

未来版本可能会添加更多工具。

我需要安装 CLI 吗?

不需要!您可以使用 npx 直接运行它:

npx megallm@latest

但是,如果您愿意,也可以全局安装它:

npm install -g megallm

系统要求是什么?

Node.js: 18.0.0 或更高版本
操作系统: macOS、Linux 或 Windows
Shell: bash、zsh、fish 或 PowerShell

使用以下命令检查您的 Node.js 版本: node --version

安装和设置

如何获取 MegaLLM API 密钥?

访问 megallm.io/dashboard
注册或登录您的账户
导航到 API 密钥部分
点击”创建新 API 密钥”
复制您的 API 密钥(以 sk-mega- 开头)
安全保存 - 您将无法再次看到它

CLI 可以在设置过程中自动为您打开此页面。

系统级和项目级配置有什么区别?

系统级(全局):

应用于您机器上的所有项目
存储在您的主目录中(~/.claude/、~/.codex/ 等)
最适合个人开发环境
对单个开发者来说更容易管理

项目级(本地):

仅应用于当前项目目录
存储在项目文件夹中(./.claude/、./opencode.json 等)
最适合具有共享配置的团队项目
允许每个项目使用不同的 API 密钥
可以进行版本控制(不暴露 API 密钥)

重要: Codex/Windsurf 仅支持系统级配置。

如何配置多个工具?

运行 CLI 时,系统会询问您要配置哪个工具:

? 您想配置哪个工具?
  Claude Code
  Codex/Windsurf
  OpenCode
  配置全部  ← 选择此选项

选择”配置全部”将依次设置所有检测到的工具。或者,多次运行 CLI 并每次选择一个工具。

如果工具缺失,CLI 会安装它们吗?

是的!如果 CLI 检测到工具未安装,它将提供安装:

? Claude Code 未安装。您想安装它吗? (Y/n)

CLI 通过 NPM 将工具安装为全局包。

配置

配置文件存储在哪里?

Claude Code:

系统: ~/.claude/settings.json, ~/.claude.json
项目: ./.claude/settings.json 或 ./.claude/settings.local.json

Codex/Windsurf:

系统: ~/.codex/config.toml

OpenCode:

系统: ~/.config/opencode/opencode.json
项目: ./opencode.json

环境变量:

bash: ~/.bashrc
zsh: ~/.zshrc
fish: ~/.config/fish/config.fish
PowerShell: PowerShell 配置文件

如果我已经配置了 MegaLLM 怎么办?

CLI 将检测现有配置并询问您想做什么:

发现现有 MegaLLM 配置:
- ~/.claude/settings.json
- ~/.codex/config.toml

? 您想做什么?
  覆盖(删除旧配置,应用新配置)
  跳过(保留现有配置)
  取消

选择”覆盖”将:

创建备份文件(.backup 后缀)
删除旧配置
应用新配置

选择”跳过”将保留您的现有设置并退出。

如何更新我的 API 密钥?

只需再次运行 CLI 并在提示现有配置时选择”覆盖”:

npx megallm@latest

# 选择: 覆盖(删除旧配置,应用新配置)
# 输入您的新 API 密钥

CLI 将在应用新配置之前备份您的旧配置。

我可以为不同项目使用不同的 API 密钥吗?

可以!使用项目级配置:

# 项目 A
cd ~/projects/project-a
npx megallm@latest
# 选择: 项目级
# 输入项目 A 的 API 密钥

# 项目 B
cd ~/projects/project-b
npx megallm@latest
# 选择: 项目级
# 输入项目 B 的 API 密钥

每个项目将有自己的 .claude/settings.json 和自己的 API 密钥。

故障排除

CLI 说工具已安装但我找不到它

CLI 使用以下方法检查工具:

NPM 全局包列表
PATH 中的命令可用性
已知的安装目录

如果检测失败:

确保工具已全局安装: npm list -g --depth=0
检查命令是否可用: which claude-code 或 which codex
重启您的终端
尝试手动安装: npm install -g @anthropic-ai/claude-code

我收到'权限被拒绝'错误

这通常意味着您没有对配置目录的写入访问权限。macOS/Linux 修复:

# 修复配置目录的所有权
sudo chown -R $USER ~/.claude ~/.codex ~/.config/opencode

# 修复权限
chmod -R 755 ~/.claude ~/.codex ~/.config/opencode

Windows 修复:

以管理员身份运行您的终端
或者: 在文件资源管理器中修复权限 → 属性 → 安全

我的配置未被使用

检查 1: 环境变量

# Claude Code
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# Codex
echo $MEGALLM_API_KEY

如果为空,重新加载您的 shell:

source ~/.bashrc  # 或 ~/.zshrc
# 或重启您的终端

检查 2: 配置文件

# Claude Code
cat ~/.claude/settings.json

# Codex
cat ~/.codex/config.toml

验证文件存在并包含您的 API 密钥。检查 3: 文件权限

ls -la ~/.claude/settings.json
ls -la ~/.codex/config.toml

文件应该对您的用户可读。

我收到'无效的 API 密钥'错误

验证密钥格式: 应该以 sk-mega- 开头
检查拼写错误: 直接从仪表板复制粘贴密钥
修剪空白: 删除密钥前后的所有空格
密钥长度: 必须至少 20 个字符
重新生成: 在 megallm.io/dashboard 创建新的 API 密钥

测试您的 API 密钥:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://ai.megallm.io/v1/models

如何完全删除 MegaLLM 配置?

删除配置文件:

# Claude Code
rm -rf ~/.claude/settings.json ~/.claude.json

# Codex
rm -rf ~/.codex/config.toml

# OpenCode
rm -rf ~/.config/opencode/opencode.json

# 项目级
rm -rf ./.claude ./opencode.json

删除环境变量: 编辑您的 shell 配置文件(~/.bashrc、~/.zshrc 等)并删除这些行:

export ANTHROPIC_BASE_URL="https://ai.megallm.io"
export ANTHROPIC_API_KEY="sk-mega-..."
export MEGALLM_API_KEY="sk-mega-..."

然后重新加载: source ~/.bashrc 或重启终端。

我可以详细查看 CLI 正在做什么吗?

可以!在调试模式下运行:

DEBUG=* npx megallm@latest

这将显示以下详细日志:

系统检测
工具检测
文件操作
配置更改
错误堆栈跟踪

高级用法

我可以在 CI/CD 流水线中使用 CLI 吗?

可以,但在 CI/CD 环境中最好手动配置:

# GitHub Actions 示例
- name: Configure MegaLLM
  env:
    ANTHROPIC_API_KEY: ${{ secrets.MEGALLM_API_KEY }}
  run: |
    mkdir -p .claude
    echo '{"env":{"ANTHROPIC_BASE_URL":"https://ai.megallm.io","ANTHROPIC_API_KEY":"'$ANTHROPIC_API_KEY'"}}' > .claude/settings.json

这避免了交互式提示,在自动化环境中更可靠。

如何在 Docker 容器中配置 MegaLLM?

在 Docker 构建期间添加配置:

FROM node:18

# 设置环境变量
ENV ANTHROPIC_BASE_URL=https://ai.megallm.io
ENV ANTHROPIC_API_KEY=your-key-here

# 或复制配置文件
COPY .claude/settings.json /root/.claude/settings.json

WORKDIR /app
COPY . .
RUN npm install
CMD ["npm", "start"]

或在运行时传递 API 密钥:

docker run -e ANTHROPIC_API_KEY=sk-mega-... myimage

我可以对配置进行版本控制吗?

可以,但要小心:应该提交:

不包含 API 密钥的项目级配置
仅包含 ANTHROPIC_BASE_URL 的 .claude/settings.json
团队成员的文档

不应该提交:

API 密钥
.claude/settings.local.json
个人环境变量

用于版本控制的 .claude/settings.json 示例:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io"
  }
}

添加到 .gitignore:

.claude/settings.local.json
.claude.json

团队成员添加自己的 API 密钥:

# .claude/settings.local.json (未提交)
{
  "env": {
    "ANTHROPIC_API_KEY": "sk-mega-personal-key"
  }
}

我可以为每个工具使用不同的模型吗?

可以!每个工具的配置文件允许您指定模型。Claude Code (~/.claude/settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.megallm.io",
    "ANTHROPIC_API_KEY": "sk-mega-...",
    "ANTHROPIC_MODEL": "claude-opus-4-1-20250805"
  }
}

Codex (~/.codex/config.toml):

model = "gpt-5"  # 更改为任何支持的模型

OpenCode (~/.config/opencode/opencode.json):

{
  "model": "gemini-2.5-pro"
}

查看模型目录了解可用模型。

我的备份会发生什么?

CLI 在修改配置之前会创建备份文件:

~/.claude/settings.json.backup
~/.codex/config.toml.backup
~/.config/opencode/opencode.json.backup

备份使用 .backup 后缀创建,包含您之前的配置。从备份恢复:

mv ~/.claude/settings.json.backup ~/.claude/settings.json

如果不需要,您可以手动删除备份:

rm ~/.claude/*.backup ~/.codex/*.backup

获取帮助

我可以在哪里获得支持?

文档:

主文档: docs.megallm.io
API 参考: docs.megallm.io/api

支持渠道:

电子邮件: support@megallm.io
GitHub Issues: github.com/Megallm/megallm-npm/issues
Discord: discord.gg/devsindia

社区:

Twitter/X: @megallmio
YouTube: youtube.com/@Megallmio

如何报告错误?

检查现有问题: github.com/Megallm/megallm-npm/issues
如果未找到,创建一个新问题,包含:
- CLI 版本: npx megallm@latest --version
- Node.js 版本: node --version
- 操作系统
- Shell 类型
- 错误消息/日志(使用 DEBUG=* 运行)
- 重现步骤

如何请求功能?

在 GitHub 上打开功能请求: github.com/Megallm/megallm-npm/issues/new包括:

功能描述
用例/为什么需要它
任何相关的示例或模型

还有问题?

找不到您的答案?我们随时为您提供帮助!

电子邮件支持

从我们的支持团队获得帮助

GitHub Issues

报告错误或请求功能

Discord 社区

与社区聊天

文档

浏览完整文档

快速入门

配置

指南

一般问题

安装和设置

配置

故障排除

高级用法

获取帮助

还有问题?

电子邮件支持

GitHub Issues

Discord 社区

文档

快速入门

配置

指南

​一般问题

​安装和设置

​配置

​故障排除

​高级用法

​获取帮助

​还有问题?

电子邮件支持

GitHub Issues

Discord 社区

文档

一般问题

安装和设置

配置

故障排除

高级用法

获取帮助

还有问题?