설정 레퍼런스
설정의 각 항목을 정리합니다.
이 페이지
설정에서는 앱 동작, 모델, 확장 기능, 시스템 정보를 관리합니다. 섹션과 항목은 앱에 표시되는 순서를 따르며, 따로 설명한 문서가 있는 항목은 그 문서로 연결합니다.
설정 열기
- 사이드바에서 설정을 누릅니다. 명령 팔레트(⌘K)에서 설정 항목을 찾아 열 수도 있습니다.
- 왼쪽 목록에서 섹션을 고릅니다.
- 항목을 바꿉니다.
- 설정 검색에 입력하면 섹션 이름, 설명, 별칭으로 섹션을 거릅니다. 일치하는 섹션이 하나뿐이면 바로 열립니다.
- 대부분의 항목은 바꾸는 즉시 저장되고 저장됨 알림이 나타납니다. 개인화는 적용을 눌러야 저장됩니다.
- 돌아가기를 누르거나 Esc를 누르면 설정을 닫습니다.
섹션은 세 그룹으로 나뉩니다.
| 그룹 | 섹션 |
|---|---|
| 환경 설정 | 일반, 모양, 개인화 |
| 모델 및 확장 기능 | 모델, MCP, 스킬 |
| 앱 및 시스템 | 서버, 업데이트, 사용량, 로그, 개인정보, 시스템 이벤트, 아카이브, 정보 |
일반
언어, 시간대, 대화 입력, 알림, 웹 검색의 기본값을 설정합니다.
| 영역 | 항목 | 설명 |
|---|---|---|
| 언어 및 지역 | 언어 | 앱 인터페이스 언어입니다. 영어 또는 한국어를 고릅니다. |
| 시간대 | Butler가 현재 시간과 일정 맥락을 해석할 때 쓰는 시간대입니다. 목록에서 검색해 고릅니다. | |
| 대화 입력 | 후속 요청 처리 | Butler가 작업 중일 때 보낸 메시지를 다루는 방식입니다. 작업 중이면 대기열에 추가 또는 현재 작업 방향 조정을 고릅니다. |
| 메시지 보내기 | Command/Ctrl Enter 전송, Enter 줄바꿈 또는 Enter 전송, Shift Enter 줄바꿈을 고릅니다. 보내기 키를 참고합니다. | |
| 알림 | 데스크톱 알림 | 앱이 뒤에 있을 때 새 답변이나 작업 완료를 운영체제 알림으로 보냅니다. |
| AI 메시지 알림 | 새 답변이 도착하면 알립니다. 알림에는 안전한 미리보기만 표시합니다. | |
| 작업 완료 알림 | 작업이 완료, 실패, 취소되면 알립니다. | |
| 알림 권한 | OS 알림 상태 | 운영체제 알림 권한 상태입니다. 테스트로 테스트 알림을 보냅니다. 운영체제 알림 설정을 열 수 있는 환경에서는 그 설정을 여는 버튼도 표시됩니다. |
| 앱 동작 | 트레이 및 메뉴바에 표시 | 켜면 창을 닫아도 앱이 트레이 또는 메뉴바에 남고, 메뉴에서 새 대화와 최근 대화를 열 수 있습니다. |
| 검색 공급자 | 검색 제공자 | 웹 검색 결과를 가져올 곳입니다. DuckDuckGo HTML, 자동, Brave Search, Tavily, OpenAI Web Search, Codex 구독 검색, 비활성화 중에서 고릅니다. 키가 필요한 제공자에 키가 없으면 기본 검색으로 내려갑니다. |
| API 키 | 키가 필요한 제공자를 고르면 나타납니다. 키를 입력하고 저장을 누르면 비밀값으로 저장되며 화면에 다시 표시하지 않습니다. | |
| 검색 동작 | 페이지 읽기 | 검색 결과 원문을 읽을 리더입니다. 경량 리더, 자동, Lightpanda, Jina Hosted, 비활성화 중에서 고릅니다. |
| 스마트 검색계획 사용 | 켜면 검색 전에 모델을 한 번 호출해 의도, 깊이, 검증 필요성, 쿼리 묶음을 계획합니다. | |
| 기본 검색 깊이 | 스마트 검색계획 사용을 켰을 때만 보입니다. 빠르게, 균형, 깊게 중에서 고릅니다. |
모양
앱의 테마와 화면 표시 방식을 설정합니다.
| 영역 | 항목 | 설명 |
|---|---|---|
| 테마 | 테마 | 시스템, 라이트, 다크 중에서 고릅니다. |
| 투명 사이드바 | 사이드바를 반투명하게 표시합니다. | |
| 사이드바 | 스마트 그룹 | 새 대화를 같은 주제의 그룹으로 자동 정리합니다. 직접 옮긴 대화는 그대로 둡니다. |
| 홈 화면 | 메인화면 테마 | 새 채팅 첫 화면의 배경입니다. 없음, Bloom, Silk 중에서 고릅니다. |
| 배경 색상 | 메인화면 테마가 Bloom일 때 보입니다. Monochrome, Aurora, Bloom, Lavender, Morning, 직접 지정 중에서 고릅니다. | |
| 사용자 지정 색상 | 배경 색상이 직접 지정일 때 보입니다. 배경에 쓸 색을 하나씩 고릅니다. |
개인화
Butler가 쓸 이름, 말투, 사용자 정보를 관리합니다. 다른 섹션과 달리 바꾼 뒤 적용을 눌러야 저장됩니다. 항목별 설명은 개인화를 참고합니다.
| 영역 | 항목 |
|---|---|
| 프로필 | 버틀러 닉네임, 내 이름, 나를 부를 호칭 |
| 응답 스타일 | 답변 언어, 페르소나 프리셋, 페르소나, EOL |
| 학습 | 사용자 정보 분석, 사용자 정보 분석 모델, 추론 |
| 가져오기 | 외부 AI 기억 가져오기 |
| 화면 아래 | 프로필 데이터 삭제 |
모델
Butler와 Worker가 쓸 모델, 예비 모델, 권한을 관리합니다.
| 영역 | 항목 | 자세히 |
|---|---|---|
| 버틀러 모델 | 모델, 모델 관리, 추론, 컨텍스트 한도, 로컬 추론 예산 | 클라우드 모델, Custom 모델 |
| 예비·정리 모델 | 예비 모델 사용, 예비 모델 추가, 대화 기억 정리 모델, 추론 | 예비 모델 |
| 권한 | 접근 권한, 기본으로 계획 모드 사용 | 대화와 컴포저 |
| Worker 프로필 | 최대 동시 Worker 수, Worker 프로필 추가, 프로필별 항목 | 아래 표 |
접근 권한의 기본값은 먼저 확인입니다.
Worker 프로필에서는 Butler가 작업을 맡길 Worker를 정합니다.
| 항목 | 설명 |
|---|---|
| 최대 동시 Worker 수 | 동시에 실행할 Worker 수입니다. 1부터 10까지 입력합니다. |
| Worker 프로필 추가 | 프로필을 추가합니다. 최대 12개까지 등록합니다. |
| 이름, 사용 | 프로필 이름과 사용 여부입니다. 기본 프로필은 끄거나 삭제할 수 없습니다. |
| 작업, 사용자 지정 작업 | 코딩, 리서치, 디버깅, 리뷰, 글쓰기, 사용자 지정 중에서 고릅니다. 사용자 지정이면 작업을 직접 적습니다. |
| 도메인, Worker 프롬프트 | 프로필이 맡을 분야와 Worker에게 줄 지시입니다. 비워 둘 수 있습니다. |
| 모델, 추론 | 이 프로필이 쓸 모델과 추론 강도입니다. |
MCP
외부 MCP 서버와 연결 정보를 관리합니다. MCP 서버 추가로 서버를 등록하고, 서버마다 연결 확인, 활성화 / 비활성화, 수정, 삭제를 씁니다. 항목별 설명은 MCP 서버를 참고합니다.
스킬
기본 스킬과 프로젝트 스킬을 관리합니다. 기본 탭과 프로젝트 탭에서 스킬 목록을 보고, 가져오기나 대화해서 만들기로 스킬을 추가합니다.
서버
Butler 서버 연결과 새 프로젝트 폴더를 설정합니다.
| 영역 | 항목 | 설명 |
|---|---|---|
| 연결 | 서버 URL | Butler 서버 주소입니다. 입력란에서 벗어나면 저장됩니다. |
| 프로젝트 | 기본 프로젝트 폴더 | 새 프로젝트에 쓸 기본 폴더입니다. 현재 폴더가 표시되고, 폴더 선택으로 바꿉니다. |
업데이트
Butler의 새 버전을 확인하고 내려받습니다.
| 항목 | 설명 |
|---|---|
| 확인 | 새 버전이 있는지 확인합니다. 확인하는 동안 확인 중으로 표시됩니다. |
| 버틀러 | 현재 버전과 앱에 포함된 Butler Agent 버전을 보여 줍니다. 새 버전이 있으면 현재 버전 -> 새 버전으로 표시합니다. |
| 업데이트 | 새 버전이 있을 때 누릅니다. 새 버전의 DMG를 내려받아 체크섬을 확인한 뒤 엽니다. 진행하는 동안 적용 중, 새 버전이 없으면 최신으로 표시되고 누를 수 없습니다. |
macOS에서는 직접 설치합니다
업데이트는 새 버전을 자동으로 설치하지 않습니다. Butler를 종료한 뒤, 열린 DMG에서 Butler.app을 응용 프로그램 폴더로 끌어다 놓아 기존 앱을 바꿉니다.
사용량
모델 토큰, 프롬프트 캐시, 웹 검색, 도구 호출을 확인합니다. 컨텍스트 창 용량과는 별도로 기록됩니다.
| 항목 | 설명 |
|---|---|
| 개요 | 전체 사용량 요약입니다. 24시간, 7일, 전체 중에서 기간을 고르고, 새로고침으로 다시 불러옵니다. |
| API 프로바이더 사용량 | 제공자별 사용량과 잔여량입니다. |
| 스코프별 토큰 | 스코프별 토큰 사용량입니다. |
| 모델별 토큰 | 모델별 토큰 사용량입니다. |
| 컨텍스트 섹션별 추정 | 프롬프트 섹션별 추정 토큰입니다. 많은 순으로 12개까지 표시합니다. |
| 도구별 호출 | 도구별 호출 수입니다. 많은 순으로 8개까지 표시합니다. |
로그
개발자 모드에서 모델 요청과 응답 로그를 확인합니다. 정보의 개발자 모드와 개인정보의 진단이 모두 켜져 있을 때만 섹션 목록에 나타납니다.
- 위쪽 입력란으로 모델, 세션, 섹션, 응답을 검색하고, 세션 ID로 거릅니다.
- 종류 선택에서 전체, 모델 턴, 실패한 모델 턴 중 하나를 고릅니다. 새로고침으로 다시 불러옵니다.
- 로그를 펼치면 컨텍스트, 요청, 응답, 메타데이터 탭으로 내용을 봅니다.
- 더보기로 로그를 30개씩 더 불러옵니다.
개인정보
진단 정보 수집을 설정합니다.
- 진단 — 켜면 모델 요청과 응답을 개발자 로그로 기록합니다. 로그는
~/.butler/app/developer-logs/model-turns.jsonl에 저장됩니다. 끄면 로그 섹션이 사라집니다. 로그를 읽는 방법은 문제 해결을 참고합니다.
시스템 이벤트
정기 정리, 사용자 정보 분석, 유지보수 작업이 언제 어떻게 끝났는지 확인합니다.
- 이벤트 종류는 대화 기억 정리, 사용자 정보 분석, 대화 기록 반영, 컨텍스트 정리, 정기 기억 정리입니다.
- 상태는 성공, 완료, 실패, 실행 중, 아직 실행 전, 상태 확인 필요 중 하나로 표시됩니다.
- 새로고침으로 다시 불러오고, 더보기로 20개씩 더 불러옵니다.
아카이브
보관한 프로젝트와 대화를 복원하거나 삭제합니다.
- 아카이브 취소 — 항목을 보관에서 꺼내 원래 목록으로 되돌립니다.
- 삭제 — 확인 창에서 삭제를 누르면 항목을 영구 삭제합니다.
- 더보기 — 20개씩 더 불러옵니다.
정보
Butler 버전과 앱 정보를 확인합니다.
- 앱 정보 — 앱 이름, 버전, GitHub 저장소, 프로토콜을 보여 줍니다.
- 개발자
- 개발자 모드 — 켜면 DevTools 창이 열리고, 이 앱 창에서 Chrome DevTools를 쓸 수 있습니다. 끄면 Electron 기본 메뉴와 DevTools 단축키가 차단됩니다. 켜고 끌 때 개인정보의 진단도 함께 바뀝니다.
주의 사항
- 아카이브에서 삭제한 프로젝트와 대화는 되돌릴 수 없습니다.
- 진단을 켜 두면 모델 요청과 응답이 로컬 로그 파일에 계속 기록됩니다. 필요할 때만 켭니다.
- 로그 섹션을 보는 중에 개발자 모드나 진단을 끄면 정보 섹션으로 이동합니다.
- 개인화에서 바꾼 내용은 적용을 누르기 전까지 저장되지 않습니다.