Cotemu 文档

外观

交给 AI Agent ​

Cotemu 的接口说明写给 AI agent 阅读。需要用程序查询账号用量、管理队员限额，或在脚本里调用模型时，无需自己阅读接口文档：把下面的提示词发给 AI agent（Codex、DeepSeek Harness 等），它会先读完接口说明，再编写或执行。

发给 AI agent 的提示词 ​

text
先完整阅读 https://docs.cotemu.com/agent-api.md
这是 Cotemu 的接口说明，之后的操作以它为准。
我的 Cotemu API 密钥在环境变量 COTEMU_API_KEY 里；
队伍管理令牌在环境变量 COTEMU_TEAM_TOKEN 里（仅队长有）。
不要在输出中显示完整的密钥或令牌。

要做的事：<在这里写要做的事>

可以交给它的事 ​

需求示例
查询账号用量查询我的密钥绑定的账号，5 小时和 7 天窗口各用了多少、什么时候重置
用量看板、状态栏写一个脚本，每分钟查询一次账号用量，显示在 tmux 状态栏
挑选账号我有三把密钥，分别在 COTEMU_KEY_1 到 COTEMU_KEY_3 里，挑出此刻最空闲的一把
在程序里调用模型写一个 Python 函数，用我的 GPT 账号总结一段文本
排查调用失败Codex 返回 429 account_concurrency_limit，说明原因与处理方法
管理队员限额（队长）列出本周用量超过限额 80% 的队员；把全队的日限额设为 5 美元

准备凭证 ​

凭证用途获取方式
API 密钥查询账号用量、调用模型网站“密钥管理”页面，见创建 API 密钥
队伍管理令牌查询和修改本队队员的限额与并发上限队长在队伍页“成员”页签右侧的“开放接口”卡片生成，只显示一次

在启动 AI agent 的终端中设置环境变量（桌面客户端需设置为系统环境变量）：

sh
export COTEMU_API_KEY="sk-ctm-…"
export COTEMU_TEAM_TOKEN="ctm-team-…"   # 仅队长需要
powershell
$env:COTEMU_API_KEY = "sk-ctm-…"
$env:COTEMU_TEAM_TOKEN = "ctm-team-…"   # 仅队长需要

凭证安全

不要把密钥或令牌直接粘贴进对话，也不要让 agent 将其写入项目文件或提交到仓库。队伍管理令牌可以修改全队的限额，不要发给队员；泄露后在“开放接口”卡片点“更换”，旧令牌立即失效。

长期使用 ​

经常让 agent 操作 Cotemu 时，把下面一行加入项目的 AGENTS.md（Claude Code 为 CLAUDE.md），agent 每次都会按接口说明执行：

text
需要查询或调用 Cotemu 时，先阅读 https://docs.cotemu.com/agent-api.md 。

站点索引 https://docs.cotemu.com/llms.txt 列出了全部文档，供 agent 查找。

说明 ​

  • 修改队员限额、清零用量会立即生效。接口说明要求 agent 在执行这类操作前先征得用户确认。
  • 只查看用量时无需 agent：网站“密钥管理”页面的账号卡片显示各窗口的用量与重置时间。
  • 创建密钥、缴费、队伍设置等操作没有接口，只能在网站上完成。

Cotemu Docs