命令参考与常见问题
ModelSell CLI 的全部命令、常用参数、环境变量、文件位置和问题排查。
任何命令都可以加 --help 查看说明，加 --json 输出结构化结果。
命令一览
| 命令 | 作用 |
|---|
modelsell / modelsell configure | 配置 Agent 工具，见配置 Agent 工具 |
modelsell login / status / logout | 保存、查看、清除 CLI 调用模型用的 Key |
modelsell models [关键词] | 搜索模型；--type 筛选，--all 查看公开目录，--compact 精简输出 |
modelsell schema 模型 | 查看协议、路径、参数和文档链接 |
modelsell endpoints | 列出支持的协议 |
modelsell run 模型 | 调用模型，见调用模型 |
modelsell realtime 模型 | 实时模型，以 JSONL 收发 WebSocket 事件 |
modelsell show / wait 任务ID | 查询任务 / 继续等待任务 |
modelsell history | 本机提交过的任务 |
modelsell download URL --output 文件 | 下载生成结果 |
modelsell request /路径 | 调用原生 API |
modelsell upload --input-file 文件 | 调用 /api/assets/upload，参数格式由供应商决定 |
modelsell usage / price 模型 | 当前 Key 的额度 / 公开价格信息 |
modelsell init / aliases | 创建 modelsell.json / 查看项目别名 |
modelsell skill install | 为项目安装 Agent Skill |
modelsell mcp | 启动 MCP 服务，见让 Agent 调用模型 |
modelsell auth token | 输出已保存的 Key，供 Codex、Crush、Droid 读取，一般无需手动运行 |
配置命令参数
| 参数 | 说明 |
|---|
--target 列表 | codex、claude、gemini、openclaw、opencode、qwen、crush、droid、kimi 或 all，多个用逗号分隔 |
--api-key KEY | API Key；省略时读取 MODELSELL_API_KEY 或提示输入 |
--base-url URL | API 地址，默认 https://www.modelsell.com |
--model 模型 | 所有选中的工具使用同一个模型 |
--<工具>-model 模型 | 为单个工具指定模型，如 --codex-model、--qwen-model |
--yes | 不再询问，未指定的项使用推荐值 |
调用命令参数
| 参数 | 说明 |
|---|
-p, --prompt | 提示词 |
-i, --input key=value | 原生参数，可重复 |
--input-file 文件 | 完整 JSON 请求，- 表示标准输入 |
--file 字段=路径 | 上传本地文件，可重复 |
--endpoint 协议 | 指定协议 |
--stream | 流式输出文本 |
--no-wait | 提交后立即返回任务 ID |
--download 目录 | 保存生成的媒体文件 |
--output 文件 | 保存原始响应；语音合成必填 |
--dry-run | 只预览请求，不提交 |
--timeout 秒 / --poll-interval 秒 | 最长等待时间（默认 600）/ 查询间隔（默认 2） |
-H, --header 名称:值 | 附加请求头 |
--force | 允许覆盖已有文件 |
环境变量
| 变量 | 说明 |
|---|
MODELSELL_API_KEY | 优先于已保存的 Key |
MODELSELL_BASE_URL | API 地址，默认 https://www.modelsell.com |
MODELSELL_CONFIG_DIR | 配置目录，默认 ~/.config/modelsell |
文件位置
| 文件 | 内容 |
|---|
~/.config/modelsell/credentials.json | 已保存的 Key 和对应的 API 地址 |
~/.config/modelsell/tasks/ | 本机提交过的异步任务记录 |
项目中的 modelsell.json | 默认模型与别名，不含 Key |
| 各 Agent 工具的配置文件 | 见支持的工具 |
常见问题
| 问题 | 处理方式 |
|---|
| 安装后提示找不到命令 | 重新打开终端；仍不行时使用完整路径 ~/.local/bin/modelsell，或把该目录加入 PATH |
运行 modelsell 只出现配置菜单 | 不带子命令时进入 Agent 配置；调用模型请使用 modelsell run |
| Codex 提示鉴权失败或 401 | 升级到 0.4.0 后重新运行 modelsell configure --target codex；确认 modelsell 命令没有被移动或卸载 |
| Claude Code 每次启动都回到同一个模型 | 旧版本写入了 ANTHROPIC_MODEL，重新运行 modelsell configure --target claude 即可移除 |
Gemini CLI 提示需要 GEMINI_API_KEY | Gemini CLI 只在受信任的目录加载 ~/.gemini/.env，请先信任当前目录 |
已配置 Agent 工具，但 modelsell run 提示未登录 | 两者的 Key 分开保存，运行 modelsell login 或设置 MODELSELL_API_KEY |
| 找不到模型或提示无权限 | 用 modelsell models 核对 ID；公开目录中可见不代表当前 Key 有权限 |
Agent 中提示 fetch failed | Agent 沙箱禁止联网；允许联网，或改用 MCP 服务 |
| 生成等待超时 | 保留任务 ID，用 modelsell wait 任务ID 继续等待，不要重复提交 |
| 提示未知参数 | 先用 modelsell schema 查看；供应商专有参数用 -i key=value 或 --input-file 传入 |
| 任务成功但文件没保存 | 加 --download 目录；检查结果链接是否过期、目录权限和同名文件 |
| 更换 Key 或退出登录 | modelsell login 更新、modelsell logout 清除；Agent 工具里的 Key 需重新运行 modelsell configure |
更多实现细节见 GitHub 上的模型调用指南。