Model Keys Management

管理 tiny-llm-proxy 的 API keys：查询、添加、删除、启用/禁用。

脚本路径

本 skill 的脚本位于 scripts/ 目录下。使用时需要确定 skill 的安装路径：

• Claude Code: ${CLAUDE_SKILL_DIR} 环境变量指向 skill 目录
• pi / 其他环境: skill 安装在项目 .claude/skills/model-keys/ 或 .agents/skills/model-keys/ 下，请根据实际路径调用

建议: 先用 ls 找到 list-keys.ts 等脚本的确切位置，再执行。

Quick Reference

任务	命令（将 <SKILL_DIR> 替换为实际路径）
列出所有 key	bun <SKILL_DIR>/scripts/list-keys.ts
创建新 key	bun <SKILL_DIR>/scripts/create-key.ts <name> [--models m1,m2]
删除 key	bun <SKILL_DIR>/scripts/delete-key.ts <name>
禁用 key	bun <SKILL_DIR>/scripts/disable-key.ts <name>
启用 key	bun <SKILL_DIR>/scripts/enable-key.ts <name>
自定义端点	所有脚本支持 --url 和 --key 参数覆盖默认值

参数说明

所有脚本支持以下公共参数：

参数	说明	默认值
--url	API 端点地址	https://new.fortao.cn
--key	Master Key	从环境变量 TINY_LLM_PROXY_KEY 读取

创建 key 参数

参数	说明	默认值
<name>	key 名称（必填）	-
--models	允许使用的模型（逗号分隔）	不限制

使用示例

# 先确定 skill 路径（示例，根据实际安装位置调整）
SKILL_DIR=".claude/skills/model-keys"   # 或 ".agents/skills/model-keys" 等

# 列出所有 key
bun $SKILL_DIR/scripts/list-keys.ts

# 创建新 key（无模型限制）
bun $SKILL_DIR/scripts/create-key.ts my-app

# 创建新 key（限制只能使用指定模型）
bun $SKILL_DIR/scripts/create-key.ts limited-app --models gpt-4o,claude-sonnet-4-20250514

# 禁用 key
bun $SKILL_DIR/scripts/disable-key.ts old-app

# 启用 key
bun $SKILL_DIR/scripts/enable-key.ts old-app

# 删除 key
bun $SKILL_DIR/scripts/delete-key.ts old-app

错误处理

错误信息	原因	解决方案
HTTP Error 401	Master Key 无效	检查 --key 参数
HTTP Error 403	非 master key 无权操作	确认使用的是 master key
HTTP Error 409	key 名称已存在	使用其他名称
Connection error	服务未启动或网络问题	确认服务是否运行
key name required	未提供 key 名称	提供 <name> 参数