Qoder Cloud Agents API 使用 PAT（Personal Access Token，个人访问令牌） 进行身份认证。所有 API 请求必须在 HTTP 头中携带有效的 PAT。
PAT 获取方式
登录 Qoder CN控制台
进入 设置 → API 令牌 页面
点击 创建令牌，设置名称与权限范围
复制生成的令牌（仅显示一次，请妥善保存）
PAT 以 pt- 前缀开头，格式如 pt-your-token-here。请勿将令牌提交到代码仓库或公开分享。
Bearer 头格式
在每个请求的 Authorization 头中以 Bearer 方式传递 PAT：
Authorization: Bearer pt-your-token-here
完整请求示例：
# 获取 Agent 列表
curl -s "https://api.qoder.com.cn/api/v1/cloud/agents" \
-H "Authorization: Bearer $QODER_PAT"
环境变量配置（推荐）
建议将 PAT 存储为环境变量，避免硬编码：
# 在 ~/.bashrc 或 ~/.zshrc 中添加
export QODER_PAT="pt-your-token-here"
# 验证配置是否生效
curl -s "https://api.qoder.com.cn/api/v1/cloud/agents?limit=1" \
-H "Authorization: Bearer $QODER_PAT"
安全建议
为不同环境（开发/测试/生产）创建独立 PAT
定期轮换令牌
使用最小权限原则分配令牌范围
发现泄露时立即在控制台撤销
该文章对您有帮助吗？