Astra GateEnglish

我用 , 想接

Astra Gate 是跑在你电脑上的 AI 网关。它替你改好 28 种 AI 工具的配置,把请求转给 28 个内置服务商或 16 个插件订阅,协议不同就在本机转换。选好两头,下面就是你要做的几步。

常见组合

Claude Code 接 DeepSeek,3 步

  1. 第 1 步:装 Astra,打开控制台

    需要 Node.js 18 或更高。服务在后台运行,控制台地址是 http://127.0.0.1:17321。

    npm install -g @aidotnet/astra-gateastra start --open

    不想装 Node.js:下载桌面版,它自带服务端,下面带 astra 的命令都能在控制台里点出来。

  2. 第 2 步:添加 DeepSeek,填上你的 Key

    Key 在 platform.deepseek.com 申请。它加密保存在本机;客户端配置里写的是 Astra 的令牌,不是这把 Key。

    astra provider add --template deepseek --key 你的 Key --name DeepSeek
  3. 第 3 步:让 Claude Code 走 Astra

    Astra 先备份 ~/.claude/settings.json,只改它需要的几项,写入网关地址和令牌。重启 Claude Code 后生效。也可以在控制台的客户端页点「启用」。

    astra client enable claude-code --provider DeepSeek

    不用了就运行 astra client disable claude-code,配置原样还原。

Astra 在中间做什么

  1. Claude Code
    发出Anthropic Messages
  2. Astra · 127.0.0.1:17321
    原样转发
  3. DeepSeek
    收OpenAI ResponsesOpenAI ChatAnthropic Messages

Claude Code 说 Anthropic Messages,DeepSeek 也收 Anthropic Messages:请求原样转发,Astra 只在中间记账、做隐私检查。

  • 每条请求记下 Token 和费用,按客户端、令牌、模型汇总。
  • 开了隐私护栏的话,请求出本机前先在本机检查一遍。
  • 改配置前先备份,首次的备份永久保留,随时还原。

看清每天花了多少钱

每条请求的输入、输出、缓存和推理 Token 都按模型单价记账。概览页按今天、7 天、30 天、90 天汇总,也可以只看某个客户端或令牌。

  • 「生成账单」把今天的花费按提供商、模型整理成一张图,可以复制或存成 PNG。
  • 请求日志里每一条都能点开,看逐项计费、耗时和协议。
  • 金额按模型单价估算,可能和服务商的实际账单有出入。
  1. 控制台
  2. 概览
文档:概览
控制台概览页,真实截图(这台机器今天的数据)

不把密钥和隐私发出去

请求离开你的电脑之前,隐私护栏先在本机扫一遍:API 密钥、私钥、邮箱、手机号、内网地址、银行卡号、证件号码等。命中后按你的设置警告、拦截或脱敏。

  • 脱敏时把原值换成占位符(如 [EMAIL_1])再发出,回复回来时换回原值。
  • 日志只存遮罩后的片段,原值不写进数据库。
  • 可以先开「只检测不处理」观察几天,再决定拦截哪些类别。
  1. 控制台
  2. 隐私护栏
文档:隐私护栏
隐私护栏概览页,真实截图

一个订阅给多个工具用

在 Astra 里登录一次 Claude、ChatGPT、Copilot 这些订阅,Codex、Claude Code、OpenCode 都能用它,协议不同由 Astra 转换。内置 7 种订阅登录,另有 16 个插件接入 Cursor、Kiro、Trae 等订阅。

  • 同一个服务商可以挂多个账号:手动切换、出错自动换下一个,或把新会话分给最空闲的账号。
  • 客户端绑定几个提供商时,一个限流或出错,按顺序换下一个继续。
  1. 控制台
  2. 客户端
  3. 使用的提供商
文档:客户端
客户端页,真实截图:左边是本机的客户端,右边是它用的提供商

给团队一个统一网关

把 Astra 部署在服务器上,给每位员工一个令牌。员工一条命令就把本机的 Claude Code、Codex 等客户端指向公司网关,用量、限额和告警按人统计。

  • 员工那边只装几百 KB 的 astra-connect,不常驻任何服务;astra-connect leave 还原原配置。
  • 命令里不含 Key,Key 在终端里输入,不显示,也不进 shell 历史。
  • 员工装的是桌面版时,发一个一次性接入链接就行。
  1. 控制台
  2. 令牌
  3. 复制员工接入命令
文档:员工接入
员工的电脑上(示例网关地址)
npx @aidotnet/astra-connect join https://astra.example.com# 批量部署:Key 从环境变量读,不进命令行参数ASTRA_API_KEY=sk-astra-… npx -y @aidotnet/astra-connect join \https://astra.example.com --clients all --yes

出门在外也能用

在设置里打开远程访问,Astra 会跑一条 Cloudflare Tunnel,把网关开放到公网:不需要公网 IP,也不用在路由器上转发端口。

  • 远程调用始终要带 Astra 令牌;管理后台默认不对外,打开前要先设管理员密码。
  • 持有令牌的人可以在 /key 页自己查用量和限额。
  • 本机的客户端仍然直连 127.0.0.1,配置不会被改动。
  1. 控制台
  2. 设置
  3. 远程访问
文档:远程访问
另一台设备上(示例域名)
curl https://astra.example.com/v1/chat/completions \-H "Authorization: Bearer sk-astra-…" \-H "Content-Type: application/json" \-d '{"model":"deepseek-chat","messages":[{"role":"user","content":"你好"}]}'
临时地址不用账号,打开就有一个 trycloudflare.com 地址;不支持流式输出,多数编程客户端用不了,只适合试用。
固定域名用你托管在 Cloudflare 的域名和隧道令牌,日常用选这个。

把 MCP 服务器收到一个地址

MCP 网关把多个远程 MCP 服务器合成一个 /mcp 地址,按令牌决定谁能用哪些。上游要 OAuth 的(比如 GitHub、Notion 的远程 MCP),在 Astra 里授权一次。

  • 默认关闭,关闭时 /mcp 返回 404,不多出任何入口。
  • 「应用到客户端」一键写进 Claude Code 和 Codex 的 MCP 配置,不覆盖你自己的同名条目。
  • 只转发 http 类型的服务器,本机 stdio 服务器不在其中。
  1. 控制台
  2. MCP 网关
文档:MCP 网关
在 Claude Code 里加上 Astra
claude mcp add --transport http astra http://127.0.0.1:17321/mcp \--header "Authorization: Bearer sk-astra-…"