MoeRouter 文档 获取 API Key

用 AstrLink 接入 MoeRouter

在 AstrLink 里把 MoeRouter 添加为 New API 类型的提供商,用本地令牌连接 Claude Code、Codex 和 Gemini CLI,并查看每次请求的记录。

更新于 2026-11-14 阅读约 2 分钟 实测:AstrLink 0.2.27 · macOS

本页目录
  1. 安装与首次打开
  2. 添加 MoeRouter
  3. 访问令牌与客户端地址
  4. 手动连接 AstrLink
  5. 查看请求记录
  6. 撤回

AstrLink 由 New API 的作者 Calcium-Ion 开发,是一个本地网关:在电脑上开一个本地 API,管理上游 API 提供商、本地访问令牌、请求记录、隐私保护和故障转移。

AstrLink 需要常驻后台。只用一两个工具时,CC Switch 或手动配置更简单。

安装与首次打开#

从 GitHub Releases 下载 macOS 版本(Apple 芯片选 AstrLink_0.2.27_aarch64.dmg)。首次打开进入“开始使用 AstrLink”向导,左下角显示 网关 已就绪。

AstrLink 的上手向导
三步:接入 API 提供商、确认访问令牌、连接客户端。

添加 MoeRouter#

  1. 点 添加 API 提供商,在“外部网关”里选 New API。MoeRouter 基于 New API,选这一项会自动启用全部兼容协议。

    选择提供商类型
    注意“保存后无法更改类型”。
  2. 在“连接”页填写:

    • API 提供商名称:MoeRouter
    • API 地址:https://moerouter.com(根地址,不加 /v1)
    • API Key:MoeRouter Key
    填写连接信息
    “信任此提供商”保持关闭:开启后,发往它的请求不再经过 AstrLink 的隐私检查。
  3. 切到 入口协议 页确认:OpenAI Responses、Anthropic Messages、Gemini Generate Content、Chat Completions 都是“原样转发”。

    入口协议都是原样转发
    每个协议下面标出了用它的客户端。

    上游支持某个协议时选原样转发;只有上游只支持 Chat 时才需要转换,而转换会丢掉 Codex 的专用工具(例如 apply_patch)。MoeRouter 支持全部这些协议,保持原样转发即可。

  4. 点 保存 API 提供商。保存时 AstrLink 会从 MoeRouter 拉取模型列表,卡片上还会显示这个 Key 的剩余额度。

    提供商已添加,卡片上显示剩余额度
    额度按美元换算显示,实际以 MoeRouter 控制台为准。

访问令牌与客户端地址#

左侧的 令牌 页有一个自动创建的“默认令牌”(以 astr_ 开头),上方显示本地 API 地址 http://localhost:18317。旧版本是 8317,以界面显示为准。

AstrLink 的访问令牌页

客户端连接 AstrLink 用的是这个 astr_… 令牌,不是 MoeRouter Key。可以给每个客户端单独建一个令牌,方便分别统计。

点令牌右侧的 配置客户端,勾选要写入的客户端,AstrLink 会自动改写它们的配置文件:

配置客户端的对话框
点“写入配置”前,先确认没有别的工具在管理同一个客户端。

不想让 AstrLink 改配置文件时,可以临时用环境变量指过去:

客户端 地址 密钥
Claude Code http://localhost:18317 AstrLink 令牌,放在 ANTHROPIC_AUTH_TOKEN
Codex http://localhost:18317/v1 AstrLink 令牌
Gemini CLI http://localhost:18317 AstrLink 令牌,放在 GEMINI_API_KEY
printf 'AstrLink 访问令牌: '; read -rs ASTR_TOKEN; printf '\n'
ANTHROPIC_BASE_URL=http://localhost:18317 ANTHROPIC_AUTH_TOKEN="$ASTR_TOKEN" \
  claude --model claude-sonnet-5-5 -p "只回复 OK"
GOOGLE_GEMINI_BASE_URL=http://localhost:18317 GEMINI_API_KEY="$ASTR_TOKEN" \
  gemini --skip-trust -m gemini-4-argon -p "只回复 OK"
Claude Code 和 Gemini CLI 经 AstrLink 返回 OK
两条命令都返回了 OK。
export ASTR_TOKEN
codex exec --skip-git-repo-check \
  -c model_provider=astrlink -c model=gpt-6.1-sol \
  -c model_providers.astrlink.name=AstrLink \
  -c model_providers.astrlink.base_url=http://localhost:18317/v1 \
  -c model_providers.astrlink.wire_api=responses \
  -c model_providers.astrlink.env_key=ASTR_TOKEN \
  "只回复 OK,不要运行命令"
Codex 经 AstrLink 返回 OK
provider: astrlink。长期使用时,把这些 -c 参数写进 ~/.codex/config.toml,格式和 Codex 教程里的一样。

查看请求记录#

左侧的 请求 页实时显示每一次调用:客户端、入口协议、走的提供商、模型、耗时和状态。排查问题时先看这里。

AstrLink 的请求记录
三次请求分别来自 Codex、Gemini CLI 和 Claude Code,都经 MoeRouter 完成。

撤回#

在 AstrLink 的“配置客户端”里取消勾选,或者把客户端地址改回 MoeRouter。

退出 AstrLink 会停止本地网关。 仍然指向 localhost:18317 的客户端会连不上。

↑↓ 选择Enter 打开可以直接粘贴报错原文