설정 열기
콘솔의 좌측 사이드바에서 대상 프로젝트를 선택한 뒤, 프로젝트 헤더의 '설정' 항목을 누르면 프로젝트 설정 화면이 열립니다. 진입 시 자동으로 '일반' 탭으로 이동합니다.
화면 구성
좌측에 탭 네비게이션, 우측에 선택된 탭의 상세 내용이 표시됩니다. 각 탭은 사용자의 역할과 권한에 따라 자동으로 활성/비활성되며, 권한이 없는 탭에 직접 URL로 접근하면 접근 가능한 다른 탭으로 리다이렉트됩니다.
프로젝트 메타데이터(이름·설명)를 편집하고, Owner 한정으로 프로젝트를 삭제할 수 있습니다.
프로젝트 멤버 목록과 역할을 확인하고, 초대·역할 변경·제거·탈퇴를 처리합니다.
Claude Code가 프로젝트와 통신할 때 사용하는 API Key를 발급·폐기합니다.
일반
프로젝트의 메타데이터를 편집합니다. 입력 후 '저장' 버튼을 눌러야 반영되며, 변경 사항은 사이드바와 모든 멤버에게 즉시 노출됩니다.
프로젝트를 식별하는 표시 이름입니다. 사이드바·콘솔 헤더·리포트 제목 등에 그대로 사용되므로 팀이 알아보기 쉬운 이름으로 정해 주세요.
프로젝트의 목적·범위를 짧게 적어둘 수 있는 선택 항목입니다. 비워둘 수 있으며, 멤버가 새로 합류했을 때 맥락을 빠르게 잡기 위한 용도로 활용합니다.
'저장' 버튼은 이름이 비어 있지 않을 때만 활성화됩니다. 저장 성공 시 토스트가 표시되고 프로젝트 목록이 다시 불러와집니다.
프로젝트 Owner에게만 '프로젝트 삭제' 버튼이 노출됩니다. 클릭하면 확인 모달이 열리고, 정확한 프로젝트 이름을 입력해야 삭제가 활성화됩니다. 삭제된 프로젝트의 타임라인·세션·리포트·API Key는 복구할 수 없으므로 신중히 처리하세요.
멤버
프로젝트의 모든 멤버를 한 화면에서 확인하고 관리합니다. Admin 이상 역할에서만 초대 정책 토글·대기 중인 초대 목록·역할 변경·멤버 제거 같은 관리 액션을 사용할 수 있습니다.
기본적으로 멤버를 초대할 수 있는 권한은 Admin 이상이지만, 이 토글을 켜면 일반 멤버도 초대 메일을 보낼 수 있게 됩니다. Admin 한정 카드로 노출됩니다.
이메일을 입력하고 '초대' 버튼을 누르면 가입 여부에 따라 적절한 초대 메일이 발송됩니다. 토글이 꺼져 있는 경우 일반 멤버에게는 '관리자만 초대할 수 있다'는 안내가 대신 표시됩니다.
아직 수락되지 않은 초대 목록과 발송 시각을 확인할 수 있습니다. 각 행의 '취소' 버튼으로 즉시 무효화할 수 있습니다.
Admin은 다른 멤버의 역할을 PROJECT_ADMIN ↔ MEMBER 사이에서 변경할 수 있습니다. PROJECT_OWNER는 변경 대상이 될 수 없고, 본인 자신의 역할도 이 화면에서는 바꿀 수 없습니다. 변경 시 한 번 더 확인 다이얼로그가 뜹니다.
Admin은 Owner를 제외한 다른 멤버를 프로젝트에서 제거할 수 있습니다. 다른 Admin은 동일 등급이므로 서로 제거할 수 없습니다. 자신은 제거 대신 '나가기' 버튼을 사용해 탈퇴합니다.
Owner가 아닌 본인 행에서만 '나가기' 버튼이 노출됩니다. 확인 다이얼로그를 거쳐 탈퇴하면 콘솔로 자동 이동합니다. 마지막 Owner는 다른 사람에게 권한을 위임하기 전까지 나갈 수 없습니다.
초대 메일의 만료 시간·재발송 정책 등 초대 라이프사이클 전체는 '멤버 & 초대' 문서를 참고하세요.
API Keys
Claude Code가 AIFlare 서버와 통신할 때 사용하는 인증 키입니다. API Key는 프로젝트 단위로 발급되며, 발급자(본인) 외에는 누구도 다시 키 값을 조회할 수 없습니다.
프로젝트의 Owner·Admin·Member 모두에게 API_KEY_CREATE 권한이 부여되어 있어, 멤버 누구나 '발급' 버튼을 사용할 수 있습니다. 키 이름을 입력하고 확인하면 즉시 새로운 키가 만들어지고, 전체 키 값은 화면 상단 배너에 단 한 번만 표시됩니다.
발급 직후 표시되는 배너에서 'aiflare.yml 다운로드' 버튼을 누르면 키 값이 포함된 설정 파일이 저장됩니다. Claude Code 프로젝트 루트에 두면 곧바로 인식됩니다.
키 이름·prefix·생성일·상태가 표 형태로 나열됩니다. 본인이 발급한 키 외에 다른 멤버가 발급한 키도 PROJECT_EDIT 권한이 있으면 한 화면에서 확인할 수 있고, 권한이 없으면 본인이 발급한 키만 보입니다.
각 키 행의 '폐기' 버튼으로 즉시 비활성화할 수 있습니다. 단, 본인이 발급한 키만 폐기할 수 있고 다른 사람의 키는 폐기할 수 없습니다. 폐기 즉시 해당 키로 들어오는 모든 요청이 거부됩니다.
발급된 키의 전체 값은 발급 직후 배너를 닫는 순간 다시 볼 수 없습니다. 반드시 'aiflare.yml 다운로드'로 저장하거나 비밀번호 관리자에 복사해 두세요. 키가 유출되었다고 판단되면 즉시 폐기하고 새 키를 발급하세요.
권한 매트릭스
프로젝트 역할별로 설정 화면에서 사용할 수 있는 액션을 정리한 표입니다. Owner는 모든 액션을 사용할 수 있고, Admin은 프로젝트 삭제를 제외한 관리 액션을 수행할 수 있으며, Member는 조회와 본인 키 관리 위주로 사용합니다.
| 기능 | Owner | Admin | Member |
|---|---|---|---|
| 설정 화면 진입 (자신이 멤버인 프로젝트) | ✓ | ✓ | ✓ |
| 프로젝트 이름·설명 편집 | ✓ | ✓ | – |
| 멤버 이메일 초대 | ✓ | ✓ | ✓* |
| '멤버 초대 허용' 토글 | ✓ | ✓ | – |
| 다른 멤버 역할 변경 | ✓ | ✓ | – |
| Owner 외 멤버 제거 | ✓ | ✓ | – |
| 프로젝트 API Key 발급 | ✓ | ✓ | ✓ |
| 본인이 발급한 API Key 폐기 | ✓ | ✓ | ✓ |
| 다른 멤버가 발급한 API Key 조회 | ✓ | ✓ | – |
| 프로젝트 삭제 | ✓ | – | – |
✓* (조건부): Admin이 '멤버 초대 허용' 토글을 켰을 때만 Member도 이메일 초대를 보낼 수 있습니다. 그 외 Member 권한은 정적입니다 — 'API_KEY_CREATE'는 Member에게도 기본 부여되므로 누구나 본인 명의 키를 발급할 수 있고, 폐기는 자신이 발급한 키에 한정됩니다. 'Owner 외 멤버 제거'는 Admin이 다른 Admin을 제거할 수 없다는 제약을 포함합니다.