Apache Casbin Gateway
2. Agent客户端

2.1 Agent客户端

Agent客户端是首页。本机装的每个AI编码Agent都在这儿,一行四张卡片。

Agent客户端

每张卡片给出:

  • 它登录的账号,
  • 它使用的供应商,
  • 它花了多少——只要它自己的会话记录能追溯到,就按天铺开最近一个月,
  • 以及它此刻是否在运行。

本机没装的Agent也会列出来,方便直接从这一页装上。

Agent是怎么找到的

Gateway会读它自己所在这台机器的用户账户、主目录和安装路径,覆盖安装程序写出的那些目录布局,也覆盖手动解包、放进PATH的情况。

要是某个Agent藏在两者都描述不了的地方,就直接指给它:选择程序可以浏览本机,把你挑中的程序作为一个独立的安装列出来,不移动也不修改任何东西。

这也是Gateway必须跑在目标机器上的原因——容器里它读的是容器自己的文件系统,什么都找不到(5.4)。

启动与停止

启动和停止就在卡片上。从Gateway启动的Agent,和你自己启动的是同一份安装,Gateway只负责把它拉起来。

账号

Codex同时只保留一份登录信息,它自己的登录会覆盖原有的那份。所以对Codex——CLI和ChatGPT桌面应用共用这份登录——Gateway会保存副本:ChatGPT订阅账号和API密钥可以同时留在手上,在它们之间切换只需点一下,不用重新登录。

卡片上的账户选择器显示当前在用的登录,并能把Agent切到另一个已保存的账号。Agent自己的页面上有完整的账号表:

作用
登录用一个独立的目录运行Codex自己的浏览器登录,所以当前在用的账号不受影响,登录回来的账号会被保存下来
添加API密钥按Codex自己的格式保存一个密钥。切换过去后,Codex改用密钥而不是账号登录
切换把这份已保存的登录放回去
剩余用量订阅账号才有:短周期(五小时)和每周两个额度各剩多少、各自什么时候重置,以及账号还剩几次重置额度。Gateway用那个账号自己的令牌向OpenAI查询。密钥没有套餐额度,显示为-
垃圾桶Gateway删除它保存的副本。Codex当前登录的账号保持不变

每个账号的名字可以直接在表里改,这样同一套餐的两个账号不用看邮箱就能分清。

Gateway没有副本的登录,一旦切换就会丢失,所以页面会提示出来,并在你选别的账号之前提供保存当前登录。

Agent在启动时读取登录信息。它运行期间切换账号,会提示重启Agent后生效;在那之前它继续用启动时的那个账号。

实例

实例是同一个Agent的各个副本,每个有自己的状态目录,因此各自登录各自的账号,并且可以同时运行——最常见的理由是开几个Claude Desktop,一个账号一个。

安装本身就是第一个,列为默认实例:它运行在Agent默认使用的状态目录上。它以安装本身命名,不能重命名,也不能移除。

  • 添加实例再新建一个。
  • 移除实例只是让Gateway忘掉它。状态目录和登录在里面的账号都留在磁盘上。

只有Gateway知道怎么给它另配状态目录的Agent,才有实例。

Agent自己的页面

点开卡片是同样的信息的完整版,外加所有按Agent设置的东西:

区域作用章节
供应商把这个Agent绑到某个供应商,预览并写入它的配置3.2
权限与权限页相同的那张卡片,只针对这个Agent4.1
监控开启这个Agent的只读活动记录2.3
外发监测这个Agent自己的进程往哪里发数据2.3
账号、实例Gateway为它保存的登录,以及它的各个副本见上文
版本当前版本,以及包管理器发布的版本2.2
会话与花费它自己的会话记录,以及对应的费用2.3、4.3

高级视图

高级视图从首页进入而不占侧边栏,是同一批安装的表格形式:一行一个安装,带路径、安装方式和所属实例。同一个Agent装了两份、需要把两份区分开的时候,用这一页。

下一节:2.2 版本管理。

在GitHub上编辑
Apache Incubator

Apache Casbin (Incubating) is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright © 2026 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.

Apache, Apache Casbin, the names of Apache projects, and the feather logo are either registered trademarks or trademarks of The Apache Software Foundation in the United States and/or other countries. All other marks mentioned may be trademarks or registered trademarks of their respective owners.

本页内容