---
order: 20
---

# 管理 AgentTeam 授权

AgentTeam 客户端会把 AgentTeam 服务授权保存在本地。每条授权对应一个 AgentTeam server URL 和一个 workspace。

## 常用命令一览

列出本地已有授权：

```bash
agentteam auth status
```

连接或重连一个 AgentTeam machine：

```bash
agentteam daemon --server-url <url> --api-key <machineApiKey>
```

只保存或刷新授权，不启动前台 daemon：

```bash
agentteam auth login --api-key <machineApiKey>
```

省略 `--server-url` 时，`agentteam auth login` 默认使用 AgentTeam SaaS 地址 `https://agentteam.pingcap.com`。连接其他 AgentTeam server 时再传 `--server-url <url>`。

删除某条授权：

```bash
agentteam auth logout <auth-id>
```

## `agentteam daemon --server-url ... --api-key ...` 和 `agentteam auth login` 的区别

这两个命令容易混淆，但职责不同：

- `agentteam auth login --api-key ...`：解析并保存本地 AgentTeam machine 授权；默认使用 AgentTeam SaaS 地址，除非显式传入 `--server-url`
- `agentteam daemon --server-url ... --api-key ...`：解析并保存同一份授权，然后在需要时以前台方式启动 daemon

两个命令都会先向 AgentTeam Server 解析 machine API key，拿到 workspace 和 machine 身份后再保存。本地命令不再要求用户填写 workspace ID。

对同一个 server URL 和 workspace 重新执行命令，会更新同一条本地授权 ID。同一个 server URL 下的不同 workspace 会保存为不同授权条目。

## 什么时候应该删除授权

当下面这些情况发生时，删除更合适：

- 这条授权已经不再使用
- 你希望彻底移除旧配置
- 新的 machine key 或 workspace 授权已经替代它

## 推荐管理习惯

- 控制本地授权数量
- 定期检查哪些授权仍然启用且有人维护
- 轮换 key 或删除 machine 后，及时清理旧授权

## 下一步

- [机器](./README.md)