q 설치
Go로 q를 설치하거나 소스에서 빌드한 뒤 로컬 Studio를 시작합니다.
요구사항
q를 설치하기 전에 다음 항목을 준비하세요.
- Go 1.26.9 이상
PATH에서 실행 가능한 Git- 구성된 모델 공급자 하나 이상
- Studio를 사용할 최신 브라우저
Task는 선택 사항입니다. 필요한 모든 빌드와 테스트 명령은 Go만으로 실행할 수 있습니다.
Go로 설치
Go 모듈에서 q를 직접 설치합니다.
go install github.com/snowmerak/q/cmd/q@latest
선택 사항인 q-mcp 동반 도구도 같은 방식으로 설치할 수 있습니다.
go install github.com/snowmerak/q/cmd/q-mcp@latest
Go는 바이너리를 GOBIN에 기록하며, GOBIN이 없으면 GOPATH/bin을 사용합니다. 해당 디렉터리가 PATH에 포함되어 있어야 합니다.
소스에서 설치
현재 소스 트리를 빌드하거나 q에 기여하려면 저장소를 복제하세요.
git clone https://github.com/snowmerak/q.git
cd q
go install ./cmd/q ./cmd/q-mcp
이 명령은 Go 모듈 프록시에서 @latest를 해석하지 않고 체크아웃된 소스에서 두 명령을 설치합니다.
설치하지 않고 실행
소스 체크아웃에서 q를 바로 시작할 수 있습니다.
go run ./cmd/q studio
저장소에는 일반적인 개발 작업용 Task 대상도 있습니다.
task run
task build
task test
Studio 시작
어느 디렉터리에서든 Studio를 시작한 뒤 Sessions에서 저장소를 등록하세요.
q studio
Settings → Providers에서 공급자를 추가하고 Settings → Models에서 기본 모델을 할당하세요. bare q는 터미널 호환 클라이언트로 유지됩니다.