GeckoFlag의 “AI로 작성”은 회의록, 버그 보고, 메모 등의 문장이나 채팅 등의 스크린샷을 바탕으로 이슈와 프로젝트의 입력 내용을 AI(Anthropic의 Claude)가 제안하는 기능입니다. 양식을 처음부터 채우는 수고를 줄이면서도 최종 판단과 저장은 지금처럼 사람이 합니다.
이용에 필요한 것
- Anthropic API 키: Claude Console(console.anthropic.com)에서 직접 발급한 API 키를 등록해 사용합니다.
- API 이용료(고객 부담): AI 이용료는 API 키를 발급한 Anthropic 계정으로 청구되며 GeckoFlag 가격에 포함되어 있지 않습니다. “생성”을 눌러 AI가 응답할 때마다 요금이 부과됩니다(양식에 반영하지 않은 경우도 포함). 요금은 모델, 문장의 양, 첨부한 이미지 수에 따라 달라지므로 최신 요금은 Anthropic 요금 페이지에서 확인하세요.
- 서버의 외부 통신: GeckoFlag를 설치한 서버에서 api.anthropic.com에 HTTPS로 연결할 수 있어야 하며, PHP cURL 확장이 활성화되어 있어야 합니다. 일부 공유 호스팅은 외부 통신을 제한하므로 연결 테스트로 확인하세요.
- 지원 버전: GeckoFlag 1.9.0 이상에서 사용할 수 있습니다.
관리자의 이용 관리
- 사용자별 이용 허가: 초기 상태에서는 아무도 사용할 수 없습니다. 관리자가 사용자마다 “AI 등록 허용”을 설정합니다(관리자 본인도 허가가 필요합니다). 허가를 해제하면 즉시 사용할 수 없게 됩니다.
- 1일 이용 한도: 사용자 1명당 하루 이용 횟수에 상한을 설정해 과다 사용을 막을 수 있습니다.
- 이미지 읽기 허용: “AI로 작성”에 이미지를 첨부할 수 있는지를 관리자가 설정 화면에서 켜고 끌 수 있습니다. 초기 상태는 꺼져 있으며, 켜면 이슈, 댓글, 프로젝트, 위키의 모든 화면에서 이미지를 첨부할 수 있습니다.
- 모델 선택: 빠르고 저렴한 Claude Haiku 5.5(기본값) 외에 Claude Sonnet 5.5, Claude Opus 5.5를 선택할 수 있습니다. 새 모델이 나오면 모델 ID를 직접 입력해 사용할 수도 있습니다.
- 연결 테스트: 설정 화면에서 API 키와 서버의 통신이 올바르게 작동하는지 확인할 수 있습니다.
- API 키 암호화 저장: 등록한 API 키는 암호화되어 데이터베이스에 저장되며 화면에는 마스킹된 형태로만 표시됩니다.
AI로 작성할 수 있는 항목
- 이슈 추가 및 편집: 제목, 설명, 이슈 유형, 상태, 우선순위, 담당자, 시작일, 마감일을 제안합니다.
- 댓글 작성: 이슈 내용과 최근 댓글을 바탕으로 댓글 본문을 작성합니다. “마감일을 다음 주 금요일로 미뤄 줘”, “김 대리에게 넘겨 줘”처럼 지시하면 담당자, 상태, 마감일 등 상태 변경도 함께 제안합니다.
- 프로젝트 추가 및 편집: 프로젝트 이름, 설명, 시작일, 완료 예정일을 제안합니다. 새로 추가할 때는 아직 사용되지 않은 프로젝트 키도 제안합니다.
- 위키: 소재가 되는 문장으로 새 위키 페이지를 만들 수 있고, “출시 일정 섹션을 추가해 줘”, “제목을 정리해 줘” 같은 지시로 기존 위키에 내용을 추가하거나 정리할 수도 있습니다.
사용 방법
- 각 화면의 “AI로 작성” 버튼을 누르고 회의록, 메모, 요청 내용 등을 입력하거나 붙여 넣습니다(최대 4,000자). 이미지 읽기가 켜져 있으면 스크린샷 등의 이미지도 첨부할 수 있습니다(이미지를 첨부하면 문장은 생략할 수 있습니다).
- “생성”을 누르면 AI의 제안이 “항목 / 현재 값 / 제안 값” 목록으로 표시됩니다. 설명과 본문은 서식이 적용된 미리보기로 확인할 수 있습니다.
- 반영할 항목에 체크하고 “양식에 반영”을 누른 뒤 내용을 확인하고 평소처럼 저장합니다.
스크린샷으로 작성
채팅이나 메일로 주고받은 내용을 스크린샷 그대로 “AI로 작성”에 첨부할 수 있습니다. AI가 이미지 속 글자를 읽고 이슈나 댓글의 입력안을 작성합니다.
- 문장 입력은 필요 없음: 이미지만으로도 작성할 수 있습니다. “마감일만 뽑아 줘”, “김 대리 담당으로” 같은 보충 설명을 덧붙일 수도 있습니다.
- 간편한 추가: “이미지 선택” 버튼 외에도 드래그 앤 드롭이나 붙여 넣기(Ctrl+V / Cmd+V)로 추가할 수 있습니다. PNG, JPEG, GIF, WebP를 지원하며 한 번에 5장까지 첨부할 수 있습니다.
- 세로로 긴 스크린샷도 읽기 가능: 세로로 긴 이미지는 자동으로 나누어 보내므로 글자가 뭉개지지 않고 읽힙니다. 나눈 이미지를 포함해 한 번에 보낼 수 있는 것은 합계 10장까지입니다.
- 채팅 날짜를 기준으로 해석: “내일까지”, “금요일까지” 같은 표현은 이미지에 메시지 날짜가 보이면 그날을 기준으로 날짜로 변환합니다.
- 연락처는 옮겨 적지 않음: 이미지에 보이는 이메일 주소, 전화번호, 주소 등은 이슈 설명 등에 옮겨 적지 않도록 AI에 지시하고 있습니다.
- 댓글에서는 상태 변경도: 채팅에서 “마감일을 다음 주로 미뤄 주세요”처럼 분명하게 요청한 경우에는 마감일 등의 변경도 함께 제안합니다.
제안을 확인한 후 반영
- AI는 제안만 하고 저장하지 않음: 체크한 항목만 양식에 들어가며, 저장이나 게시는 “생성”, “저장” 등 평소 버튼으로 합니다. 입력 검사, 권한, 알림 메일 등은 일반 조작과 똑같이 작동합니다.
- 입력한 내용을 덮어쓰지 않는 초기 설정: 이슈와 프로젝트에서는 추가 화면에서 빈 항목에만 체크가 되고, 편집 화면에서는 모든 항목이 체크되지 않은 상태로 표시됩니다. 댓글에서는 본문에만 체크가 되며(댓글 입력란이 비어 있는 경우), 담당자나 상태 등의 변경은 직접 체크했을 때만 반영됩니다. 위키에서는 빈 입력란에만 체크가 됩니다.
- 등록된 선택지에서 제안: 이슈 유형, 상태, 우선순위는 관리자가 설정 화면에서 등록한 선택지 중에서 선택됩니다. 담당자는 해당 프로젝트의 멤버 중에서만 선택되며, 문장에 이름이 나오지 않으면 추측해서 지정하지 않습니다.
- “다음 주 금요일” 같은 표현도 인식: “다음 주 금요일”, “이번 달 말까지” 같은 표현을 각 사용자 시간대의 “오늘”을 기준으로 날짜로 변환합니다.
- 표시 언어로 출력: AI는 사용자의 표시 언어로 작성합니다. 입력한 문장에서 다른 언어를 지정하면 그 언어로 작성합니다.
출력 템플릿으로 서식 통일
관리자는 “이슈 설명”, “댓글 내용”, “프로젝트 설명”, “위키 본문”의 네 가지 입력란마다 AI 출력 템플릿을 등록할 수 있습니다. 팀에서 설명이나 위키의 서식을 통일하고 싶을 때 편리합니다.
- 제목 구성을 그대로 사용: 템플릿의 제목을 같은 수준, 같은 순서로 사용합니다. “소제목” 같은 임시 제목은 내용에 맞는 제목으로 바꾸고 필요한 만큼 반복합니다.
- 정보가 없는 제목은 생략: 입력한 문장에 정보가 없는 제목은 빈칸이나 “없음”으로 채우지 않고 제목째 생략합니다.
- 예시로 빠르게 시작: 편집 화면의 “예시 삽입”으로 제목, 글머리 기호, 인용을 사용한 기본 틀을 삽입할 수 있습니다.
전송되는 정보와 데이터 취급
- 전송되는 내용: 입력한 문장 외에 제안에 필요한 다음 정보를 Anthropic API로 전송합니다.
- 모든 화면: 오늘 날짜와 시간대, 출력 언어, 관리자가 설정한 출력 템플릿(설정한 경우), “AI로 작성”에 첨부한 이미지(첨부한 경우)
- 이슈 추가 및 편집: 이슈 유형, 상태, 우선순위의 이름, 프로젝트 멤버의 이름(담당자 후보)
- 댓글: 해당 이슈의 제목, 현재 담당자와 상태 등, 설명(최대 3,000자), 최근 댓글 5건(작성자, 날짜, 본문), 상태와 우선순위의 이름, 프로젝트 멤버의 이름
- 위키: 프로젝트 이름, 양식에 입력된 위키 제목과 본문
- 전송하지 않는 것: 이메일 주소, 비밀번호, 이슈나 댓글에 이미 첨부된 이미지·파일, 다른 이슈나 프로젝트의 내용은 전송하지 않습니다. 이슈와 프로젝트의 편집 화면에서는 이미 저장된 내용도 전송하지 않습니다. (“AI로 작성” 화면에서 첨부한 이미지만 전송됩니다.)
- GeckoFlag에는 저장하지 않음: 입력한 문장, 첨부한 이미지, AI의 응답은 GeckoFlag에 저장되지 않습니다(양식에 반영해 저장한 내용은 제외). 첨부한 이미지는 전송 전에 브라우저에서 축소·변환되므로 사진의 위치 정보 등도 제거됩니다. 이용 횟수 기록은 1일 한도 판정에만 사용하며 30일이 지난 기록은 자동으로 삭제됩니다.
- Anthropic에서의 취급: 전송한 내용의 취급은 Anthropic의 상업 약관(Commercial Terms of Service)과 개인정보 처리방침을 따릅니다. 사내 규정이나 거래처와의 계약에서 외부 서비스로의 정보 전송이 제한되어 있지 않은지 도입 전에 확인하세요.
예상 요금 (Claude Haiku 5.5 기준)
1,000자 분량의 회의록을 입력해 1,500자 정도의 이슈 설명이 작성된 경우, 1회 이용료는 약 0.001~0.002달러(약 1.3~2.7원)입니다. 1,000번 사용해도 1~2달러(약 1,300~2,700원) 정도입니다.
- 2026년 10월 기준 Anthropic의 요금(입력 100만 토큰당 0.10달러, 출력 100만 토큰당 0.50달러)을 바탕으로 1달러 = 1,340원으로 계산한 대략적인 금액입니다. 세금은 포함되지 않습니다.
- 요금은 글자 수가 아니라 ‘토큰’이라는 단위로 계산되며, 한 글자당 토큰 수는 언어에 따라 다릅니다. 또한 GeckoFlag가 AI에 보내는 지시와 선택지 정보도 요금에 포함됩니다. 따라서 실제 금액은 문장 내용에 따라 달라집니다.
- 댓글 작성(이슈 설명과 최근 댓글도 함께 전송)이나 긴 위키의 내용 추가·정리에서는 처리하는 문장이 많아지므로 요금도 높아집니다.
- 상위 모델을 선택하면 요금도 올라갑니다(Claude Sonnet 5.5는 약 20배, Claude Opus 5.5는 약 40배).
- 이미지를 첨부하면 그만큼 요금이 추가됩니다. 스마트폰 스크린샷 1장(1170×2532픽셀)은 약 3,800토큰으로, Claude Haiku 5.5라면 약 0.0004달러(약 0.5원)입니다. 세로로 긴 스크린샷은 나눈 장수만큼 요금이 듭니다.
최신 요금은 Anthropic 요금 페이지에서 확인하세요.
이용 시 주의 사항
- AI의 제안은 틀릴 수 있습니다. 내용, 날짜, 담당자 등을 반드시 확인한 후 저장하세요.
- 개인정보, 기밀 정보, 비밀번호 등은 입력하지 마세요.
- 위키에서 본문을 반영하면 본문 전체가 바뀝니다. 반영하기 전에 미리보기로 내용을 확인하세요.
- AI 모델과 요금, Claude Console 화면은 Anthropic의 사정에 따라 바뀔 수 있습니다.
- 스크린샷에는 다른 사람의 이름, 프로필 이미지, 연락처 등이 찍혀 있을 수 있습니다. 거래처와의 계약이나 사내 규정에 비추어 보내도 되는 내용인지 확인한 뒤 첨부하세요.
- 글자가 너무 작은 이미지, 흐릿한 사진, 비스듬히 찍은 사진은 잘못 읽을 수 있습니다. 읽을 수 없는 부분은 추측하지 말고 생략하도록 지시하고 있지만, 제안 내용은 반드시 확인하세요.
AI로 작성의 장점
회의록이나 클라이언트의 요청 메일을 붙여 넣거나 채팅 내용을 스크린샷으로 첨부하기만 하면 이슈 제목과 설명, 마감일, 담당자(문장에 이름이 있는 경우)까지 들어간 초안이 완성됩니다. 입력 수고를 줄이면서도 최종 확인은 사람이 하므로 속도와 정확성을 모두 잡을 수 있습니다. 등록한 이슈는 그대로 Kanban 보드와 Gantt 차트에서도 확인할 수 있습니다.
기능으로 돌아가기