AIPortX Connect 把账户、频道、模型和本地 Agent 串成一条可控的安全通道。你可以使用原生客户端，也可以直接在服务器中手动配置。
NATIVE CLIENTS
原生控制台，使用 Keychain 保护专用 Key。适合希望用一套界面完成登录、频道选择、模型同步和 Agent 配置的用户。
深色 AI 控制台，支持双栏 Agent 卡片、服务频道选择、DPAPI 密钥隔离和本地启动器配置。
FIELD GUIDE
客户端会把网页账户权限转换成本机 Agent 能使用的配置。密码只参与登录请求，专用 Key 按服务器、账户和频道隔离保存。
选择与你系统对应的安装包。Windows 安装到当前用户目录，macOS 将应用拖入 Applications。
填写 API 根地址、网页账户和密码。登录成功后，手动选择要使用的服务频道，不要跳过这一步。
在卡片中选择 Codex、Claude、Gemini、Kimi、OpenCode 或 Crush，点击“连接 AIPortX”。首次连接会同步模型列表并创建或复用专用 Key。
完成配置后关闭并重新打开对应 Agent。Windows 启动器在 `%APPDATA%\\AIPortX Connect\\launchers`，macOS 启动器在 `~/.local/bin`。
手动方式适合远程开发机和自动化环境。先从账户后台得到当前频道的专用 Key，只把它放在当前终端，不要写进代码仓库。
export OPENAI_BASE_URL='https://api.aiportx.com/v1'
export OPENAI_API_KEY='YOUR_KEY'Codex 使用 `~/.codex/config.toml` 中的 OpenAI Responses Provider。写入 `base_url = "https://api.aiportx.com/v1"`，然后执行：
codexexport 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，手动配置时也建议只在当前会话使用。
不要把 Key 写入 `.env`、shell profile、项目配置、截图或提交记录。团队共享时使用各自账户和频道。
unset OPENAI_API_KEY ANTHROPIC_AUTH_TOKEN GEMINI_API_KEY AIPORTX_API_KEY在账户后台撤销当前频道 Key，再创建新的 Key。客户端用户可以使用“清除本机配置”后重新登录，旧的本地密钥和启动器会被清理。
先确认地址，再确认身份，最后确认频道权限。每次只改一个变量，避免把多个问题叠在一起。
确认当前终端使用的是同一频道生成的专用 Key，检查是否多了空格或引号。客户端用户退出后重新登录，再重新连接 Agent。
确认账户已加入目标频道，并且该频道允许当前 Agent 使用。切换到有权限的频道后重新同步模型，不要重复创建本地 Key。
先检查根地址是否带 `/v1`，再确认频道处于在线状态。可在终端执行下面的检查，返回 JSON 就说明路由可达：
curl "$OPENAI_BASE_URL/models" -H "Authorization: Bearer $OPENAI_API_KEY"PowerShell 不使用 `export`。在当前窗口设置变量后，再启动 Agent：
$env:OPENAI_BASE_URL = 'https://api.aiportx.com/v1'
$env:OPENAI_API_KEY = 'YOUR_KEY'