프로젝트 · 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
섹션 제목: “Provider”| 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분 유휴 시 정리됩니다.
같은 폴더, 다른 Provider
섹션 제목: “같은 폴더, 다른 Provider”같은 폴더를 Claude 프로젝트와 Codex 프로젝트로 각각 등록할 수 있습니다. 그러면 채팅 헤더에 같은 폴더의 Codex 프로젝트로 전환 버튼이 생겨, 한쪽 구독 한도가 차면 한 번에 다른 쪽으로 옮겨 이어 갈 수 있습니다.
프로젝트 목록
섹션 제목: “프로젝트 목록”- Overview 카드와 왼쪽 레일은 Provider 별로 묶여 보입니다.
- 백그라운드 대화가 끝나면 레일 아이콘에 표시가 켜집니다 (응답 완료 (내 차례), 선택 대기 중).
Ctrl+.로 가장 오래 기다린 프로젝트로 이동합니다.
칸(slot)
섹션 제목: “칸(slot)”툴바의 📋 슬롯 으로 칸 목록을 열고, + 로 새 칸을 만듭니다.
| 종류 | 용도 |
|---|---|
| 💬 Chat slot | 일반 CLI 세션 하나 |
| 🎭 Orchestra slot | 여러 AI 가 역할을 나눠 진행. Ultracode · Loop · Effort 참고 |
| 🌿 격리 slot (worktree) | 전용 브랜치 · 폴더에서 병렬 작업. Worktree · Diff 리뷰 참고 |
- 칸마다 이름과 범위(에이전트에게 주는 컨텍스트 힌트, 예: “몬스터 밸런싱만”)를 적을 수 있습니다.
- 칸마다 모델 · effort · Ultracode 를 따로 고릅니다.
- 이미 응답 중인 칸이 있을 때 새 칸을 만들면, 같은 폴더에 두 세션이 동시에 쓸 수 있다는 경고가 뜹니다. 파일 충돌이 걱정되면 격리 slot 을 쓰세요.
- 칸을 지워도 대화 기록은 서버 DB 에 남습니다. 마지막 칸은 지울 수 없습니다.
여기서 분기
섹션 제목: “여기서 분기”메시지의 여기서 분기 버튼은 그 지점까지 대화를 이어받은 새 칸을 만듭니다. 원본 칸은 그대로 남고, 새 칸 헤더에는 원본 칸 이름과 계승한 메시지 수가 표시됩니다.
채팅 헤더의 세션 버튼(시계 아이콘)을 누르면 이전 세션 목록이 열립니다.
- 목록에서 고르면 그 세션을 이어서 진행합니다 (Claude 는 CLI 세션 ID 로 재개).
- 새 세션 은 컨텍스트 없이 새로 시작합니다.
/btw <질문>은 본 대화 컨텍스트로 곁 질문 에 답하고 본 작업에는 영향을 주지 않습니다 (Claude).
실행 모드 (Claude)
섹션 제목: “실행 모드 (Claude)”| 모드 | 동작 |
|---|---|
| 매번 새로 실행 | 턴마다 AI 를 새로 시작. 메모리 절약 · 안전 (기본) |
| 계속 켜두기 | AI 프로세스를 살려 두고 매 턴 재사용. 응답이 빠르고 백그라운드 도구가 유지됨 |
프로젝트 설정의 실행 모드 나 Settings > 모델 · 계정 의 세션 계속 켜두기 모드 에서 고릅니다. Unity · MCP · 이미지 생성 도구를 자주 쓰면 계속 켜두기를 권장합니다. 채팅 헤더에서 대화 중에 전환할 수도 있으며, 이때 실행 중이던 도구 호출은 취소되고 대화 기록은 유지됩니다.