@baryonlabs/cli · 교육기관 납품용

Baryon CLI
공식 문서

한 줄 설치로 시작하는 AI 코딩·학습 에이전트. 실제 코딩 에이전트 pi 를 baryon.ai API 에 연결해, 별도 키 설정 없이 바로 코드를 쓰고 실행합니다. 상용·로컬 모델은 무중단 전환됩니다.

terminal

$ npm install -g @baryonlabs/cli
$ baryon setup        # vibecamp.us 키 등록
$ baryon              # 코딩 에이전트 시작

#개요

@baryonlabs/cli 는 코딩 에이전트 pi 를 baryon.ai 플랫폼에 연결하는 얇은 래퍼입니다. baryon 명령은 pi 를 baryon 프로바이더로 실행하고, 그 외 모든 인자를 그대로 전달합니다.

① Web UI

브라우저에서 여러 LLM 비교·세션·도구 호출·문서 생성. chat.baryon.ai

② 코딩 에이전트

@baryonlabs/cli → pi. 대화형/JSON/RPC/SDK, 세션, 서브에이전트.

③ LLM 백엔드

baryon.ai API (OpenAI 호환). 로컬 LLM·기관 키로 전환.

요구사항

Node.js ≥ 22.19 — node -v 로 확인. Docker·빌드 과정 불필요.
패키지 매니저: npm · pnpm · yarn · bun 중 무엇이든.
baryon.ai API 키 (vc_live_…) — vibecamp.us 에서 발급.

#설치

전역 설치로 baryon 명령을 추가합니다. 내부적으로 @earendil-works/pi-coding-agent 를 의존성으로 함께 설치합니다.

npm / pnpm / yarn / bun

$ npm install -g @baryonlabs/cli
$ pnpm add -g @baryonlabs/cli
$ yarn global add @baryonlabs/cli
$ bun add -g @baryonlabs/cli

스크립트 설치 (curl)

shell

$ curl -fsSL https://cli.baryon.ai/install.sh | sh

Node 버전·패키지 매니저를 자동 감지해 설치합니다. 설치 후 baryon doctor 로 환경을 점검하세요.

검증baryon --version 으로 CLI/pi 버전을, baryon doctor 로 Node·pi·키·연결을 한 번에 확인합니다.

#빠른 시작

설치 → 키 발급 → 연결 → 실행. 4단계면 끝입니다.

~/project

$ baryon keys                         # 1. vibecamp.us 발급 페이지 열기
$ baryon setup                        # 2. vc_live_ 키 등록 (1회)
  ✔ wrote ~/.baryon/config.json
  ✔ provider baryon · 4 models
$ baryon                              # 3. 대화형 에이전트 시작
$ baryon -p "CSV를 분석해 차트를 만들어줘"   # 4. 단발 실행

#인증 · 키 관리

키 발급·회수·쿼터의 원천(source of truth)은 vibecamp.us 입니다. baryon.ai API 는 매 요청마다 키를 vibecamp.us 에 검증합니다. 키 형식은 vc_live_….

무엇	어디서
키 발급 · 회수 · 쿼터	vibecamp.us/dashboard · `baryon keys` 로 바로 열기
CLI 로컬 저장	`~/.baryon/config.json` (권한 600)
pi 프로바이더 참조	`~/.pi/agent/models.json` — 키 대신 `$BARYON_API_KEY` 토큰만
환경변수 우선	`BARYON_API_KEY` 가 있으면 파일보다 우선

동작 방식baryon setup 은 ① 키를 ~/.baryon/config.json 에 저장하고 ② ${BARYON_BASE_URL}/models 로 모델을 조회한 뒤(오프라인이면 기본값) ③ ~/.pi/agent/models.json 에 다른 프로바이더를 보존하며 baryon 프로바이더를 병합합니다.

키 등록/변경

$ baryon setup --key vc_live_xxxxx     # 비대화형 등록
$ baryon config --key vc_live_xxxxx    # 키만 갱신
$ export BARYON_API_KEY=vc_live_xxxxx   # 환경변수로 주입(CI 등)

#명령어 레퍼런스

내장 서브커맨드는 로컬에서 처리하고, 그 외 모든 인자는 pi 로 전달됩니다.

명령	설명
`baryon`	대화형 코딩 에이전트 시작 (baryon 프로바이더 기본 주입)
`baryon setup`	키 등록 + pi 프로바이더 구성. `--key`, `--base-url`
`baryon keys`	vibecamp.us 키 발급·관리 대시보드 출력/열기
`baryon config`	현재 설정 보기. `--key` · `--base-url` · `--model` 로 변경
`baryon models`	사용 가능한 모델 목록 (`pi --list-models` 패스스루)
`baryon doctor`	Node · pi · config · 키 · 연결 진단
`baryon update`	CLI + pi 에이전트 최신화
`baryon help` · `--version`	도움말 · 버전

pi 패스스루

아래처럼 pi 의 모든 옵션을 그대로 쓸 수 있습니다. --provider/--model/--api-key 를 직접 주면 그 선택을 우선해, 모델 비교가 자유롭습니다.

