For AI agents: the complete documentation index is available at https://aioproxy.dev/zh/llms.txt, the full documentation bundle is available at https://aioproxy.dev/zh/llms-full.txt, and this page is available as Markdown at https://aioproxy.dev/zh/guide/integrations/agents/index.md.
  • 简体中文
  • 原生 Agent 集成概述

    现代 AI 编码 Agent(如 OpenAI Codex、Anthropic Claude Code、xAI Grok Build、OpenCode、Pi、OMP)通常作为本地 CLI 或桌面应用运行,各自拥有专属的配置结构、会话存储与认证机制。

    手动将这些工具对接到本地代理往往需要复制 Base URL、修改深层配置文件,并在更新后重复维护。为此,AIO Proxy 提供了原生的 aio-proxy agent 命令体系:

    • 自动化探测:自动识别系统已安装的 Agent 及其宿主版本与配置路径。
    • 免贴 Token 桥接:通过本地控制面动态生成和轮转专属访问凭证,支持 Dashboard 设备码一键授权。
    • 配置与会话无侵入:安全维护代理配置段;支持历史会话迁移与事务回退,移除时无损还原用户个人设置。

    受支持的 Agent 清单

    Agent 标识目标工具集成机制与原理支持详情
    codexOpenAI Codex CLI / Desktop交互式向导配置提供商、管理凭据,支持历史会话无损迁移Codex 接入指南
    claude-codeAnthropic Claude Code将代理地址与 Token 合并写入全局 settings.jsonClaude Code 接入指南
    grokxAI Grok Build注入本地 Auth Helper,通过控制台设备码完成一键授权Grok 接入指南
    opencodeOpenCode自动解析配置目录并注入动态插件模块,支持原生模型协商OpenCode 接入指南
    piPi Coding Agent探测 ~/.pi/agent/extensions 扩展体系并注入桥接模块Pi 与 OMP 接入指南
    ompOh-My-Pi (OMP)解析 OMP 活动配置并注入扩展,支持 /login aio-proxyPi 与 OMP 接入指南

    常用管理命令

    1. 查看已接入的 Agent 状态

    通过 agent list 查看所有受支持 Agent 的检测状态、适配器版本、授权有效性与配置完整度:

    aio-proxy agent list

    若需连通性自检与目录结构校验,添加 --check 参数:

    aio-proxy agent list --check

    2. 解除 Agent 接入

    当需要将某个 Agent 还原至接入前状态时,运行:

    aio-proxy agent remove <codex|claude-code|grok|opencode|pi|omp>

    AIO Proxy 会:

    • 吊销该集成在本地控制面颁发的全部临时凭证。
    • 仅剔除 AIO Proxy 写入的插件或配置段,完整保留用户的其余个人偏好与自定义配置。

    3. 手动吊销凭证

    如果需要根据安装 ID 撤销某次授权:

    aio-proxy agent revoke <installation-id>