AstrLink 由 New API 的作者 Calcium-Ion 开发,是一个本地网关:在电脑上开一个本地 API,管理上游 API 提供商、本地访问令牌、请求记录、隐私保护和故障转移。
AstrLink 需要常驻后台。只用一两个工具时,CC Switch 或手动配置更简单。
安装与首次打开#
从 GitHub Releases 下载 macOS 版本(Apple 芯片选 AstrLink_0.2.27_aarch64.dmg)。首次打开进入“开始使用 AstrLink”向导,左下角显示 网关 已就绪。

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

注意“保存后无法更改类型”。 -
在“连接”页填写:
- API 提供商名称:
MoeRouter - API 地址:
https://moerouter.com(根地址,不加/v1) - API Key:MoeRouter Key

“信任此提供商”保持关闭:开启后,发往它的请求不再经过 AstrLink 的隐私检查。 - API 提供商名称:
-
切到 入口协议 页确认:OpenAI Responses、Anthropic Messages、Gemini Generate Content、Chat Completions 都是“原样转发”。

每个协议下面标出了用它的客户端。 上游支持某个协议时选原样转发;只有上游只支持 Chat 时才需要转换,而转换会丢掉 Codex 的专用工具(例如
apply_patch)。MoeRouter 支持全部这些协议,保持原样转发即可。 -
点 保存 API 提供商。保存时 AstrLink 会从 MoeRouter 拉取模型列表,卡片上还会显示这个 Key 的剩余额度。

额度按美元换算显示,实际以 MoeRouter 控制台为准。
访问令牌与客户端地址#
左侧的 令牌 页有一个自动创建的“默认令牌”(以 astr_ 开头),上方显示本地 API 地址 http://localhost:18317。旧版本是 8317,以界面显示为准。

客户端连接 AstrLink 用的是这个 astr_… 令牌,不是 MoeRouter Key。可以给每个客户端单独建一个令牌,方便分别统计。
点令牌右侧的 配置客户端,勾选要写入的客户端,AstrLink 会自动改写它们的配置文件:

手动连接 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"

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,不要运行命令"

provider: astrlink。长期使用时,把这些 -c 参数写进 ~/.codex/config.toml,格式和 Codex 教程里的一样。查看请求记录#
左侧的 请求 页实时显示每一次调用:客户端、入口协议、走的提供商、模型、耗时和状态。排查问题时先看这里。

撤回#
在 AstrLink 的“配置客户端”里取消勾选,或者把客户端地址改回 MoeRouter。
退出 AstrLink 会停止本地网关。 仍然指向 localhost:18317 的客户端会连不上。