Baze CLI

baze 는 베이즈 Gateway 를 터미널에서 쓰는 CLI 입니다.

Node.js 20.10 이상이 필요합니다.

설치하지 않고 한 번만 써 보려면 npx @mindlogic-ai/baze models 처럼 실행합니다. 새 버전은 baze update 로 받습니다.

API 키를 붙여 넣으면 서버에서 확인한 뒤 ~/.baze/credentials.json (권한 0600) 에 저장합니다. 키 발급은 인증 가이드를 참고하세요.

CI·컨테이너처럼 입력을 받을 수 없는 곳에서는 키를 파이프로 넘깁니다.

키가 어느 서버 것인지는 키에서 읽습니다. 이전 형식(32자) 키는 AWS 가 기본이므로 NCP 라면 baze login 을 한 번 하세요. 온프레미스 서버는 --host https://… 로 지정합니다. CI 에서는 환경 변수 BAZE_API_KEY 를 두면 저장된 키보다 먼저 쓰입니다. 지금 쓰이는 키와 서버는 baze auth 로 확인하고, 키를 지우려면 baze logout(서버에서도 끄려면 --revoke)입니다.

이미 설치된 도구를 Gateway 와 키로 연결해 실행합니다. 설정은 실행하는 동안에만 전달되고 디스크에 아무것도 쓰지 않습니다. 종료 코드는 도구의 것을 그대로 돌려줍니다.

--model 과 --dry-run(baze codex 는 --reasoning-effort 까지) 외의 인자는 모두 도구에 그대로 전달됩니다.

--model 은 baze models 가 보여 주는 전체 ID 를 받습니다. 어떤 모델이 어느 명령에 맞는지도 baze models 가 보여 줍니다.

매번 baze 를 붙이지 않고 claude 만으로 쓰려면 baze setup claude(또는 codex, opencode)로 설정을 영구히 씁니다. 기존 파일은 먼저 백업합니다. Claude Code 는 ~/.claude/settings.json 에 API 키가 평문으로 들어가므로 여러 사람이 쓰는 컴퓨터에서는 baze claude 를 쓰세요. Codex·OpenCode 는 BAZE_API_KEY 변수 이름만 기록되므로 셸 시작 파일에 eval "$(baze env)" 를 넣습니다.

baze setup hermes 는 아직 없습니다. Hermes 는 환경 변수의 키를 그 키를 발급한 호스트에만 보내기 때문에, baze hermes 는 키를 MINDLOGIC_API_KEY(AWS) 또는 BAZE_API_KEY(NCP)로 CUSTOM_BASE_URL 과 함께 넘깁니다. ~/.hermes/.env 에 같은 변수가 있으면 그 값이 우선하고, baze 가 경고를 띄웁니다. Hermes 를 직접 설정하려면 Hermes Agent 를 보세요.

baze usage 는 /usage 를, baze logout --revoke 는 /keys/revoke 를 부릅니다.

결과 파일은 현재 폴더에 저장되고 경로와 차감된 크레딧이 출력됩니다. 모델이 받는 옵션은 --params 로 확인하고, --set 값은 보내기 전에 검사됩니다.

호출하기 전에 금액만 알고 싶다면 --estimate 를 붙입니다. 아무것도 생성하지 않고 과금되지 않습니다.

비디오는 끝날 때까지 기다립니다. 네트워크 오류나 Ctrl-C 로 멈춰도 이미 과금된 작업은 baze gen wait <id> 로 이어서 받을 수 있고, baze history 는 이 컴퓨터에서 한 모든 생성과 파일을 보여 줍니다.

rerank 는 첫 인자가 질문이고 나머지가 문서입니다. 관련도 순으로 점수와 원래 순서를 보여 줍니다. guard 는 기본으로 찾은 개인정보를 [PHONE] 처럼 가린 문장을 출력합니다. 세 명령 모두 마지막 줄에 차감된 크레딧을 보여 주고, 전체 결과는 --json 으로 받습니다.

베이즈 가 제공하는 MCP 도구(공휴일, 법령, 공시, 논문 검색 등)를 터미널에서 바로 호출합니다. 결과는 도구가 돌려준 그대로 출력되고, --json 을 붙이면 원본 결과를 출력합니다. 다른 MCP 클라이언트에서 직접 연결하려면 MCP API를 보세요.

스튜디오에서 만든 챗봇을 그 챗봇의 프롬프트·지식·워크플로·도구 그대로 호출합니다. 챗봇 설정에서 API 접근이 켜져 있어야 합니다. 챗봇 ID 와 이 설정은 챗봇 채팅 API를 참고하세요. 서버는 대화를 기억하지 않으므로, 이어서 묻고 싶다면 --continue 로 이 컴퓨터의 직전 대화를 함께 보냅니다. 챗봇이 만든 파일은 --save 로 현재 폴더에 받습니다.

Claude Code 와 Codex 에 baze 스킬을 설치합니다. 에이전트가 직접 이미지·비디오·음성을 만들고(baze gen), 임베딩·재정렬·개인정보 검사(embed·rerank·guard), MCP 도구(mcp), 스튜디오 챗봇(bot)을 호출하며, 비싼 호출 전에는 --estimate 로 비용을 먼저 확인합니다. 설치 상태는 baze skill status 로 보고, baze 를 업데이트한 뒤에는 다시 설치하세요. 다른 에이전트라면 baze skill show 가 출력하는 내용을 그 에이전트의 스킬(또는 시스템 프롬프트)로 넣으면 됩니다.

전체 명령은 baze help, 한 명령의 도움말은 baze help <명령> 입니다.