跳转至

命令参考

所有 clinvk CLI 命令的完整参考。

概要

clinvk [全局参数] [提示词]
clinvk [命令] [子命令] [参数]

命令概览

命令 描述 常见用途
[prompt] 执行提示词（默认命令） 日常 AI 任务
resume 恢复之前的会话 继续对话
sessions 管理会话 列出、查看、删除会话
config 管理配置 查看或更改设置
parallel 并行执行任务 运行多个任务
compare 对比后端响应 评估不同 AI
chain 链式执行提示词 多步骤工作流
mcp 启动 MCP 服务器 MCP 集成
serve 启动 HTTP API 服务器 应用程序集成
version 显示版本信息 检查已安装版本
help 显示帮助 获取命令帮助

全局参数

这些参数适用于所有命令：

参数 简写 类型 默认值 描述
--backend -b string claude 使用的 AI 后端
--model -m string 使用的模型
--workdir -w string 工作目录
--output-format -o string json 输出格式
--config string 配置文件路径
--dry-run bool false 仅显示命令
--ephemeral bool false 无状态模式
--help -h 显示帮助

提示词命令特定参数

这些参数仅适用于默认提示词命令：

参数 简写 类型 默认值 描述
--continue -c bool false 继续最近的会话

参数详情

--backend, -b

选择要使用的 AI 后端：

clinvk --backend claude "提示词"
clinvk -b codex "提示词"
clinvk -b gemini "提示词"

可用后端：claude、codex、gemini

--model, -m

覆盖所选后端的默认模型：

clinvk -b claude -m claude-sonnet-4-20250514 "提示词"
clinvk -b codex -m o3-mini "提示词"

--workdir, -w

设置 AI 后端的工作目录：

clinvk --workdir /path/to/project "分析这个代码库"

--output-format, -o

控制输出格式：

值 描述
text 纯文本
json 结构化 JSON（默认）
stream-json 流式 JSON 事件 
clinvk --output-format json "提示词"
clinvk -o stream-json "提示词"

--config

使用自定义配置文件：

clinvk --config /path/to/config.yaml "提示词"

--dry-run

显示将要执行的命令而不运行：

clinvk --dry-run "实现功能 X"
# 输出：Would execute: claude --model claude-opus-4-5-20251101 "实现功能 X"

--ephemeral

在无状态模式下运行，不创建会话：

clinvk --ephemeral "快速问题"

命令分类

核心命令

日常使用的命令：

  • [prompt] - 执行提示词
  • resume - 继续会话
  • sessions - 管理会话

配置命令

管理设置的命令：

  • config - 查看和修改配置

执行命令

高级执行模式的命令：

  • parallel - 并发运行多个任务
  • chain - 执行顺序流水线
  • compare - 对比多个后端

服务器命令

运行 HTTP API 的命令：

  • mcp - 启动 MCP 服务器
  • serve - 启动 API 服务器

使用示例

基本用法

# 执行提示词
clinvk "修复 auth.go 中的 bug"

# 指定后端
clinvk -b codex "实现功能"

# 指定模型
clinvk -b claude -m claude-sonnet-4-20250514 "快速审查"

会话管理

# 列出会话
clinvk sessions list

# 显示会话详情
clinvk sessions show abc123

# 恢复最近会话
clinvk resume --last

# 删除旧会话
clinvk sessions clean --older-than 30d

配置

# 显示当前配置
clinvk config show

# 设置值
clinvk config set default_backend codex

高级执行

# 并行运行任务
clinvk parallel --file tasks.json

# 对比后端
clinvk compare --all-backends "解释这段代码"

# 执行链
clinvk chain --file pipeline.json

服务器

# 启动服务器
clinvk mcp --transport stdio
clinvk serve --port 8080

退出码

所有命令都返回退出码：

代码 描述
0 成功
1 一般错误
2 后端不可用
3 配置无效
4 会话错误

参见 退出码 获取完整参考。

获取帮助

获取任何命令的帮助：

# 一般帮助
clinvk --help

# 命令帮助
clinvk [命令] --help

# 示例
clinvk parallel --help

另请参阅