Claude Code나 Codex 위의 AI 직원이 하는 Sentry 오류 분류

직원이 하는 일

• 지난 실행 이후 새로 생겼거나 재발한 미해결 Sentry 이슈를 읽어요.
• 보드와 대조해 중복을 걸러요. 시끄러운 오류에는 새 이슈 열 개가 아니라 댓글 하나가 달려요.
• 쓸모 있는 이슈를 올려요: 영향, 처음과 마지막 발생 시각, 시작된 릴리스, 상위 스택 프레임, 그리고 추측이라고 분명히 표시한 추정 원인.
• 가입이나 결제를 막는 건 무엇이든 긴급처럼, 내가 정한 규칙에 따라 우선순위를 매겨요.
• 명확한 건 고쳐요: null 체크, 빠진 번역 키, 잘못된 리디렉션 같은 것들이요. 테스트와 함께 풀 리퀘스트를 열고 검토를 기다려요.

Claude Code나 Codex에서 Sentry 분류 설정하는 법

1. Sentry MCP 서버 연결하기

   Sentry는 mcp.sentry.dev에 OAuth를 쓰는 MCP 서버를 호스팅해서, 설치할 것도 붙여 넣을 토큰도 없어요. 서버를 추가하고 에이전트를 시작한 다음, 요청이 오면 Sentry에 로그인하세요. 에이전트가 Sentry의 이슈, 오류, 프로젝트, Seer 분석을 볼 수 있게 돼요.

   # Claude Code: Sentry가 호스팅하는 MCP 서버를 추가한 뒤 OAuth로 로그인
   claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
   
   # Codex: mcp-remote 브리지를 통해
   codex mcp add sentry -- npx -y mcp-remote@latest https://mcp.sentry.dev/mcp

2. 역할 브리프 복사하기

   오류가 나오는 저장소의 CLAUDE.md(Claude Code)나 AGENTS.md(Codex)에 넣으세요. 그래야 각 스택 프레임 뒤의 코드를 읽을 수 있어요.

   # 역할: 오류 분류
   반복 이슈 "Sentry triage"로 평일 9:00와 14:00에 실행돼요.
   
   1. Sentry에서 프로덕션 환경의 미해결 이슈 중 지난 실행 이후
      처음 발생했거나 재발한 것을 나열해요.
   2. 각각에 대해 보드에 이미 이슈가 있는지 확인해요(Sentry 이슈 ID로
      검색). 있으면 새 발생 횟수를 댓글로 달아요.
   3. 없으면 이슈를 열어요: 오류에서 딴 제목, 영향받은 사용자와 이벤트 수,
      처음과 마지막 발생 시각, 상위 스택 프레임, 문제가 시작된 릴리스,
      그리고 원인에 대한 최선의 추측(추측이라고 표시).
   4. 우선순위: 가입, 결제, 데이터를 막으면 Urgent, 세션의 1% 이상에
      영향을 주면 High, 그 밖에는 Medium.
   5. 수정이 작고 명확하면 다음 이슈로 맡아 테스트와 함께
      풀 리퀘스트를 열어요. 머지는 하지 않아요.
   6. Sentry에서 직접 해결, 무시, 삭제는 절대 하지 않아요.

3. 일정에 올리기

   분류를 반복 이슈로 만드세요. 예를 들어 --repeat "weekdays at 9:00"로 만들고, 오류가 많다면 오후에 하나 더 두세요.

4. 수정 검토하기

   수정 풀 리퀘스트는 평소 검토 절차를 거쳐요. 직원이 영향이나 담당자를 확신하지 못하면 이슈를 Needs action으로 표시하고 물어봐요.

출처: Sentry MCP 서버 문서

안전하게 지키는 규칙

• Sentry는 읽고, 보드에 쓰기. Sentry에서 해결, 무시, 삭제하는 일은 사람에게 남겨 두세요.
• 프로덕션만: 프로덕션 환경을 가리키게 해서 스테이징의 잡음은 올리지 않게 하세요.
• 추측은 추측: 각 이슈의 원인은 누군가 확인하기 전까지 가설로 표시해요.
• 머지 금지: 수정은 테스트가 붙은 풀 리퀘스트로만, 직접 푸시는 절대 안 돼요.
• 개인 정보: Sentry 이벤트에는 사용자 정보가 들어 있을 수 있어요. 이슈에는 이메일이나 IP 대신 횟수와 ID만 남기세요.

Claude Code와 Codex 단계별 안내

에이전트마다 내장 명령어, 연결할 도구, 일정 설정을 정리했습니다: Claude Code와 Sentry, Codex와 Sentry.

내 오류로 하루를 시작하는 엔지니어

분류는 AI 소프트웨어 엔지니어에게 자연스러운 반복 이슈예요. Crewmark는 내 Claude Code나 Codex를 근무 시간과 하트비트를 갖춘 그런 직원으로 바꿔 줘요.

1. 역할에서 시작하기

   AI 소프트웨어 엔지니어는 보드에서 이슈를 맡아 풀 리퀘스트를 열어요.

2. 분류를 반복 이슈로 추가하기

   때가 되면 분류를 돌리고, 그다음 자기가 올린 이슈를 차례로 처리해요.

3. 엔지니어링의 다른 일

   엔지니어링을 위한 Claude Code와 모든 풀 리퀘스트에 AI 코드 리뷰를 참고하세요.

자주 묻는 질문