NEURAL ROUTING ONLINE

把模型接入,
变成一次配置。

AIPortX Connect 把账户、频道、模型和本地 Agent 串成一条可控的安全通道。你可以使用原生客户端,也可以直接在服务器中手动配置。

ROUTING CORE / 01STABLE
AX / 1.1
CHANNELREADY
MODEL BUSSYNCED
KEY SCOPEISOLATED

NATIVE CLIENTS

选择你的工作环境

MACmacOS
1.1.0 / ARM64

原生控制台,使用 Keychain 保护专用 Key。适合希望用一套界面完成登录、频道选择、模型同步和 Agent 配置的用户。

Keychain6 AgentsNative UI
下载 macOSSHA-256
cf02bd8435614171ccae31a02c07bced7adc99f4546bcc49ff6d01fd2248cd50
WINWindows
1.1.0 / X64

深色 AI 控制台,支持双栏 Agent 卡片、服务频道选择、DPAPI 密钥隔离和本地启动器配置。

DPAPI6 AgentsWPF Native
下载 WindowsSHA-256
B49866DDDAC7FFC1E42B7AA216370CDFE3EF1E22AB51AA8B5E49F30533731906

FIELD GUIDE

从安装到运行

用客户端完成一次接入

客户端会把网页账户权限转换成本机 Agent 能使用的配置。密码只参与登录请求,专用 Key 按服务器、账户和频道隔离保存。

01
安装并打开

选择与你系统对应的安装包。Windows 安装到当前用户目录,macOS 将应用拖入 Applications。

02
登录并选择频道

填写 API 根地址、网页账户和密码。登录成功后,手动选择要使用的服务频道,不要跳过这一步。

03
连接目标 Agent

在卡片中选择 Codex、Claude、Gemini、Kimi、OpenCode 或 Crush,点击“连接 AIPortX”。首次连接会同步模型列表并创建或复用专用 Key。

04
重启 Agent

完成配置后关闭并重新打开对应 Agent。Windows 启动器在 `%APPDATA%\\AIPortX Connect\\launchers`,macOS 启动器在 `~/.local/bin`。

不用客户端,直接在服务器使用

手动方式适合远程开发机和自动化环境。先从账户后台得到当前频道的专用 Key,只把它放在当前终端,不要写进代码仓库。

01
设置 OpenAI 兼容路由
export OPENAI_BASE_URL='https://api.aiportx.com/v1'
export OPENAI_API_KEY='YOUR_KEY'
02
启动 Codex

Codex 使用 `~/.codex/config.toml` 中的 OpenAI Responses Provider。写入 `base_url = "https://api.aiportx.com/v1"`,然后执行:

codex
03
其他 Agent 的环境变量
export ANTHROPIC_BASE_URL='https://api.aiportx.com'
export ANTHROPIC_AUTH_TOKEN='YOUR_KEY'
export GEMINI_API_KEY='YOUR_KEY'
export AIPORTX_API_KEY='YOUR_KEY'

安全边界和清理方法

把专用 Key 当作密码处理。客户端不会展示完整 Key,手动配置时也建议只在当前会话使用。

01
不要保存到仓库

不要把 Key 写入 `.env`、shell profile、项目配置、截图或提交记录。团队共享时使用各自账户和频道。

02
结束会话后清理
unset OPENAI_API_KEY ANTHROPIC_AUTH_TOKEN GEMINI_API_KEY AIPORTX_API_KEY
03
怀疑泄露时立即轮换

在账户后台撤销当前频道 Key,再创建新的 Key。客户端用户可以使用“清除本机配置”后重新登录,旧的本地密钥和启动器会被清理。

路由地址、账户、频道和模型是四个独立概念。遇到 401、403 或模型列表为空时,先分别确认它们,不要反复重试密码。

四类常见问题,按顺序定位

先确认地址,再确认身份,最后确认频道权限。每次只改一个变量,避免把多个问题叠在一起。

01
401:Key 或账户不匹配

确认当前终端使用的是同一频道生成的专用 Key,检查是否多了空格或引号。客户端用户退出后重新登录,再重新连接 Agent。

02
403:频道没有权限

确认账户已加入目标频道,并且该频道允许当前 Agent 使用。切换到有权限的频道后重新同步模型,不要重复创建本地 Key。

03
模型列表为空

先检查根地址是否带 `/v1`,再确认频道处于在线状态。可在终端执行下面的检查,返回 JSON 就说明路由可达:

curl "$OPENAI_BASE_URL/models" -H "Authorization: Bearer $OPENAI_API_KEY"
04
Windows PowerShell 写法

PowerShell 不使用 `export`。在当前窗口设置变量后,再启动 Agent:

$env:OPENAI_BASE_URL = 'https://api.aiportx.com/v1'
$env:OPENAI_API_KEY = 'YOUR_KEY'
如果客户端能登录但 Agent 仍失败,优先检查 Agent 是否已完全重启,以及它读取的启动器是否来自最新一次“连接 AIPortX”。