ClavueClavue
macOS AI 工作台

CLI 参考

Clavue 开发程序是 npm 包 iclavue（CLI / TUI）。imux 另捆绑兼容 CLI 名称 icc。下列先给 Clavue 安装钉，再列 icc 高频命令；完整 socket v2 以仓库 docs 与 --help 为准。交互式全屏会话见 TUI；HTTP 模型调用见 OpenAI 兼容 API。

Clavue CLI 版本与安装串由 site-release 钉自动同步，不手写营销页。非 focus 类 socket 命令不得抢占用户焦点。socket API ≠ api.clavue.com HTTP。

安装 Clavue CLI（v11.1.10）

包名 iclavue。发版后公网钉： site-release-latest.json · VERSION · 发布日 2026-08-10

# npm (pinned)
npm install -g [email protected]

# npx
npx -y [email protected]

# install script
curl -fsSL https://www.clavue.com/cli/install.sh | bash -s -- 11.1.10

# Windows signed pager
# https://www.clavue.com/downloads/native/clavue-pager-win32-x64.exe

本版要点

  • Unified progress authority: pad Bash never counts; env diagnosis vs code KPI
  • Reject Run(noop)/true pad tools; fuse stop after 2
  • Outcome: env next CTA, no Worked-for-1ms overlay, suppress false laziness_fail after tools

安装 imux 兼容 CLI (icc)

# After imux.app is installed
sudo ln -sf "/Applications/imux.app/Contents/Resources/bin/icc" /usr/local/bin/icc
icc --help

全局

icc --help
icc --version
# Tagged debug instance (isolation)
# ./scripts/reload.sh --tag my-task

工作区 / 窗格

icc workspace list
icc workspace new --title "agent-run"
icc pane list
icc pane split --direction right

通知

icc notify --title "Build" --body "finished"
icc notify --title "Test" --body "failed" --sound

浏览器自动化

icc browser goto https://example.com
icc browser snapshot
icc browser fill --selector "#email" --text "[email protected]"

远程

icc ssh user@host
# Uses OpenSSH config; remote explorer after connect

会员 / 设备码

# Device login (browser approve)
curl -s -X POST https://www.clavue.com/api/membership/auth/device/start \
  -H "content-type: application/json" -d '{"client":"clavue-cli"}'

curl -s -X POST https://www.clavue.com/api/membership/auth/device/poll \
  -H "content-type: application/json" \
  -d '{"device_code":"$DEVICE_CODE"}'

OpenAI 兼容 API

export OPENAI_BASE_URL=https://api.clavue.com/v1
export OPENAI_API_KEY=$CLAVUE_TOKEN

curl -s $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-imux-request-id: mbr_cli_demo_001" \
  -d '{"model":"auto","messages":[{"role":"user","content":"hi"}]}'

官方模型 ID： auto · clavue · clavue-2.1 · clavue-2.1-fast · clavue-2.1-pro · clavue-2.1-rev · clavue-2.1-search（搜索专用 / Official MCP）

错误体含 requestId / code / stage / messageZh / debug（无密钥）。响应头：x-imux-request-id、x-imux-error-code、x-imux-error-stage。上游失败会退还当次额度。 完整排查与反馈指南 →

官方 MCP · web_search

联网搜索以托管 MCP 提供（非闲聊）。imux 工具名 mcp__clavue__web_search；OpenAI 模型 id clavue-2.1-search。 完整使用说明 →

# Discover
curl -s https://api.clavue.com/v1/mcp -H "Authorization: Bearer $CLAVUE_TOKEN"

# Call
curl -s https://api.clavue.com/v1/mcp/tools/call \
  -H "Authorization: Bearer $CLAVUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"web_search","arguments":{"query":"Clavue release notes"}}'

# Equivalent chat.completions
curl -s https://api.clavue.com/v1/chat/completions \
  -H "Authorization: Bearer $CLAVUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"clavue-2.1-search","stream":false,"messages":[{"role":"user","content":"Clavue release notes"}]}'

加油包 API

# Status
curl -s https://www.clavue.com/api/membership/boost -H "Cookie: ..."
# Check-in / invite / rush
curl -s -X POST https://www.clavue.com/api/membership/boost \
  -H "content-type: application/json" \
  -d '{"action":"checkin"}'
curl -s -X POST https://www.clavue.com/api/membership/boost \
  -H "content-type: application/json" \
  -d '{"action":"rush_grab"}'

另见