Seunghyeon's lab.

codex-plugin-cc — Claude Code 안에서 Codex로 코드 리뷰와 작업을 넘기는 플러그인

한눈에 보는 답Claude Code Claude Code 안에서 Codex 리뷰은 결론부터 보고 적용 여부를 판단해야 하는 주제다.핵심 답은 이렇다. Claude Code Claude Code 안에서 Codex 리뷰이 무엇을 바꾸는지, 언제 쓸 만한지, 어떻게 검증할지 먼저 답한다.아래 본문은 그 결론을 맥락, 실행 순서, 검증 기준, 주의점으로 나눠 확인하는 흐름이다.같은 창을 떠나지 않고 두 번째 의견을 받는다Claude Code로 코드를 짜다 보면 가끔 이런 생각이 든다. 이 변경, 정말 안전한가? 다른 모델은 다르게 볼까? 보통은 터미널을 따로 열고 Codex를 켜서 같은 변경을 다시 붙여넣는다. 맥락이 끊기고, 작업 흐름도 끊긴다.codex-plugin-cc는 그 왕복을 없앤다. Claude C..

Claude Code로 README 초안 28초 만에 뽑는 법 — 폴더 구조 한 줄이 문서 전체를 완성한다

개발이 끝난 뒤 README를 쓰는 건 레고를 다 완성한 뒤 조립 설명서를 새로 만드는 일과 같다. 이미 머릿속에 있는 내용을 다시 꺼내 문장으로 정리하는 과정이 오히려 개발보다 오래 걸린다. Claude Code는 프로젝트 루트의 폴더 구조를 읽는 것만으로 이 작업을 28초 안에 끝낸다. 이 글은 그 과정을 처음부터 따라할 수 있게 풀어낸다.한눈에 보는 답프로젝트 루트에서 명령 한 줄(claude 'README.md 초안 작성해줘')이면 Claude Code가 package.json, Dockerfile, requirements.txt 같은 파일을 스스로 읽고 설치·실행 가이드를 자동 생성한다.초안 품질을 두 배로 올리는 방법은 독자 정의 한 문장뿐이다. "백엔드 경험 없는 기획자 대상"처럼 구체적으로..

promptfoo — 프롬프트를 감이 아니라 점수로 비교하는 LLM 평가·레드티밍 도구

한눈에 보는 답프롬프트를 점수로 비교하는은 결론부터 보고 적용 여부를 판단해야 하는 주제다.핵심 답은 이렇다. 프롬프트를 점수로 비교하는이 무엇을 바꾸는지, 언제 쓸 만한지, 어떻게 검증할지 먼저 답한다.아래 본문은 그 결론을 맥락, 실행 순서, 검증 기준, 주의점으로 나눠 확인하는 흐름이다.프롬프트가 좋아졌는지, 아직도 눈으로 확인하나요프롬프트를 한 줄 고치고, 답을 다시 읽어보고, 괜찮은 것 같으면 넘어간다. 많은 사람이 이렇게 LLM 앱을 만듭니다. 문제는 '괜찮은 것 같다'가 측정이 아니라 느낌이라는 점입니다. 어제 고친 프롬프트가 다른 입력에서 더 나빠졌는지, 모델을 바꿨을 때 진짜 개선됐는지는 눈으로 몇 개 읽어서는 알 수 없습니다.promptfoo는 이 시행착오 방식을 멈추라고 말하는 도구입..

에러 로그 하나로 버그 리포트 초안을 10분 안에 완성하는 법

버그를 고치는 데 10분, 리포트를 쓰는 데 40분. 이 비율이 낯설지 않다면 이 글이 도움이 된다. Claude Code에 스택 트레이스를 통째로 넘기면, 재현 절차부터 심각도 판단까지 팀이 바로 쓸 수 있는 구조로 나온다.한눈에 보는 답에러 메시지를 "고쳐줘"가 아니라 "분석해줘, 수정은 하지 말고"로 던지면 증상 덮기가 아닌 진짜 원인을 얻는다.스택 트레이스 전문을 붙이면 Claude Code가 파일명·라인 번호·호출 순서를 읽고 원인 가설을 2~3개 제시한다.초안 한 번, 보강 한 줄이면 Severity 판단과 영향 범위까지 붙은 팀 수준 리포트가 완성된다.인용 가능한 핵심 정리검증일: 2026-06-01정의: Claude Code를 활용한 버그 리포트 자동화란, 스택 트레이스와 범위 지정 프롬프..

qmd — 노트와 회의록을 인터넷 없이 내 컴퓨터에서 검색하는 온디바이스 검색엔진

검색이 안 되는 노트는 없는 것과 같다메모는 매일 쌓이는데, 정작 필요할 때 찾지 못한 경험이 누구에게나 있습니다. 회의록 수십 개, 문서 폴더, 개인 노트가 디스크 어딘가에 흩어져 있지만 파일명만으로는 그게 어디 있는지 알 수 없습니다. 검색이 안 되는 노트는 사실상 없는 것과 같습니다.qmd는 이 문제를 정면으로 다룹니다. 한 줄로 정리하면, 마크다운 노트·회의록·문서를 인터넷 없이 내 컴퓨터에서 검색하는 온디바이스 검색엔진입니다. 키워드 검색과 자연어 검색을 같이 돌리고, 결과를 한 번 더 정렬해 정확도를 끌어올립니다.이 도구가 푸는 문제기존 노트 검색은 둘 중 하나였습니다. 단순 키워드 grep은 빠르지만 의미를 모릅니다. 클라우드 기반 의미 검색은 똑똑하지만 내 노트를 외부 서버에 올려야 합니다..