passthrough

$ baryon -p "요약해줘"                      # 단발 실행(print)
$ baryon @report.md @data.csv "분석해줘"    # 파일 첨부
$ baryon --provider openai --model gpt-4o    # 다른 모델로 비교
$ baryon --mode json -p "테스트 작성"        # JSON 이벤트 출력
$ baryon -c                                  # 직전 세션 이어가기

#설정

모든 설정은 환경변수 또는 config 파일로 제어합니다. 환경변수가 파일보다 우선합니다.

환경변수

변수	기본값	설명
`BARYON_API_KEY`	—	API 키. 있으면 config 파일보다 우선
`BARYON_BASE_URL`	`https://api.baryon.ai/v1`	OpenAI 호환 엔드포인트
`BARYON_KEYS_URL`	`https://vibecamp.us/dashboard`	`baryon keys` 가 여는 주소

config 파일

경로	내용
`~/.baryon/config.json`	`apiKey` · `baseUrl` · `defaultModel` (권한 600)
`~/.pi/agent/models.json`	pi 프로바이더 정의. `baryon` 항목이 병합됨

baryon config

$ baryon config                                # 현재 설정 출력
$ baryon config --base-url https://api.baryon.ai/v1
$ baryon config --model baryon-coder        # 기본 모델 변경

#모델 · 프로바이더

기본값은 baryon.ai API. 하나의 인터페이스로 상용·로컬 모델을 정규화하며, 세션 중 /model 로 즉시 전환·비교합니다.

baryon.ai (기본)AnthropicOpenAIGoogle GeminiAzureOpenRouterGroqOllamaLM StudiovLLM

모델 목록 — baryon models 또는 세션 중 Ctrl+L.
전환·비교 — baryon --provider openai --model gpt-4o 로 같은 작업을 다른 모델에 적용.
기본 모델 — baryon config --model <id>. 정확한 모델 ID 는 기관 baryon.ai 플랜에 따릅니다.

#실행 모드 · 세션

pi 는 4가지 모드로 동작하며, 세션은 저장·분기·재개됩니다.

모드	플래그	용도
대화형	(기본)	터미널 인터랙티브
Print	`-p`	한 번 실행하고 종료 · 파이프 입력 병합
JSON	`--mode json`	이벤트를 JSON 라인으로 출력(프로세스 연동)
RPC	`--mode rpc`	프로세스 통합용 RPC

세션	플래그
직전 세션 이어가기	`-c` · `--continue`
세션 선택·재개	`-r` · `--resume`
세션 분기(fork)	`--fork <id>`
저장 안 함	`--no-session`

#오프라인 · 온프레미스

인터넷 없이도 동작합니다. 로컬 LLM 또는 기관 자체 호스팅 baryon.ai 게이트웨이로 base URL 을 바꾸면 됩니다. 학생 코드·과제 데이터가 외부로 나가지 않습니다.

로컬 LLM (Ollama · LM Studio · vLLM)

로컬 모델

$ baryon setup --base-url http://localhost:11434/v1 --key ollama

자체 호스팅 게이트웨이 (baryon-ai-api)

OpenAI 호환 게이트웨이를 교내에 올리고 그쪽으로 연결합니다. 데이터 외부 미전송, 거버넌스 강화.

on-prem

$ baryon config --base-url https://ai.your-campus.ac.kr/v1

#트러블슈팅

먼저 baryon doctor 를 실행하세요 — Node·pi·config·키·연결을 한 번에 점검합니다.

증상	원인 · 해결
`command not found: baryon`	전역 bin 경로 누락. 설치 재시도 또는 `npm bin -g` 경로를 PATH 에 추가.
`404 Not Found … @baryonlabs/cli`	오래된 npm 캐시. `npm install -g @baryonlabs/cli@latest`.
`401 Invalid API key`	키가 만료·회수됨. `baryon keys` 에서 재발급 후 `baryon config --key …`.
연결 실패 / `fetch failed`	엔드포인트 불가. `baryon config --base-url` 확인, 또는 로컬 LLM 사용. (백엔드 준비 중일 수 있음)
Node 22 미만	nodejs.org 에서 22 이상으로 업그레이드.

#FAQ

키 없이 써볼 수 있나요?

로컬 LLM(Ollama 등)으로 base URL 을 바꾸면 vibecamp.us 키 없이도 동작합니다. baryon.ai API 를 쓰려면 vc_live_ 키가 필요합니다.

기존 pi 설정을 덮어쓰나요?

아니요. baryon setup 은 ~/.pi/agent/models.json 의 다른 프로바이더를 보존하며 baryon 항목만 병합합니다.

상용 모델로 바꿀 수 있나요?

네. baryon --provider anthropic 처럼 pi 가 지원하는 모든 프로바이더로 무중단 전환됩니다.

코드는 공개인가요?

이 래퍼(@baryonlabs/cli)와 문서는 공개이며, 실제 코딩 에이전트 pi 본체는 별도로 관리됩니다.

Baryon CLI공식 문서

#개요