문서 / 핵심 개념
AI 스테이징
AI 스테이징 채팅 패널에서 원하는 작업 환경을 설명하세요. 특정 앱, 윈도우, 스테이지, 모니터를 @로 언급할 수도 있습니다. 그러면 AI가 열려 있는 윈도우(제목, URL, 파일 경로)를 분석해 스테이지 구성안을 제안하며, 이를 검토, 수정, 적용하거나 한 번에 실행 취소(패널에서 Cmd-Z)할 수 있습니다. Pro 라이선스에서 직접 AI 제공자 키를 사용하거나, API 키와 설정이 필요 없는 관리형 구독인 BetterStage AI를 이용하세요.
작동 방식
AI 스테이징은 모든 모니터의 열려 있는 윈도우를 모두 검사하고, 메타데이터(앱 이름, 윈도우 제목, 문서 경로, URL)를 수집해 AI 모델로 보냅니다. 모델은 직접 연결한 제공자(내 API 키 사용)이거나, BetterStage AI를 구독한 경우 BetterStage의 관리형 서비스입니다. 모델은 이름을 붙인 스테이지를 만들고 각 윈도우를 알맞은 스테이지와 모니터에 할당하는 구성안을 돌려줍니다.
- 검사 — BetterStage가 열려 있는 모든 윈도우의 제목, 문서 경로, URL, 앱 이름을 읽습니다.
- 분석 — 데이터가 AI 제공자로 전송됩니다. 직접 연결한 제공자이거나, BetterStage AI 구독 시 BetterStage의 관리형 서비스입니다. 채팅 패널에 진행 상황이 실시간으로 표시되며, 제안된 동작은 어시스턴트 응답에 첨부된 상태로 유지됩니다.
- 검토 및 적용 — 새 스테이지가 만들어지고 각 윈도우가 스테이지마다 알맞은 모니터에 할당됩니다. BetterStage는 그곳에 묶인 윈도우에 맞게 모니터마다 윈도우 모드(향상된 기본 모드 또는 TabStack)도 선택하며, 요청에서 특정 모드를 지정할 수도 있습니다. 적용 전에 구성안을 수정할 수 있고, 적용한 후에는 적용된 변경 전체를 실행 취소할 수 있습니다.
AI 스테이징 실행하기
AI 스테이징을 실행하는 방법은 네 가지입니다.
- 키보드 단축키 — Opt+Z(유럽식 배열: Ctrl+Opt+Z) 또는 설정 > 단축키에서 직접 지정한 단축키를 누르세요.
- 메뉴 막대 — BetterStage 메뉴 막대 아이콘을 클릭하고 AI 스테이징…을 선택하세요.
- 스냅 휠 — 스냅 휠을 열고 워크스페이스 서브메뉴에서 AI 스테이징을 선택하세요.
- 설정 — 설정 > AI 스테이징을 열어 제공자를 구성한 다음 그곳에서 실행하세요.
제공자 설정
내 API 키를 사용하면 AI 스테이징이 제공자와 직접 통신하며, 어떤 데이터도 BetterStage 서버를 거치지 않습니다. (BetterStage AI 구독을 이용하면 요청이 대신 BetterStage의 관리형 서비스를 거치며, 키가 필요 없습니다.) 제공자는 설정 > AI 스테이징에서 구성하세요. BetterStage에는 25개의 제공자 프리셋이 포함되어 있습니다: OpenAI, Claude (Anthropic), Google Gemini, OpenRouter, Groq, Together AI, Mistral, xAI (Grok), DeepSeek, Moonshot (Kimi), Zhipu (GLM), Alibaba Qwen, MiniMax, Tencent Hunyuan, ByteDance Doubao, NVIDIA NIM, Hugging Face, Azure OpenAI 등이며, Ollama와 LM Studio 같은 로컬 서버도 지원합니다.
- 실시간 모델 목록 — 프리셋을 고르면 BetterStage가 내 키로 실제 사용할 수 있는 모델을 불러옵니다.
- 지역 선택 — 지역별 엔드포인트가 있는 제공자(Qwen, Moonshot, Zhipu, MiniMax, SiliconFlow)는 중국 내 기본 URL과 국제 기본 URL 사이에서 전환할 수 있습니다.
- 제공자별 API 키 — 제공자마다 자체 키를 기억하므로 프리셋을 바꿔도 키를 잃지 않습니다.
- 사용자화 엔드포인트 — 사용자화 (OpenAI 호환) 프리셋에는 프록시나 자체 호스팅 서버 등 어떤 기본 URL과 모델 이름이든 입력할 수 있습니다.
| 제공자 | 기본 모델 | 인증 |
|---|---|---|
| OpenAI | gpt-4.1-mini | API 키 (Bearer 토큰) |
| Claude (Anthropic) | claude-sonnet-4-6 | API 키 (x-api-key 헤더) |
| Ollama (로컬) | 설치한 모델 | 없음 (localhost) |
| 사용자화 (OpenAI 호환) | 모두 | API 키 (Bearer 토큰) |
나머지 22개 프리셋도 같은 OpenAI 호환 방식을 따르며, 기본 URL과 기본 모델이 미리 입력되어 있습니다.
연결 테스트
설정 > AI 스테이징에는 구성한 모델에 실제 채팅 메시지를 보내는 연결 테스트 버튼이 있어, 사용하기 전에 엔드포인트, 키, 모델이 모두 제대로 작동하는지 확인할 수 있습니다. 설정 문제는 요청 전에 미리 감지되어, 제공자의 원본 오류 대신 명확한 메시지와 설정 열기 버튼이 표시됩니다.
저장된 레시피
레시피는 작업 공간을 어떻게 배치할지 저장해 둔 지침입니다. 코딩, 디자인 검토, 고객 지원, 글쓰기 등 반복하는 작업 흐름마다 레시피를 따로 만들어 두세요. AI 스테이징 패널에서 레시피를 전환하고, 새로 만들고, 기존 레시피를 복제하거나 이름을 바꾸고, 오래된 레시피를 삭제하고, 새 세션에 사용할 기본 레시피를 선택할 수 있습니다.
AI 스테이징을 실행하면 선택한 레시피가 함께 포함됩니다. 실시간 채팅과 같은 @ 언급 칩(모니터, 스테이지, 윈도우, 앱, 윈도우 모드)으로 레시피를 편집하고, 모델에 전송되는 프롬프트를 그대로 미리 보고, 패널에서 바로 배치를 실행할 수 있습니다.
레시피 메모 예시:
- “채팅 앱과 음악은 작은 보조 모니터에 배치. 프로젝트 문서가 열린 브라우저 탭은 에디터 옆에 유지.”
- “Slack, Discord, 이메일용 소통 스테이지는 항상 생성.”
- “가능하면 고객사 이름별로 묶기.”
전송되는 데이터
AI 스테이징은 작업 공간 스냅샷을 AI 모델로 보냅니다. 내 API 키를 사용하면 스냅샷이 제공자에게 바로 전송되며 BetterStage 서버는 이를 보지 않습니다. BetterStage AI 구독을 이용하면 BetterStage의 관리형 서비스를 거칩니다. 스냅샷에는 다음이 포함됩니다.
- 윈도우 메타데이터 — 앱 이름, 윈도우 제목, 문서 파일 경로, 콘텐츠 URL(호스트 + 경로)
- 모니터 배치 — 디스플레이 이름, 배열 순서, 프레임 경계, 주/보조 디스플레이 여부
- 시스템 제약 조건 — 최대 스테이지 수, 스테이지당 최대 윈도우 수
파일 내용, 스크린샷, 키 입력은 전송되지 않습니다. 다만 윈도우 제목, 파일 경로, URL에 민감한 프로젝트나 문서 이름이 포함될 수 있으므로 신뢰할 수 있는 제공자를 선택하세요.
요구 사항
- Pro 라이선스 — AI 스테이징은 Pro 기능입니다.
- AI 제공자 — 지원되는 25개 제공자 중 하나(또는 OpenAI 호환 엔드포인트)의 내 API 키, 또는 키 없이 AI를 대신 실행해 주는 BetterStage AI 구독이 필요합니다.
- 인터넷 연결 — 클라우드 제공자를 사용할 때 필요합니다. 로컬 서버(Ollama, LM Studio)는 오프라인에서도 작동합니다.