[Claude Code·Aside] 자동 테스트 49개가 통과한 대시보드를 직접 눌러 보며 테스트가 못 잡은 문제 세 개를 고쳤다
2026.10.15
📝 한줄 요약
basecamp는 가계부·카톡·유튜브 같은 개인 도구를 탭 하나씩으로 모아 제 맥에서 띄우는 아침용 대시보드입니다. 지난 편에서 하루 만에 만든 뒤, 사람이 눈으로 보기로 남겨 둔 화면 확인을 이번에 했습니다. 자동 테스트 49개가 통과한 상태였는데 가계부 탭은 화면이 깨져 있었고, 다음 날 즐겨찾기 탭을 고치면서 브라우저 차단과 옛 파일 문제가 이어서 나왔습니다. 첫 문제는 2분 만에 고쳤고, 나머지 둘은 요청부터 커밋까지 53분이 걸렸습니다. 그 사이 AI는 원인을 한 번 잘못 짚었다가 스스로 바로잡았습니다.
바쁘시면 이것만 읽어도 돼요:
탭 화면 테스트는 "버튼이 페이지에 있는가"만 봤고 "버튼이 어떤 크기로 그려지는가"는 보지 않았습니다. 그래서 버튼이 화면 전체를 덮는 고장을 놓쳤습니다.
브라우저가 막는 일은 웹페이지 쪽에서 아무리 고쳐도 안 됩니다. 같은 맥에서 도는 서버에게 대신 시키는 방법으로 돌아갔습니다.
"어사이드에서만 안 열린다"의 진짜 원인은 캐시였습니다. 브라우저가 예전에 받은 파일을 저장해 두고 계속 꺼내 쓰고 있었습니다.
Claude는 중간에 "Aside가 이 주소를 무시한다"고 단정했다가 틀렸습니다. 확인에 쓴 도구가 해당 탭을 목록에서 빼고 보여 주고 있었습니다.
인계 메모를 부탁하자 Claude가 쓰기 전에 데이터를 다시 조회했고, 자기가 직전에 답한 사실 세 개를 정정했습니다.
🎯 이런 분들께 도움돼요
AI가 만든 도구가 "테스트 통과"라고 하는데 정말 믿어도 되는지 궁금한 분
AI에게 버그를 설명할 때 무엇을 보여 줘야 할지 막막한 분
크롬 확장 프로그램이나 브라우저 보안 때문에 막혀 본 분
작업이 길어져 AI와의 대화를 다른 세션으로 넘겨야 하는 분
😫 문제 상황 (Before)
지난 편에서 basecamp를 만들어 제 맥에서 실제로 쓸 서버로 띄우고, 서버를 일부러 죽였다 살리는 시험까지 마쳤습니다. 다음 날 로그인하면 자동으로 뜨게 등록도 했습니다. 남은 건 사람이 직접 화면을 보고 확인하는 항목 몇 개였습니다. 탭 다섯 개가 제대로 보이는지, 즐겨찾기가 크롬과 맞는지, 로그아웃했다 들어와도 뜨는지 같은 것들입니다.
자동 테스트는 49개가 모두 통과한 상태였습니다. 그 상태로 남은 화면 확인을 시작했습니다.
지난 편 끝에서 이번 편은 "며칠 써 본 후기"로 예고했습니다. 그런데 써 보기도 전에 고칠 것이 먼저 나와서, 후기는 다음 편으로 미루고 이번에는 이 확인 과정을 적습니다.
🛠️ 사용한 도구
Claude Code: 원인 찾기, 수정, 테스트를 모두 맡았습니다. 1편과 달리 이번에는 Codex에 구현을 넘기지 않았습니다.
Aside 브라우저와 Aside MCP: Aside는 크롬과 같은 엔진으로 만든 브라우저입니다. MCP는 Claude가 그 브라우저를 직접 열고 눌러 볼 수 있게 이어 주는 연결입니다.
모델: Claude Opus 5.5
특이사항: 1편부터 이어 온 세션 하나에서 10/8 오후와 10/9 오후에 작업했습니다. 세션이 사흘째라 대화가 여러 번 요약·압축된 상태였습니다.
🔧 작업 과정
테스트 49개가 통과했는데 화면이 회색 상자 하나였다
가계부 탭을 열었더니 화면 대부분을 회색 상자가 덮고 있었습니다. 상자 안에는 "재기동"이라는 글자만 있었고, 가계부 화면은 맨 아래에 윗부분만 살짝 보였습니다. 스크린샷을 찍어 붙이고 물었습니다.
왜 이런 재가동이라는 창이 보이는거야?Claude는 2분 만에 원인을 찾았습니다. 탭 화면은 칸을 두 줄로 나눠 놓고, 첫 줄은 내용만큼, 둘째 줄은 남은 공간 전부를 쓰게 짜여 있었습니다. 그런데 들어간 요소는 세 개였습니다. 상태 글자가 첫 줄에, 재기동 버튼이 "남은 공간 전부" 줄에 들어갔고, 정작 가계부 화면은 자리를 받지 못해 아래로 밀려났습니다. 회색 상자는 화면 크기만큼 늘어난 재기동 버튼이었습니다. 상태 표시가 정상이었으니 앱이 멈춘 것도 아니었습니다.
상태 글자와 버튼을 한 줄짜리 막대로 묶어 요소를 두 개로 맞추자 바로 고쳐졌습니다. 고친 것보다 테스트가 왜 이걸 못 잡았는지가 더 기억에 남습니다. 테스트는 "버튼과 가계부 화면이 페이지에 들어 있는가"를 확인했고, 실제로 둘 다 들어 있었습니다. 어떤 크기로 그려지는지는 아무 테스트도 보지 않았습니다. 이런 고장은 오류 메시지도 남기지 않습니다. 설계할 때 탭 화면 확인을 사람이 눈으로 보는 항목으로 남겨 둔 이유를 여기서 알았습니다.
"차단됐어" — 브라우저가 막는 길은 돌아간다
다음 날은 즐겨찾기 탭을 봤습니다. 쓰다 보니 바라는 점이 두 가지 생겼습니다.
즐겨찾기 탭에서 스피드다이얼로 갈 수 있는 링크를 상단에 만들어주고 그리고 여기 즐겨찾기를 누르면 화면이 전환되는데 그렇게 하지 말고 새 창을 여는 형식으로 만들어줘즐겨찾기 313개를 새 탭으로 여는 건 금방 됐습니다. Speed Dial 2는 크롬에서 쓰는 즐겨찾기 확장 프로그램인데, 그 화면으로 가는 링크를 붙이면서 Claude는 미리 경고했습니다. 크롬은 일반 웹페이지에서 확장 프로그램 내부 화면으로 넘어가는 것을 막을 수 있고, Speed Dial 2는 그런 접근을 허용하지 않게 설정돼 있다고 했습니다. 눌러 보니 정말 막혔습니다.
스피드다이얼 눌렀더니 차단됐어Claude는 웹페이지 쪽을 더 고치지 않고 길을 바꿨습니다. 크롬은 페이지 안의 링크는 막아도, 맥이 크롬에게 "이 주소를 열어라"라고 넘기는 건 주소창에 직접 입력한 것처럼 받아 줍니다. basecamp는 같은 맥에서 도는 서버라 그 일을 대신할 수 있습니다. 그래서 버튼을 누르면 basecamp 서버가 맥에게 크롬을 열어 달라고 요청하도록 바꿨습니다. 1편에서 만든 재기동 버튼과 같은 구조입니다. 브라우저가 못 하는 일을 로컬 서버에 맡기는 방식이죠.
서버가 맥 명령을 실행하는 기능이라 안전장치도 같이 붙었습니다. 서버가 여는 주소는 설정에 박아 둔 Speed Dial 주소 하나뿐이라, 요청에 다른 주소를 실어 보내도 무시합니다. Claude는 일부러 수상한 주소를 실어 보내는 테스트를 넣었고, 다른 사이트에서 몰래 보낸 요청이 거부되는 것도 실서버에서 직접 확인했습니다.
"맥에서는 열리는데 어사이드에서는 안 열리네"
크롬에서는 열렸습니다. 그런데 평소 쓰는 Aside 브라우저에서 누르면 아무 일도 일어나지 않았습니다.
맥에서는 열리는데 어사이드 브라우저에서는 안 열리네Claude의 첫 가설은 그럴듯했습니다. 코드가 "크롬에 열어라"로 못 박혀 있어서, Aside에서 눌러도 뒤에 숨은 크롬 창에 열렸을 거라고 봤습니다. 그래서 버튼을 누른 순간 맨 앞에 있는 앱이 크롬인지 Aside인지 보고 그쪽에 열도록 고쳤습니다. 다시 눌러 봤지만 여전히 안 됐습니다.
이때 Claude는 Aside를 직접 눌러 볼 수가 없었습니다. Aside MCP가 끊겨 있었기 때문입니다. 왜 끊겼는지 물었더니, 오류 기록의 시각과 Aside 쪽 로그 파일 날짜를 맞춰 보고 답을 냈습니다. 이 세션을 처음 연 순간 Aside 쪽 프로그램이 꺼져 있어서 연결이 실패했을 가능성이 가장 높다고 했습니다(직접 재현하지는 않았습니다). 그리고 이 세션에서는 Aside가 다시 살아난 뒤에도 연결이 끊긴 채로 남아 있어서, 사용자가 직접 다시 연결해야 했습니다. 로그에 무섭게 생긴 인증 오류가 잔뜩 있었는데, 끊긴 날에는 그 로그 자체가 없었다며 관계없는 소음으로 걸러 낸 것도 인상적이었습니다. 다시 연결하는 명령은 사용자만 입력할 수 있어서 제가 직접 입력했습니다.
진짜 원인은 옛 파일이었고, AI는 한 번 틀렸다
연결을 기다리는 동안 Claude가 한 일이 이번 작업에서 가장 "오!" 했던 부분입니다. 무작정 고치는 대신 버튼 요청이 서버에 도착했는지 기록을 남기게 하고, 기록 결과에 따라 막힌 곳을 셋으로 나눠 놨습니다.
기록이 아예 없으면 요청이 서버까지 오지도 않은 것
맨 앞 앱이 Aside로 안 잡혔으면 서버의 판별이 틀린 것
서버는 열었다고 하는데 화면에 변화가 없으면 Aside가 받지 않은 것
그리고 첫 번째를 가장 의심한다고 했습니다. 링크였던 자리를 버튼으로 바꾸면서 버튼 동작이 별도 스크립트 파일로 옮겨 갔는데, Aside가 그 스크립트의 옛 버전을 저장해 두고 계속 쓰고 있다면 버튼은 보여도 눌렀을 때 아무 일도 일어나지 않는다는 설명이었습니다.
어사이드 엠시피 다시 연결했어연결되자 Claude는 Aside가 저장해 둔 스크립트를 직접 열어 봤고, 예상대로 버튼 동작이 들어 있지 않은 옛 파일이었습니다. 화면은 새것, 스크립트는 옛것이었던 겁니다. 이 문제는 파일 주소에 버전 표시를 붙여 해결했습니다. 파일을 고치고 서버를 다시 띄우면 주소가 바뀌니 브라우저가 옛 파일을 꺼내 쓸 수 없습니다. 이제 화면을 고친 뒤 강력 새로고침을 하지 않아도 됩니다.
브라우저를 알아보는 방법도 한 번 더 고쳤습니다. Claude가 자동화로 버튼을 누르면 맨 앞 앱이 Aside가 아니라 터미널로 잡혔기 때문입니다. 그래서 브라우저가 요청마다 보내는 이름표를 먼저 봅니다. 크롬은 "Google Chrome"이라고 보내고 Aside는 "Chromium"만 보냅니다. 이름표가 없을 때만 맨 앞 앱을 봅니다.
그런데 여기까지 오는 길에 Claude가 한 번 틀렸습니다. 중간에 "Aside가 밖에서 넘어온 확장 프로그램 주소를 무시한다"고 판단했는데, Aside MCP로 탭 목록을 봐도 Speed Dial 탭이 늘지 않았기 때문입니다. 알고 보니 그 탭 목록은 확장 프로그램 화면을 빼고 보여 주고 있었습니다. 다른 방법으로 Aside의 실제 탭 수를 세어 보니 명령을 보낼 때마다 Speed Dial 탭이 하나씩 늘었습니다(3개에서 4개로). Claude는 그 판단이 틀렸다고 먼저 밝히고, 그 판단을 근거로 코드를 바꾸지는 않았다고 정리했습니다. 이 일 뒤로 Aside의 탭 수는 탭 목록이 아니라 다른 방법으로 세도록 메모리에 적어 뒀습니다.
Aside에서 열리는 걸 확인하고 커밋(고친 내용을 버전 기록으로 저장하는 일)을 부탁했습니다. 커밋 메시지에는 무엇을 고쳤는지보다 왜 그렇게 고쳤는지를 길게 남겼습니다. 나중에 누가 파일 주소의 버전 표시를 쓸데없어 보인다고 지우면 같은 고장이 다시 생기기 때문입니다.
인계 메모를 쓰다가 AI의 기억이 틀린 걸 알았다
basecamp를 쓰다 보니 가계부 쪽도 손보고 싶어졌습니다. 여기서 이어 할지 물었습니다.
가계부 기능을 개선하고 싶은데 여기서 하는 게 좋을까 아님 money 프로젝트 폴더의 새로운 세션에서 하는 게 좋을까?Claude는 가계부 폴더에서 새 세션을 열라고 했습니다. 이 세션은 사흘째라 앞부분이 요약으로만 남아 있었고, Claude Code는 기억과 세션 기록을 폴더 단위로 쌓기 때문에 가계부 작업은 가계부 폴더에 남아야 나중에 찾을 수 있다는 이유였습니다. 그러면서 새 세션에 넘길 내용도 정리해 줬습니다. 7월 22일 이후로 가계부 데이터가 끊겼다는 것도 그중 하나였습니다.
HANDOFF.md 써줘인계 메모를 부탁하자 Claude는 쓰기 전에 가계부 데이터베이스와 서버를 다시 조회했고, 바로 직전에 자기가 한 설명 세 군데가 틀렸다고 알렸습니다. 데이터는 끊긴 게 아니었습니다. 문자로 들어오는 거래는 그날까지 쌓이고 있었고, 비어 있는 건 7월 말부터 9월 말까지 두 달 남짓이었습니다. basecamp가 가계부에서 읽어 오는 항목 이름도 달랐고, 가계부 폴더에 있다고 한 작업 지침 파일(CLAUDE.md)도 없었습니다. 그대로 넘겼다면 새 세션은 "재연동"이라는 엉뚱한 일부터 시작했을 겁니다. 확인하지 못한 부분은 메모에 "확인 안 함"으로 적어 뒀습니다.
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
탭 화면 | 재기동 버튼이 화면을 덮고 앱 화면은 150px 정도로 찌그러짐 | 상단 한 줄 막대 아래로 앱 화면이 전체 높이를 씀 |
즐겨찾기 클릭 | basecamp 화면이 그 사이트로 바뀜 | 313개 모두 새 탭으로 열림 |
Speed Dial 2 화면 | 링크를 누르면 크롬이 차단 | 버튼 하나로 크롬과 Aside 양쪽에서 열림 |
화면을 고친 뒤 | 강력 새로고침을 해야 반영, 안 하면 버튼이 먹통 | 서버를 다시 띄우면 일반 새로고침으로 새 파일이 쓰임 |
자동 테스트 | 49개 | 55개(새로 만든 버튼의 안전장치 시험 포함) |
요청부터 완료까지 | — | 탭 화면 2분(10/8), 즐겨찾기·Speed Dial·캐시 53분(10/9, 진단과 확인 대기 포함) |
결과물
basecamp 커밋 한 건(파일 8개): 탭 화면, 즐겨찾기 새 탭, Speed Dial 2 버튼, 옛 파일 캐시 막기
가계부 프로젝트용 인계 메모 한 장
아직 남은 확인도 있습니다. 카톡·유튜브 탭 화면과 가계부 탭의 월 선택·검색, 크롬에서 추가한 즐겨찾기의 반영, 로그아웃 후 자동 실행은 아직 보지 않았습니다.
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
설명보다 스크린샷. "이상한 창이 떠"라고 말로 하는 것보다 화면을 찍어 붙이는 쪽이 빨랐습니다. 회색 상자 하나로 Claude는 탭 화면의 칸 구조를 바로 의심했습니다.
고치기 전에 막힌 곳을 가르게 한다. "왜 안 되지?"에 바로 고친 코드가 돌아오면 원인을 모른 채 다음 시도로 넘어가게 됩니다. 기록을 남기게 하고 결과별로 막힌 곳을 미리 나눠 두니, 그 뒤로는 저장된 파일, 서버 기록, 실제 탭 수를 차례로 맞춰 보며 원인을 좁힐 수 있었습니다.
AI가 직접 볼 수 있게 한다. Aside MCP가 끊겨 있는 동안에도 Claude는 코드와 서버를 검사했지만, Aside 화면에서 버튼을 직접 눌러 보지는 못했습니다. 연결하자마자 저장돼 있던 옛 스크립트 파일을 직접 열어 확인했습니다.
넘기기 전에 다시 조회하게 한다. 인계 메모처럼 다음 작업의 출발점이 되는 글은 대화 속 기억이 아니라 실제 데이터로 쓰게 하세요.
이렇게 하면 안 돼요
테스트가 전부 통과했다고 화면 확인을 건너뛰면 안 됩니다. 이번 고장 세 개는 모두 테스트가 통과한 상태에서 나왔습니다.
확인 도구가 보여 주는 것을 전부라고 믿으면 안 됩니다. Aside MCP의 탭 목록은 확장 프로그램 화면을 빼고 보여 줬고, 그걸 믿은 판단은 틀렸습니다. 중요한 판단은 다른 방법으로 한 번 더 확인하게 하세요.
오래된 세션에서 다른 프로젝트 작업을 이어 하지 마세요. 앞부분이 요약으로만 남은 세션에서 나온 사실은 특히 다시 확인해야 합니다.
🌍 다른 업무에 적용한다면?
"테스트는 통과했는데 실제로는 이상하다"는 코드 밖에서도 흔합니다. 보고서 숫자는 수식 검사를 통과했는데 차트가 엉뚱하게 그려지거나, 자동 발송 메일이 발송 성공으로 찍혔는데 받는 쪽에서는 깨져 보이는 경우가 그렇습니다. 이럴 때 AI에게 "고쳐 줘"보다 "어디서 막혔는지 가를 수 있는 방법을 먼저 만들어 줘"라고 하면 헛손질이 줄어듭니다. 업무를 다른 사람이나 다른 세션에 넘길 때도 같습니다. 인수인계 메모를 쓰기 직전에 원자료를 다시 열게 하면, 대화하면서 굳어 버린 틀린 사실이 넘어가지 않습니다.
🚀 앞으로의 계획
카톡·유튜브 탭 화면과 가계부 탭의 월 선택·검색을 마저 보고, 크롬에서 추가한 즐겨찾기가 basecamp에 반영되는지 확인합니다. 그 확인이 끝나면 동기화 시험용으로 떠 둔 즐겨찾기 사본을 지웁니다. 계정 정보가 들어 있기 때문입니다. 마지막으로 로그아웃했다 들어와도 자동으로 뜨는지 봅니다. 그다음에는 지난 편에서 예고한 대로 basecamp를 며칠 아침마다 쓴 후기를 적겠습니다. 가계부 개선은 가계부 폴더의 새 세션에서 시작했고, 그 과정은 가계부 연재에서 이어 가겠습니다.
📋 재사용 가능한 프롬프트
프롬프트 1: 화면 버그를 물을 때
[스크린샷 첨부] 이 화면에서 [이상한 부분]이 보여. 바로 고치지 말고 먼저 왜 이렇게 그려지는지 설명해 줘. 그리고 지금 있는 테스트가 이걸 왜 못 잡았는지도 알려 줘. [이상한 부분]은 본인 상황에 맞게 바꾸세요.
프롬프트 2: 원인을 모를 때 고치기 전에 가르기
[기능]이 [환경]에서만 동작하지 않아. 바로 수정하지 말고, 어느 단계에서 막혔는지 구분할 수 있게 기록을 남기는 방법부터 만들어 줘. 기록 결과마다 막힌 곳이 어디인지 표로 정리해 주고, 가장 의심되는 것 하나를 이유와 함께 골라 줘.
프롬프트 3: 확인 도구를 교차 확인하기
방금 [도구]로 확인한 결과를 근거로 판단했는데, 그 도구가 보여 주지 않는 것이 있을 수 있어. 같은 사실을 다른 방법으로 한 번 더 확인해 주고, 두 결과가 다르면 어느 쪽을 믿어야 하는지 알려 줘.
프롬프트 4: 인계 메모를 쓰기 전에
다음 세션에 넘길 인계 메모를 써 줘. 쓰기 전에 대화에서 말한 사실들을 실제 데이터와 파일로 다시 확인하고, 앞서 말한 것과 다른 점이 있으면 먼저 알려 줘. 확인하지 못한 것은 "확인 안 함"으로 적어 줘.

![[Paseo + Claude Code] 만들어 둔 리센느빵 테트리스 세션을 그대로 이어받아, 메뉴·2인 대전·배경음악·효과음까지 한 번에 붙였다 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fdfa7f86bd93d21caba20bf53.jpg&w=3840&q=75)

