무엇을 만들고 싶은지부터 고른다
직접 유지할 웹사이트, 앱이나 반복 업무 도구를 만들고 싶다면 Claude Code를 첫 선택으로 추천한다. 이것은 내 프로젝트에서 실행과 검증까지 이어가려는 사람을 위한 추천이다. 모든 사람과 모든 업무에서 웹 채팅보다 낫다는 뜻은 아니다.
Vibe Coding의 출발점은 코드를 모르겠으니 전부 맡기는 것이 아니다. 내가 아는 업무를 입력·결과·예외로 설명하고, 만들어진 결과를 직접 검수하는 것이다. AI가 코드 작성을 맡더라도 업무의 정답을 정하는 역할은 남는다.
Claude 웹 채팅은 어디에 좋은가
아이디어 정리, 문서 읽기, 글 초안, 질문과 비교처럼 대화 중심 작업에서 시작하기 좋다. 업로드한 자료와 연결된 도구의 범위 안에서 일할 수 있다. 로컬 프로젝트의 파일 변경·테스트·Git 작업과는 실행 환경이 다르다.
화면 이름만 보고 기능을 고정해서 생각하면 안 된다. Claude의 웹에서도 Cowork 등 작업 방식이 제공될 수 있다. 이 글은 “웹에서는 아무것도 못 한다”가 아니라 일반 채팅, 지식 업무와 개발 작업의 출발점을 비교한다.
Cowork는 코드 이외의 업무를 맡길 때
Cowork는 문서, 파일 정리와 여러 단계의 지식 업무에 Claude Code의 agentic 기능을 연결하는 제품이다. 현재 공식 안내는 데스크톱뿐 아니라 웹·모바일 지원도 설명한다. 로컬 파일 접근과 원격 실행의 차이는 쓰는 환경에서 확인해야 한다. Cowork 시작 안내.
보고서와 스프레드시트 결과물이 목적이고 개발 프로젝트를 관리하려는 것이 아니라면 Cowork가 더 편할 수 있다. 반대로 소스코드, 테스트, 실행 명령과 배포를 지속해서 관리하려면 개발용 작업 흐름을 선택하는 편이 낫다.
Claude Code를 추천하는 이유
Claude Code는 프로젝트 파일을 읽고 수정하고, 명령과 테스트를 실행한 뒤 결과를 다시 관찰한다. 모델과 도구·컨텍스트·실행 환경이 함께 있는 coding agent다. Claude Code의 작동 방식.
로컬 프로젝트에서 작업하면 현재 코드, 샘플 파일, 오류와 Git 변경을 같은 흐름에서 확인할 수 있다. 내 컴퓨터의 작업 환경에 붙어 있다는 점이 강점이지, 컴퓨터 전체의 무제한 권한을 주는 것이 강점은 아니다.
기본은 한 프로젝트 폴더와 필요한 실행 권한이다. 파일 삭제, 외부 발송과 운영 배포는 검토할 수 있게 둔다. 권한 설정. API 키나 회사 자료를 단순히 접근 가능하다는 이유로 사용하게 하지 않는다.
설치보다 먼저 준비할 것
현재 설치·로그인 절차는 Claude Code Quickstart를 따른다. 설치 명령과 지원 환경은 바뀔 수 있으므로 오래된 블로그 명령을 맹목적으로 복사하지 않는다.
준비물은 개인정보를 뺀 샘플 파일, 원하는 결과 예시, 예외 규칙과 되돌릴 방법이다. 처음에는 운영 데이터·유료 API·외부 발송 없이 로컬에서 끝나는 작업이 좋다. 이미 Codex로 같은 흐름을 쓰고 있다면 도구를 바꾸는 것보다 검수 기준을 만드는 것이 먼저다.
첫 실습: CSV를 검증된 업무 목록으로
목표는 파일을 읽고 오류 행을 표시하며 정상 행을 미리 보는 작은 도구다. 로그인, 결제와 고객 데이터베이스는 제외한다. 아래는 가상 데이터다.
task_id,title,owner
T001,문의 자료 확인,담당 A
T002,길이가 긴 업무 이름의 표시 확인,담당 B
T003,담당자가 없는 업무,
T001,중복된 업무 번호,담당 C
이번 규칙은 빈 담당자와 중복 ID를 오류로 표시하고 확정을 막는 것이다. 정상 입력 파일은 오류 행을 제거해 따로 만든다. 한 파일만으로 정상·실패 동작을 모두 판단하지 않는다.
요청을 세 단계로 나눈다
첫 요청은 읽기와 범위 확인이다.
이 샘플 CSV를 읽어 업무 목록을 확인하는 로컬 도구를 만들고 싶다.
먼저 열 구조와 예외를 확인하고 작은 구현 범위를 정리해 줘.
운영 시스템, 외부 발송, 유료 API는 연결하지 마.
원본 파일은 수정하지 말고 빈 담당자와 중복 ID는 오류로 처리하자.
두 번째는 “파일 선택 → 검증 → 미리보기” 한 흐름을 구현하는 것이다. 세 번째는 정상·오류 샘플로 검증하고 화면과 결과 파일을 확인하는 것이다. 오류가 나면 입력, 기대 결과와 실제 결과를 함께 전달한다.
담당자가 빈 행이 정상 목록에 들어간다.
합의한 규칙대로 오류 목록으로 분리하고 확정을 막아 줘.
정상 입력, 빈 담당자, 중복 ID로 회귀 테스트를 추가해 줘.
관련 없는 UI나 패키지는 바꾸지 마.
좋은 결과를 반복하는 장치
홈페이지 운영에서 시작한다면 NUNC FILMS 글의 자연어 수정·미리보기·게시 흐름을, 실제 업무 파일을 다룬다면 약국 가격택 도구의 엑셀 매핑·문구 검수·PDF 출력을 참고할 수 있습니다. 첫 실습은 전체 시스템보다 반복해서 수정할 작은 결과물 하나로 정하는 편이 좋습니다.
프로젝트의 실행 방법과 업무 규칙을 짧게 남긴다. 자주 반복되는 작업은 Skill로, 외부 도구가 필요한 부분은 검토한 연결로 확장할 수 있다. 처음부터 수십 개를 설치할 필요는 없다.
Claude Code 공식 권장사항은 모델에게 검증 방법을 주고, 탐색·계획·구현·검증을 작업에 맞춰 사용하며 컨텍스트를 관리하는 데 초점을 둔다. Best practices. 파일과 테스트를 남기는 이유는 다음 작업자가 같은 결과를 재현할 수 있게 하기 위해서다.
완료는 직접 확인한다
정상 입력이 정확히 표시되는가. 오류가 숨겨지지 않는가. 긴 글자가 잘리거나 겹치지 않는가. 앱을 다시 열어 같은 결과가 나오는가. 원본이 보존되는가. 이 다섯 가지를 직접 확인한다.
그 다음에만 실제 업무의 익명화 샘플을 추가한다. 자동 발송과 배포는 별도 범위로 승인하고, 변경 전 상태를 Git에 남긴다. Vibe Coding은 만드는 속도만이 아니라 내가 검수하고 다시 사용할 수 있는 결과로 평가한다.
팀에서 시작한다면 AX 워크숍의 첫 목표도 같다. 모두가 도구를 설치하는 것이 아니라, 각자의 업무 하나에 완료 기준과 검수 방법을 만드는 것이다.