安装 q

使用 Go 安装 q，或从源码构建，然后启动本地 Studio。

查看 Markdown

要求

安装 q 前，请确保具备以下条件：

Task 是可选的。所有必要的构建和测试命令都能直接通过 Go 运行。

从 Go 模块直接安装 q：

powershell

go install github.com/snowmerak/q/cmd/q@latest

可选的 q-mcp 伴随程序也可以同样安装：

powershell

go install github.com/snowmerak/q/cmd/q-mcp@latest

Go 将二进制文件写入 GOBIN；未设置时写入 GOPATH/bin。请确保该目录位于 PATH 中。

如果要构建当前源码或参与 q 开发，请克隆仓库：

powershell

git clone https://github.com/snowmerak/q.git
cd q
go install ./cmd/q ./cmd/q-mcp

这会从已检出的源码安装两个命令，而不是通过 Go 模块代理解析 @latest。

在源码检出目录中直接启动 q：

powershell

go run ./cmd/q studio

仓库还包含常用开发任务的 Task 目标：

powershell

task run
task build
task test

从任意目录启动 Studio，然后在 Sessions 中注册仓库：

powershell

q studio

在 Settings → Providers 中添加提供商，并在 Settings → Models 中分配默认模型。bare q 仍可作为终端兼容客户端使用。