개요
활성 프로젝트는 각 사용자가 "지금 작업 중인" 프로젝트를 한 개 지정하는 계정 설정입니다. Claude Code의 context-capture Skill이나 MCP 도구 호출은 항상 이 활성 프로젝트를 기준으로 동작하므로, 캡처된 커밋 의도와 리포트가 의도한 프로젝트에 정확히 귀속됩니다.
참여 중인 프로젝트가 여러 개라도 활성 프로젝트는 한 번에 하나만 지정할 수 있습니다.
어디에 표시되나요
콘솔 상단 우측에 작은 배지로 항상 노출되어, 지금 어떤 프로젝트를 기준으로 CLI가 동작하는지 한눈에 확인할 수 있습니다.
Console header
Active: agentharness
No active project
상태표시
활성 프로젝트 설정됨녹색 점과 함께 "활성: {프로젝트명}"이 노출됩니다. 클릭하면 전환 드롭다운이 열립니다.
활성 프로젝트 없음주황색 경고 배지로 "활성 프로젝트 없음"이 노출됩니다. 이 상태에서는 CLI 캡처가 라우팅되지 않습니다.
계정 설정계정 설정 모달의 "활성 프로젝트" 섹션에서도 현재 값을 확인하고 변경할 수 있습니다.
전환 방법
배지 드롭다운은 빠른 전환용이고, 계정 설정은 전체 관리용입니다. 두 방식 모두 변경 전 확인 모달이 한 번 뜹니다.
1콘솔 헤더의 활성 배지를 클릭해 드롭다운을 엽니다. 참여 중인 프로젝트 목록이 보입니다.
2전환할 프로젝트를 선택하면 "앞으로의 캡처·리포트는 해당 프로젝트에 귀속됩니다" 확인 모달이 뜹니다.
3변경을 확정하면 즉시 활성 프로젝트가 바뀌고, 이후 모든 캡처·리포트는 새 프로젝트로 라우팅됩니다.
전환은 분당 최대 30회까지 허용되며, 참여 중이 아닌 프로젝트로는 전환할 수 없습니다.
왜 중요한가요
CLI는 단일 API 키로 여러 프로젝트에 접근할 수 있지만, 각 호출이 어느 프로젝트로 향해야 하는지는 활성 프로젝트 값으로 결정됩니다.
01
컨텍스트 캡처
context-capture Skill이 커밋 직후 만든 Timeline Entry는 활성 프로젝트의 타임라인에 쌓입니다.
02
인사이트 리포트
일별 요약·세션 요약·세션 비교 등 MCP 기반 리포트는 활성 프로젝트에 저장됩니다.
03
안전장치
활성 프로젝트가 없으면 CLI 호출은 저장되지 않고 거부되어, 엉뚱한 프로젝트로 캡처가 섞이는 것을 방지합니다.
자동 동작
활성 프로젝트는 일상적인 흐름에서 자동으로 유지되도록 설계되었습니다.
··
새 프로젝트 생성프로젝트를 직접 만들면 생성 직후 활성 프로젝트가 해당 프로젝트로 전환됩니다.
프로젝트 합류초대를 수락해 프로젝트에 참여하면 활성 프로젝트가 비어있을 때 자동으로 채워집니다.
접근 권한 상실활성 프로젝트에서 제거되면 최근에 접근한 다른 프로젝트로 자동 리셋됩니다. 대안이 없으면 "활성 프로젝트 없음" 상태로 전환됩니다.
API Key 재발급API Key와 활성 프로젝트는 독립적으로 관리됩니다. 키를 재발급해도 활성 프로젝트 값은 유지됩니다.