AX CONSULTING · VIBE CODING 바이브코딩, 빠르게 만들수록 더 먼저 지켜야 할 10가지 고객사 자료, API Key, 업무 데이터를 다루는 AX 컨설턴트라면 속도보다 먼저 확인해야 할 안전수칙이 있습니다. AI가 만든 결과를 안심하고 전달하기 위한 실무 기준을 정리했습니다. 바이브코딩은 아이디어를 빠르게 화면과 기능으로 바꿔줍니다. 하지만 파일 하나를 프로젝트 폴더에 넣는 일, 환경변수 이름 앞에 접두사를 붙이는 일, AI가 “완료했습니다”라고 말하는 일을 가볍게 넘기면 보안 사고나 잘못된 산출물로 이어질 수 있습니다. 핵심은 단순합니다. 민감한 정보는 밖으로 나가지 않게 하고, AI의 답변은 실행 결과로 검증하며, 애매한 판단은 사람이 확정한다. 아래 원칙을 프로젝트 시작 전과 고객사 전달 전에 점검해 보세요. 1. 고객사 원본 자료는 함부로 올리지 않습니다 계약서, 제안서, 회의록, 녹취록, 직원·고객 정보, 급여·근태·매출 자료, 내부 규정, 고객 DB와 원본 엑셀·PDF는 모두 민감할 수 있습니다. 웹 기반 AI 도구에 첨부한 파일은 외부 서비스로 전송되고, 프로젝트 폴더에 잠시 둔 원본은 나중에 커밋·배포·로그 출력으로 이어질 수 있습니다. 가장 흔한 실수 테스트를 빨리 하려고 실제 엑셀을 /data 폴더에 넣고 AI에게 읽게 한 뒤, 폴더 전체를 저장소에 올리는 경우입니다. 저장소가 비공개여도 배포 URL이나 빌드 로그가 별도의 노출 지점이 될 수 있습니다. 원본은 고객사가 허용한 환경에서만 처리합니다. 개발과 테스트는 더미 데이터 또는 가명 처리 샘플로 시작합니다. 고객사 실데이터가 필요한 최종 검증은 승인 범위 안에서 최소한으로 진행합니다. 애매하면 업로드하기 전에 PM 또는 보안 담당자에게 먼저 확인합니다. 2. API Key와 비밀번호는 코드에 쓰지 않습니다 API Key, 토큰, 비밀번호는 시스템의 열쇠입니다. 한 번 공개 저장소나 배포된 브라우저 코드에 들어가면 비용 발생과 데이터 접근으로 이어질 수 있습...
학습용 가이드 · Anthropic 공식 문서 기반 Claude Code 공식 모범 사례 쉽게 이해하기 이 문서는 Anthropic의 공식 문서 Claude Code 모범 사례 를 바탕으로, 내용을 더 쉽게 이해할 수 있도록 설명과 예시를 추가해 재구성한 학습용 가이드입니다. 공식 문서: code.claude.com/docs/ko/best-practices 목차 한 줄 요약 챗봇이 아니라 "자율 코딩 작업자"다 완료 기준을 먼저 줘라 검증 기준의 종류 Before/After: 검증 기준 제공 탐색 → 계획 → 코딩 순서 Plan Mode가 필요한 경우 탐색 → 계획 → 구현 예시 구체적인 맥락을 넣어라 Before/After: 맥락 제공 풍부한 콘텐츠를 제공하라 CLAUDE.md는 짧은 운영 카드다 좋은 CLAUDE.md 예시 권한은 자동화의 브레이크다 CLI 도구를 적극 활용하라 MCP 서버로 외부 시스템 연결 Hooks: 반드시 실행되는 규칙 Skills: 반복 업무 저장 Subagents로 context 절약 Claude에게 질문도 잘 시켜라 세션 관리는 품질 관리다 체크포인트와 rewind 활용 비대화형 모드로 자동화하기 여러 세션 병렬 실행 대량 작업은 fan-out으로 적대적 리뷰 단계 추가 흔한 실패 패턴과 해결책 실무 시나리오별 완성 프롬프트 AI 개발팀 운영 모델 작업 전 체크리스트 바로 쓰는 기본 템플릿 최종 정리 0 한 줄 요약 Claude Code를 잘 쓰는 핵심은 AI에게 코딩을 맡기는 것 이 아니라, AI가 검증 가능한 방식으로 일하게 만드는 것 입니다. 좋은 AI 코딩 운영 = 목표 + 맥락 + 검증 기준 + 권한 제한 + 리뷰 구조 1 Claude Code는 챗봇이 아니라 "자율 코딩 작업자"다 일반 챗봇은 질문에 답하고 멈춥니다. 하지만 Claude Code는 다음 일을 할 수 있습니다. 파일 읽기 코드 수정 터미널 명령 실행 테스트 실행 빌드 확인 에러 로그 분석 여러 파일에 걸친 리팩터링...