콘텐츠로 이동

프로젝트 · Provider · 세션

AgentManager 의 기본 단위는 세 가지입니다.

단위 뜻
프로젝트 로컬 폴더 하나 + 그 폴더를 맡을 AI(Provider) 하나
칸(slot) 한 프로젝트 안에서 동시에 여는 대화 자리. 칸마다 대화가 따로 돈다
세션 칸 하나에 이어지는 대화 기록. 새 세션을 시작하거나 이전 세션으로 돌아갈 수 있다

Overview 의 + Add Project 를 누르면 프로젝트 추가 창이 열립니다.

항목 설명
Provider 이 프로젝트를 맡을 AI. 아래 표 참고
Directory Path 작업 폴더. git 저장소가 아니어도 됩니다
Name 표시 이름 (100자 이내)
Rail 라벨 (선택) 왼쪽 사이드바 아이콘 글자. 비우면 이름 앞 2글자
실행 모드 Claude 전용. 아래 “실행 모드” 참고
신뢰 레벨 AI 가 파일·셸을 자동으로 쓸 권한. 새 프로젝트는 꼭 골라야 합니다
설명 (선택) 500자 이내
예산 상한 달러 기준. 프로젝트 누적 비용이 80% · 90% · 100% 를 넘을 때 경고만 하고 멈추지는 않습니다. 0 이면 끔. 비용이 기록되는 Claude 대화에만 적용
Dev 서버 URL Claude 전용. 프론트 파일을 바꾼 턴에서 이 주소를 열어 스크린샷으로 결과를 확인합니다. localhost 만 허용

등록한 프로젝트는 수정 창에서 이름 · 설명 · 시스템 프롬프트 · 태그 등을 나중에 바꿀 수 있습니다.

레벨 허용 범위
안전 읽기/검색만. 파일 편집 X, 셸 X
표준 파일 편집 허용, 셸(명령 실행) X
전체 허용 셸 포함 모든 도구 자동 승인. 자기 프로젝트에만

위 표는 Claude 내장 도구 기준입니다. 사용자가 연결한 MCP 서버의 도구는 신뢰 레벨로 막지 않습니다. Codex 는 CLI 샌드박스로 바꿔 적용합니다. 안전은 읽기 전용 샌드박스(명령은 실행할 수 있지만 파일을 못 씀), 표준 · 전체 허용은 둘 다 작업 폴더 쓰기 허용(workspace-write)입니다.

낯선 프로젝트는 안전이나 표준, 직접 관리하는 프로젝트는 전체 허용이 기준입니다.

Provider 모델 비고
Claude Fable · Opus · Sonnet · Haiku Effort · Ultracode · 실행 모드 · /btw 지원
Codex GPT-6.1 Sol · GPT-6 Astra · GPT-5.6 등 ChatGPT 구독. Effort 지원
Grok Grok Build ACP 에이전트. SuperGrok 구독
Gemini Gemini CLI ACP 에이전트
ACP 직접 등록한 ACP 에이전트 커스텀

Grok · Gemini · 커스텀 ACP 는 모델 목록을 첫 턴에 에이전트에서 받아 옵니다. 실행 모드 · 예산 상한은 적용되지 않고, 파일 편집 · 셸 권한은 신뢰 레벨로 판정합니다. 단, 에이전트 CLI 를 전부 자동 승인(always-approve)으로 설정했다면 CLI 가 먼저 승인해 신뢰 레벨이 무시될 수 있습니다. 에이전트 프로세스는 대화 중에는 유지되고 30분 유휴 시 정리됩니다.

같은 폴더를 Claude 프로젝트와 Codex 프로젝트로 각각 등록할 수 있습니다. 그러면 채팅 헤더에 같은 폴더의 Codex 프로젝트로 전환 버튼이 생겨, 한쪽 구독 한도가 차면 한 번에 다른 쪽으로 옮겨 이어 갈 수 있습니다.

  • Overview 카드와 왼쪽 레일은 Provider 별로 묶여 보입니다.
  • 백그라운드 대화가 끝나면 레일 아이콘에 표시가 켜집니다 (응답 완료 (내 차례), 선택 대기 중).
  • Ctrl+. 로 가장 오래 기다린 프로젝트로 이동합니다.

툴바의 📋 슬롯 으로 칸 목록을 열고, + 로 새 칸을 만듭니다.

종류 용도
💬 Chat slot 일반 CLI 세션 하나
🎭 Orchestra slot 여러 AI 가 역할을 나눠 진행. Ultracode · Loop · Effort 참고
🌿 격리 slot (worktree) 전용 브랜치 · 폴더에서 병렬 작업. Worktree · Diff 리뷰 참고
  • 칸마다 이름과 범위(에이전트에게 주는 컨텍스트 힌트, 예: “몬스터 밸런싱만”)를 적을 수 있습니다.
  • 칸마다 모델 · effort · Ultracode 를 따로 고릅니다.
  • 이미 응답 중인 칸이 있을 때 새 칸을 만들면, 같은 폴더에 두 세션이 동시에 쓸 수 있다는 경고가 뜹니다. 파일 충돌이 걱정되면 격리 slot 을 쓰세요.
  • 칸을 지워도 대화 기록은 서버 DB 에 남습니다. 마지막 칸은 지울 수 없습니다.

메시지의 여기서 분기 버튼은 그 지점까지 대화를 이어받은 새 칸을 만듭니다. 원본 칸은 그대로 남고, 새 칸 헤더에는 원본 칸 이름과 계승한 메시지 수가 표시됩니다.

채팅 헤더의 세션 버튼(시계 아이콘)을 누르면 이전 세션 목록이 열립니다.

  • 목록에서 고르면 그 세션을 이어서 진행합니다 (Claude 는 CLI 세션 ID 로 재개).
  • 새 세션 은 컨텍스트 없이 새로 시작합니다.
  • /btw <질문> 은 본 대화 컨텍스트로 곁 질문 에 답하고 본 작업에는 영향을 주지 않습니다 (Claude).
모드 동작
매번 새로 실행 턴마다 AI 를 새로 시작. 메모리 절약 · 안전 (기본)
계속 켜두기 AI 프로세스를 살려 두고 매 턴 재사용. 응답이 빠르고 백그라운드 도구가 유지됨

프로젝트 설정의 실행 모드 나 Settings > 모델 · 계정 의 세션 계속 켜두기 모드 에서 고릅니다. Unity · MCP · 이미지 생성 도구를 자주 쓰면 계속 켜두기를 권장합니다. 채팅 헤더에서 대화 중에 전환할 수도 있으며, 이때 실행 중이던 도구 호출은 취소되고 대화 기록은 유지됩니다.