企业官网建设流程全解析

momo-code 是一款"会陪你成长"的 AI 编程智能体（AI coding agent），而配置 API Key是驱动它的第一步。只要填好一个 Key，momo-code 就能接入 OpenAI、Anthropic、智谱、通义、Kimi、MiniMax 等 25+ 家大模型服务商中的任选一家，立刻帮你写代码、改 Bug、跑测试。本文带你 3 分钟完成 momo-code API Key 配置，并讲透服务商专用 Key、模型档位（Tier）和自定义接口三种玩法。

先认识一下：momo-code 靠什么"驱动"大模型

momo-code 采用分层架构，最底层的LLM Provider Hub统一封装了 25+ 家大模型服务商与自定义接口。你只需把 API Key 交给它，剩下的鉴权、模型路由、流式输出都由框架自动完成——这是 momo-code 配置 API Key 唯一的门槛。

架构图中最下面一层（Infrastructure Layer）就是本文的主角LLM Provider Hub (25+ Providers & Custom)，它把各家服务商的鉴权细节收拢到同一个入口。

想先了解整体设计，可阅读项目说明 README.md。

方式一：通用 API Key（最省事，新手首选）

如果你手里是一把"通用 Key"（尤其是 OpenAI 兼容接口的 Key），一行命令即可：

export MOMO_API_KEY=sk-你的API密钥

momo-code 会把MOMO_API_KEY作为兜底密钥：当你没为某家服务商单独配 Key 时，它会自动顶上。这条认证优先级逻辑可参见 auth.ts。

方式二：服务商专用 API Key（最精准）

想明确用某一家的模型，就填对应专用变量。规则很简单：MOMO_+ 服务商名 +_API_KEY：

export MOMO_ANTHROPIC_API_KEY=sk-ant-你的Anthropic密钥 export MOMO_OPENAI_API_KEY=sk-你的OpenAI密钥 export MOMO_MINIMAX_API_KEY=sk-你的MiniMax密钥

专用 Key 优先级最高——填了哪家、就用哪家，互不干扰。完整变量清单定义在 env.ts。

momo-code 支持的大模型服务商一览

下表是 momo-code 内置支持的服务商与对应环境变量，任选其一配置即可驱动：

国内模型如 DeepSeek 等采用OpenAI 兼容协议接入，直接用下文"自定义接入"的custom服务商即可；其余各家都有上表对应的专用变量。完整服务商工厂见 provider.ts。

方式三：写入配置文件（适合多项目/团队）

不想每次export？把 Key 写进~/.momo/momo.jsonc即可，文件支持注释、改完即生效：

{ "model": "standard", "provider": "anthropic", "providers": { "anthropic": { "apiKey": "sk-ant-你的密钥" } } }

配置文件还能为每个服务商单独指定apiKey、baseUrl、defaultModel甚至headers（不填则用内置默认值），灵活性最高。配置加载逻辑见 config.ts。

指定服务商与模型档位（Tier）

配好 Key 后，再告诉 momo-code"用哪家、用哪个档"：

export MOMO_PROVIDER=anthropic # 指定服务商：openai / anthropic / zhipu / minimax ... export MOMO_MODEL=standard # 指定模型档位

momo-code 提供三档模型（Tier）零配置选择，会自动挑当前可用、最合适的模型：

也可以只设MOMO_MODEL不设服务商——momo-code 会按 Tier 顺序，自动挑到第一个"有 Key"的模型。

进阶：接入任意 OpenAI 兼容接口

如果你有自建网关或私有部署（vLLM、DeepSeek 官方、公司内网等），用custom服务商即可三件套搞定：

export MOMO_PROVIDER=custom export MOMO_CUSTOM_BASE_URL=https://你的接口地址/v1 export MOMO_CUSTOM_API_KEY=sk-你的密钥 export MOMO_CUSTOM_MODEL=你的模型名

一行配置，接入任何兼容 OpenAI 协议的接口。

让配置永久生效

export只对当前终端有效。想一劳永逸，把配置追加到~/.zshrc（macOS）或~/.bashrc（Linux）：

# momo-code 配置 export MOMO_API_KEY=sk-你的API密钥 export MOMO_PROVIDER=openai export MOMO_MODEL=standard

保存后执行source ~/.zshrc（或新开一个终端），再验证：

momo --version momo "写一个快速排序"

看到正常回复，说明 API Key 已生效 ✅

常见问题排查

Q：提示No API key configured/No API key found for provider说明没找到任何 Key。至少设置MOMO_API_KEY或对应服务商的专用 Key 之一：

export MOMO_API_KEY=sk-你的密钥

Q：认证到底先看哪个 Key？优先级从高到低：服务商专用环境变量 → 配置文件providers→ 通用MOMO_API_KEY。详见 auth.ts。

Q：momo models providers没看到我配的 Key？先确认变量名拼写正确（MOMO_前缀不能少），再source一下配置后重试。

Q：想从 Claude Code 迁移？momo-code 默认继承~/.claude/的配置、MCP 与提示词，几乎零成本迁移，见 USER_GUIDE.md。

小结

记住一句话：25+ 服务商任选其一，填对 Key，momo --version一验证，momo-code 就能立刻开工。更多命令参考 INSTALL.md 与 README.md。