본문 바로가기

전체 글198

CLAUDE.md 규칙 안 지켜질 때｜규칙 때문이 아닌 파일이 부푼겁니다 CLAUDE.md는 Claude가 매 대화 시작 때 읽는 파일입니다. 이 파일이 부풀면 중요한 지시가 묻히고, 세션이 길어지면 무관한 맥락이 쌓입니다. 앞의 문제는 파일 정리로, 뒤의 문제는 컨텍스트 초기화로 풉니다.이 글 한눈에 보기/init으로 초안을 만들고 다듬는 순서/init으로 초안을 만들고 이후에 다듬으면 됩니다.공식 best-practices 문서는 /init이 현재 프로젝트 구조를 바탕으로 CLAUDE.md 시작본을 생성한다고 설명합니다.초안은 완성본이 아니라 출발점이므로, 만든 뒤에 계속 고쳐 쓰는 것이 전제입니다. 기존 파일이 있는 프로젝트에서 /init 결과가 어떻게 반영되는지는 공식 문서에서 확인하고, 실행 전에 기존 파일을 복사해 두세요.공식 메모리 문서에 따르면 Claude Co.. 2026. 10. 20.
Copilot CLI 설치 오류｜Node.js 22 미만이면 막히는 이유 Copilot CLI는 터미널에서 바로 쓰는 Copilot입니다. Node.js 22 이상 확인, npm으로 전역 설치, copilot 실행, 첫 실행 때 /login으로 GitHub 로그인 순서로 진행합니다. 에디터를 열지 않고 셸에서 프롬프트를 던질 때 씁니다.설치가 끝나면 쓸 수 있는 것설치를 마치면 어느 디렉터리에서든 터미널에서 Copilot을 호출할 수 있습니다. 공식 문서를 보면 CLI에는 두 가지 사용 방식이 있는데, 하나는 세션을 열어 대화하는 방식이고 다른 하나는 명령줄에 프롬프트를 한 번 넘기는 방식입니다. 후자는 작업이 끝나는 대로 CLI가 종료됩니다.파일 변경은 사용자의 명시적 승인 없이는 일어나지 않습니다. 공식 getting-started 문서에 있는 내용이며, 저장소를 열어 둔.. 2026. 10. 20.
AI 테스트 코드 자동 생성 방법｜엣지 케이스까지 챙기는 프롬프트 작성법 AI로 테스트 코드를 자동 생성하려면 기존 소스 코드와 테스트 프레임워크 규격을 함께 프롬프트에 주입해야 합니다. 함수 시그니처와 엣지 케이스 조건을 정형화하여 전달하면 단위 테스트 초안을 빠르게 확보할 수 있습니다.최종 확인: 2026-10-20수동 작성 방식보다 초기 작성 시간을 줄이고 누락되기 쉬운 예외 분기를 채우는 데 초점을 맞춥니다.단위 테스트 초안과 자동화 검증 체계 구축이 작업을 마치면 비즈니스 로직에 대응하는 단위 테스트 스위트 파일이 프로젝트 내에 즉시 생성됩니다. 함수 내부의 성공 케이스뿐만 아니라 null 입력이나 네트워크 예외 같은 분기 검증 코드가 마련됩니다.수동 작성과 AI 자동 생성 방식은 작업 흐름에서 차이가 나타납니다.비교 항목기존 수동 작성AI 보조 자동 생성초기 작성 .. 2026. 10. 20.
Claude Code CLI 스크린 리더 모드 설정법 스크린 리더 모드는 VoiceOver·NVDA 같은 스크린 리더로 Claude Code를 쓸 수 있도록, 터미널(CLI) 화면을 장식 없는 평문으로 바꿔 출력하는 모드입니다. 상자 선과 색으로만 구분하던 표시가 빠지고, 진행 스피너는 고정된 글자로, 답변 속 표는 '항목: 값' 문장으로, 파일 변경 내용은 +와 -가 붙은 줄로 읽힙니다. 이 글에서는 이 모드를 켜는 세 가지 방법과 켰을 때 달라지는 점을 정리합니다.이 글 한눈에 보기최종 확인: 2026-10-20각 세션 환경이나 설정 파일에 맞춰 구체적인 옵션을 적용하는 절차를 다룹니다.터미널 작업 환경에서 얻을 수 있는 명확한 출력 결과실제 실행 화면: 메시지마다 you:·tool:·claude: 이름표가 붙고, 권한 질문은 번호 목록으로 나온다 (C.. 2026. 10. 20.
레거시 코드 분석 문서화｜정적 분석과 LLM 결합 2단계 레거시 코드는 테스트가 없고 의도를 알기 힘든 코드베이스를 가리킵니다. AI 도구를 다루면 정적 분석 스크립트와 프롬프트 파이프라인으로 구조를 파악해 최신 명세서로 바꿀 수 있습니다.최종 확인: 2026-10-20정적 분석기와 LLM 파이프라인 결합레거시 코드 분석은 호출 관계를 먼저 추출한 뒤 LLM에 넘겨야 정확해집니다.전체 소스코드를 한 번에 프롬프트에 넣으면 컨텍스트 한계와 환각 문제가 불거집니다. 따라서 정적 분석 도구로 심볼과 의존성 트리를 텍스트 구조로 먼저 뽑아낸 뒤, 함수 단위로 비즈니스 로직 요약을 요청하는 파이프라인을 구축하는 편이 정확합니다.히스토리 부재와 문서 유실 상황테스트 코드가 아예 없고 원작업자가 퇴사한 프로젝트를 인수인계받았다면 이 분석 방식이 꼭 필요합니다.수천 줄짜리 .. 2026. 10. 20.
HTML로 끝내는 영상 제작 - hyperframes 사용법 HyperFrames는 HTML과 CSS로 영상을 만드는 오픈소스 프레임워크입니다. 이 도구는 특히 AI 에이전트를 위한 설계되었으며, 개발 워크플로에 영상 제작 기능을 통합하려는 개발자에게 유용합니다.최종 확인: 2026-10-18무엇을 하는 도구인가HyperFrames는 HTML, CSS, 미디어 파일, 그리고 탐색 가능한 애니메이션을 MP4 비디오로 변환하는 오픈소스 프레임워크입니다. 로컬에서 CLI를 사용하여 활용하거나, AI 코딩 에이전트와 함께 스킬로 사용할 수 있습니다. 또한 호스팅된 저작 워크플로의 렌더링 코어로도 기능합니다.레포지토리 바로가기(Click) >>>설치와 첫 실행HyperFrames를 워크플로에 통합하는 방법은 AI 코딩 에이전트 사용 여부에 따라 달라집니다.단독 스킬 설치:.. 2026. 10. 18.

티스토리툴바