Bruno

Bruno는 API 요청·테스트를 로컬 파일로 관리하고 Git으로 공유하는 오픈소스 API 클라이언트입니다. macOS, Windows, Linux를 지원합니다.

어떤 작업에 쓰는 프로그램인가

Bruno는 백엔드 개발자, API 연동 담당자, QA가 요청을 보내고 응답을 검증하는 데 사용하는 데스크톱 도구다. 요청 묶음인 컬렉션을 로컬 폴더의 텍스트 파일로 저장하므로 API 변경 사항을 소스 코드와 함께 검토하기 좋다. 기본 사용에 계정 가입이나 클라우드 동기화가 필요하지 않다.

컬렉션을 오프라인에서 편집할 수 있다는 의미이지, 외부 API 호출까지 인터넷 없이 된다는 뜻은 아니다. 협업은 팀이 선택한 Git 저장소와 파일 공유 절차를 중심으로 구성한다.

지원 OS와 현재 버전

2026-10-08 확인한 공식 다운로드 페이지는 macOS, Windows, Linux를 지원하며 4.2.1을 안내한다. 입력 자료의 macOS 표기는 전체 지원 범위를 담고 있지 않다. 공식 GitHub에서도 2026-09-30 배포된 v4.2.1이 최신 릴리스로 표시된다.

4.2.1에는 스크립트 샌드박스의 경로 처리와 내부 모듈 로더 노출을 수정하는 보안 변경이 포함되어 있다. 공식 배포 기록은 전체 사용자에게 업데이트를 권고한다. 지원 종료 제품으로 볼 근거는 확인되지 않았다.

설치와 첫 요청 순서

Mac에서는 공식 다운로드 페이지에서 macOS 배포 파일을 선택하거나, 공식 안내의 Homebrew 명령인 brew install bruno를 이용한다. 배포 파일을 받을 때는 자신의 Mac CPU에 맞는 항목인지 확인한다.

앱을 열고 +에서 Create Collection을 선택해 이름과 저장 폴더를 정한다. 이어 New Request에서 HTTP 유형, GET 메서드, 테스트할 URL을 입력하고 Send를 누른다. 응답 상태 코드, 본문, 헤더를 확인한 뒤 환경을 만들고 baseUrl 같은 공통 값을 변수로 옮기면 된다. 이 순서는 공식 안내에 따른 설명이며 실제 설치·실행 경험을 전제로 하지 않는다.

실무 예시: 주문 API 회귀 확인

예를 들어 주문 서비스의 개발·검증 환경에 각각 baseUrl을 정의하고 GET {{baseUrl}}/orders/123 요청을 만든다. 인증 값은 Bearer 설정에서 참조하고, Tests에는 상태 코드가 200인지와 응답의 주문 ID가 예상값인지 검증하는 조건을 넣는다.

주문 조회·목록·잘못된 ID 조회를 한 컬렉션에 모으면 Runner로 함께 실행할 수 있다. 이후 별도 CLI 환경에서 bru run --env staging으로 같은 검증을 자동화할 수 있다. 서버 주소만 바꾸고 요청과 검증 조건은 재사용하는 방식이다.

무료판과 유료판의 선택

공식 가격표의 Open Source 요금은 0달러이며 기본 API 요청, 테스트, 스크립트 등의 기능을 제공한다. 무료판 워크스페이스는 2개, OpenAPI 동기화는 월 5회로 표시되고 Collection Runner는 무제한이다.

Pro는 연간 결제 기준 사용자당 월 6달러, Ultimate는 사용자당 월 11달러로 안내된다. 유료판은 워크스페이스와 OpenAPI 동기화 한도를 늘리고 고급 Git 작업, 조직 관리와 지원 등을 확장한다. 로컬 파일을 외부 Git 도구로 관리하는 방식과 앱 내부 Git UI의 유료 기능은 구분해서 판단해야 한다.

요청 실패와 업그레이드 점검

응답이 예상과 다르면 먼저 선택한 환경과 최종 URL을 확인하고, 이어 메서드·헤더·본문·인증 값을 살핀다. Timeline에서는 실제 전송 내용과 스크립트가 발생시킨 호출, 콘솔 출력을 함께 볼 수 있다. 변수 값이 바뀌지 않는다면 같은 이름을 가진 요청·폴더·런타임 변수가 값을 덮어쓰는지도 확인한다.

V4에서는 스크립트로 변경한 환경 변수가 기본적으로 디스크에 저장된다. 토큰을 bru.setEnvVar로 다루던 기존 스크립트는 저장 파일을 점검하고, 실행 중에만 필요한 값은 bru.setVar 사용을 검토한다. 새 형식의 컬렉션을 구버전과 공유할 때는 호환성 확인이 필요하다.

다른 도구와 고르는 기준

요청과 테스트를 프로젝트 저장소에 넣고 변경 내역을 코드 리뷰로 확인하려면 Bruno의 파일 중심 구조가 선택 이유가 된다. Postman이나 Insomnia에서 이전할 때는 가져오기 완료만으로 끝내지 말고 인증, 환경 변수, 테스트 스크립트가 같은 결과를 내는지 비교해야 한다.

단일 요청을 터미널에서 반복하는 작업은 curl 같은 도구로도 충분할 수 있다. 여러 요청을 화면에서 정리하고 테스트를 유지할 필요가 있는지, 팀이 Git 협업에 익숙한지, 앱 내부의 고급 협업 기능이 필요한지를 기준으로 선택한다.

공식 안내

Bruno - The Git-Native API Client · 확인 2026-10-08
Download Bruno - Free Open Source API Client for Windows, Mac, Linux · 확인 2026-10-08
Release v4.2.1 · usebruno/bruno · 확인 2026-10-08
API Client - Bruno Docs · 확인 2026-10-08
Bruno Tutorial: The Official Getting-Started Guide (2026) · 확인 2026-10-08
Bruno Pricing - Free API Client with Enterprise Support Options · 확인 2026-10-08
Variables - Bruno Docs · 확인 2026-10-08
Secret Variables - Bruno Docs · 확인 2026-10-08
Timeline - Bruno Docs · 확인 2026-10-08
Bruno V4 - Release Notes & Breaking Changes · 확인 2026-10-08

주요 기능

REST, GraphQL, gRPC, WebSocket, SOAP 요청 작성과 실행
OpenCollection YAML 및 기존 BRU 형식의 로컬 컬렉션 관리
환경·컬렉션·폴더·요청별 변수로 URL과 설정 재사용
Basic, Bearer, OAuth 2.0, AWS Signature 등 인증 설정
요청 전·응답 후 JavaScript 실행과 요청 연결
응답 검증 테스트와 컬렉션 일괄 실행
CLI로 같은 컬렉션을 실행하고 CI/CD에 연결
Timeline에서 실제 요청·응답과 스크립트 로그 확인
비밀 변수 값을 환경 파일과 내보내기 대상에서 제외

관련 프로그램

Tuist

tuist.io

Tuist는 Swift로 Xcode 프로젝트 구조를 정의하고 생성하며, 빌드 캐시와 테스트 분석을 연계해 개발팀의 반복 작업을 줄이는 개발 도구다.

개발macOS

Git Credential Manager

aka.ms

Git Credential Manager(GCM)는 Git의 HTTPS 인증을 처리하고 자격 증명을 보관하는 무료 오픈소스 도구다. macOS에서는 기본적으로 키체인을 사용하며, GitHub·Azure Repos·Bitbucket·GitLab 등 여러 호스팅 서비스의 인증을 지원한다. Git 명령을 실행할 때 필요한 로그인과 다중 인증을 연결해 준다.

개발macOS