커밋 전에 게이트가 먼저 막아야 한다 — Claude Code Hooks 사전 검증 체인 완전 설계

배포하고 나서 lint 오류를 발견한 적 있다면, 이 글이 그 반복을 끊는다. Claude Code의 Hooks 파이프라인으로 커밋·배포 전 다단계 검증을 직렬로 연결하는 방법과, 실무에서 맞닥뜨린 타임아웃·fail-open 함정까지 정리한다.한눈에 보는 답게이트 순서가 속도를 결정한다. lint(가장 빠름) → secret-scan → type-check(가장 무거움) 순으로 쌓아야 전체 파이프라인 소요 시간이 최소화된다.non-zero 반환 즉시 체인이 끊긴다. 하나의 훅이 실패하면 이후 훅은 실행되지 않는다. 이 동작을 믿으려면 반환 코드를 반드시 명시해야 한다.네트워크 의존 검증은 PostToolUse로 분리해야 한다. PreToolUse 훅에 외부 API 호출을 넣으면 hang 위험이 생긴다.1..

Claude Code로 코드 주석 자동 추가하기 — 함수에 설명을 붙여 문서화 시간을 줄이는 법

주석 없는 코드를 처음 열었을 때의 그 막막함, 개발자라면 누구나 안다. 함수 이름만 봐서는 뭘 하는지 알 수 없고, 결국 호출 스택을 세 단계씩 따라가며 코드 전체를 읽게 된다. Claude Code를 쓰면 이 문서화 작업을 명령어 한 줄로 끝낼 수 있다. 이 글은 코드 주석 자동 추가하기 — 함수에 설명을 붙이는 방법을 처음부터 따라할 수 있게 정리한다.1. 왜 지금 이걸 봐야 하나팀 코드베이스에서 가장 많이 듣는 말이 있다. "이 함수 뭐 하는 거예요?" 그리고 그 질문에 대한 대답은 항상 같다. "코드 읽어봐요."주석이 없으면 코드를 읽는 데 시간이 걸리는 게 아니라, 맥락을 재구성하는 데 시간이 걸린다. 변수 이름이 v이고 함수 이름이 process라면 로직 전체를 처음부터 추적해야 한다. 하루..

Claude Code 에이전트를 실제 운영 환경에서 돌리다 보면, 스킬이 많아질수록 전체 선로딩 방식이 역효과를 낸다는 걸 수치로 확인하게 된다. 이 글은 Skills 동적 로딩 패턴을 요청 컨텍스트에 따라 적용하는 방법, 실측 전후 비교, 그리고 삽질 과정에서 발견한 함정까지 순서대로 정리한다. 스킬을 5개 이상 운영하고 있거나, 응답 지연과 토큰 비용이 동시에 신경 쓰이는 상황이라면 이 구조가 직접적인 해답이 된다.1. 왜 지금 이걸 봐야 하나20개 스킬을 메모리에 전부 올려두는 구조는 손님 한 명을 위해 뷔페 주방에서 200가지 요리를 미리 꺼내놓는 것과 같다. 컨텍스트 윈도우는 유한하고, 쓰지 않는 스킬의 시스템 프롬프트가 그 공간을 잠식한다.Mac Mini 클러스터 4대에서 Claude Code..

Claude Code에서 서브에이전트를 수백 개 동시에 돌릴 수 있게 됐다. Anthropic이 공개한 Claude Opus 4.8은 모델 성능 업그레이드에 그치지 않고, "Dynamic Workflows"라는 오케스트레이션 레이어를 함께 내놨다. Claude Opus Dynamic Workflows 병렬 서브에이전트 구조가 Claude Code에 기본 탑재됐다는 건, 지금까지 순차적으로 처리하던 대규모 작업을 근본적으로 다시 설계할 수 있다는 의미다.이 글은 Dynamic Workflows가 무엇인지 빠르게 파악하고, 실무에서 어떻게 적용하며, 어디서 무너지는지를 한 번에 정리한다.1. 왜 지금 이걸 봐야 하나기존 Claude Code 사용 방식을 떠올려 보면, 큰 작업은 대체로 이랬다. 거대한 컨텍스..

세션을 닫으면 Claude Code는 모든 걸 잊는다. 스택 정보, 포트 번호, 커밋 규칙 — 어제 알려준 것들을 오늘 다시 처음부터 설명해야 한다. CLAUDE.md 프로젝트 기억 설계는 이 반복을 끊는 가장 직접적인 방법이다. 파일 하나를 제대로 써두면 매 세션마다 쏟아지는 확인 질문이 사라지고, 첫 코드 제안까지 걸리는 시간이 눈에 띄게 줄어든다.1. 왜 지금 이걸 봐야 하나Claude Code를 팀 프로젝트나 복잡한 인프라에 붙여 쓰는 순간, 반복 온보딩 비용이 쌓이기 시작한다. 새 세션을 열 때마다 '포트가 뭐예요', '어떤 스택이에요', '커밋 규칙이 있나요' 같은 질문이 7~9회씩 나온다. 이건 AI가 멍청한 게 아니라 구조적인 문제다. Claude Code는 세션 단위로만 기억하고, 대화가..