소개
그동안 계속 미뤄왔던 Claude Code 설치를 드디어 진행했습니다.
사실 Claude Code를 설치해야겠다는 생각은 전부터 하고 있었습니다. 하지만 막상 시작하려고 하면 여러 가지가 신경 쓰였습니다.
설치 과정에서 문제가 생기면 어떻게 하지?
권한 설정을 잘못하면 위험하지 않을까?
프로젝트 디렉토리와 개인 디렉토리를 헷갈리면 나중에 꼬이지 않을까?
Claude Code의 Skill은 뭔가 복잡한 개발 지식이 있어야 만들 수 있는 것 아닐까?
이런 생각들 때문에 “나중에 해야지” 하고 계속 미뤄두고 있었습니다.
그러다 이번에는 더 이상 미루지 말고 직접 해보기로 했습니다. 이유는 분명했습니다. 앞으로 바이브코딩과 AI 에이전트 활용을 더 잘하기 위해, 저만의 지식과 작업 방식을 정리한 개인 지식 위키**를 만들고 싶었기 때문입니다.
단순히 Claude Code를 설치하는 것이 목적이 아니라, 앞으로 반복할 작업을 에이전트와 함께 정리하고 자동화할 수 있는 기반을 만드는 것이 이번 시도의 핵심이었습니다.
진행 방법
1. Antigravity 터미널에서 Claude Code 설치하기
이번 작업은 Antigravity의 터미널 화면을 이용해서 진행했습니다.
처음에는 Claude Code 설치 자체가 부담스럽게 느껴졌지만, 막상 터미널에서 하나씩 진행해보니 생각보다 진입 장벽이 높지 않았습니다. 중요한 점은 설치 과정에서 막히는 부분이 생겼을 때, 혼자 검색하며 끙끙대기보다 Claude Code에게 바로 질문하면서 해결할 수 있었다는 점입니다.
이번 작업에서 사용한 도구는 다음과 같습니다.
Antigravity: 터미널과 작업 환경으로 사용
Claude Code: 설치, 파일 검토, Skill 생성, 디렉토리 이전 작업 지원
Claude Code Skill: 반복 가능한 작업 지침을 저장하기 위한 구조로 활용
2. 작업 내용을 바탕으로 Skill 만들기
Claude Code 설치 후에는 지금까지 진행한 작업을 바탕으로 Skill을 만들어보았습니다.
사용한 프롬프트는 매우 단순했습니다.
지금까지의 작업을 바탕으로 스킬로 만들어줘.
처음에는 Claude Code의 Skill이라고 해서 특별한 기술이나 복잡한 형식이 필요할 줄 알았습니다. 그런데 실제로 해보니 생각보다 단순했습니다.
Claude Code의 Skill은 거창한 플러그인이라기보다, 특정 작업을 더 잘 수행하도록 돕는 재사용 가능한 작업 지침 묶음에 가까웠습니다. 필요한 설명, 절차, 참고 파일, 스크립트 등을 정리해두면 Claude가 이후 비슷한 작업에서 그 내용을 참고할 수 있는 구조였습니다.
이 부분이 가장 인상 깊었습니다.
“내가 완벽하게 구조를 설계해야만 쓸 수 있는 기능”이 아니라, 지금까지 진행한 작업을 에이전트에게 설명하고 정리하게 만들면 충분히 시작할 수 있었습니다.
3. .claude 디렉토리 구조 이해하기
진행하면서 새롭게 알게 된 점도 있었습니다. Claude Code는 작업 디렉토리 안의 .claude 디렉토리와, 사용자 홈 디렉토리의 ~/.claude 설정을 함께 활용할 수 있습니다.
처음에는 이 부분이 헷갈렸습니다. 저는 프로젝트를 진행하려던 디렉토리가 아니라 개인 디렉토리에서 Claude Code를 시작했고, 그 상태에서 권한을 부여했습니다. 그래서 나중에 이런 걱정이 들었습니다.
“혹시 권한 설정이나 작업 파일이 잘못된 위치에 생긴 건 아닐까?”
하지만 실제로는 Claude Code에게 현재 디렉토리 구조를 검토하게 하고, 필요한 하위 디렉토리와 파일을 확인한 뒤, 프로젝트 디렉토리로 옮기는 방식으로 해결할 수 있었습니다.
이때 사용한 요청 흐름은 대략 다음과 같았습니다.
현재 Claude Code 관련 설정과 작업 파일이 어디에 생성되었는지 확인해줘.
프로젝트 디렉토리로 이전해야 할 하위 디렉토리와 파일을 검토해줘.
검토 결과를 바탕으로 안전하게 이전해줘.
이전에는 이런 작업을 직접 하려면 숨김 폴더를 확인하고, 설정 파일을 열어보고, 어떤 파일을 옮겨야 하는지 직접 판단해야 했을 것입니다. 그런데 이번에는 에이전트에게 먼저 검토를 요청하고, 그 결과를 바탕으로 이전까지 진행할 수 있었습니다.
4. 권한 문제에 대한 부담 줄이기
Claude Code를 사용하면서 가장 신경 쓰였던 부분은 권한이었습니다.
코딩 에이전트는 파일을 읽고, 수정하고, 명령어를 실행할 수 있기 때문에 처음 사용할 때는 당연히 조심스러울 수밖에 없습니다. 특히 잘못된 디렉토리에서 시작했거나, 예상하지 못한 위치에 설정 파일이 생성되면 더 불안해질 수 있습니다.
이번 경험을 통해 알게 된 점은 다음과 같습니다.
Claude Code는 작업 디렉토리 기준으로 프로젝트 맥락을 이해합니다.
.claude관련 파일은 프로젝트별 설정과 개인 설정을 구분해서 생각하는 것이 좋습니다.권한이나 파일 위치가 헷갈릴 때는 직접 추측하지 말고, 에이전트에게 먼저 구조를 검토하게 할 수 있습니다.
중요한 파일을 옮기기 전에는 “검토 → 이전 대상 확인 → 실행” 순서로 요청하면 부담을 줄일 수 있습니다.
즉, Claude Code를 잘 쓰기 위해 꼭 모든 구조를 처음부터 완벽히 알아야 하는 것은 아니었습니다. 오히려 모르는 부분을 에이전트에게 질문하고, 확인하고, 함께 정리하면서 배워나갈 수 있었습니다.
결과와 배운 점
이번 1주차의 가장 큰 수확은 “생각보다 시작이 어렵지 않았다”는 점이었습니다.
Claude Code 설치 전에는 막연한 부담이 있었습니다. 특히 터미널, 권한, 숨김 디렉토리, Skill 같은 단어들이 한꺼번에 나오니 시작하기 전부터 복잡하게 느껴졌습니다.
하지만 직접 해보니 중요한 것은 완벽한 사전 지식이 아니라, 에이전트에게 질문하며 한 단계씩 진행하는 태도였습니다.
이번에 배운 점을 정리하면 다음과 같습니다.
1. Skill은 특별한 기술보다 “반복 가능한 지침 정리”에 가깝다
Claude Code의 Skill을 만들기 전에는 뭔가 복잡한 개발 작업이 필요할 줄 알았습니다. 하지만 실제로는 내가 수행한 작업 과정, 자주 쓰는 기준, 반복하고 싶은 절차를 정리하는 것만으로도 충분히 시작할 수 있었습니다.
즉, Skill은 “대단한 자동화 기능”이라기보다 “나의 작업 방식을 에이전트가 다시 사용할 수 있게 정리한 설명서”에 가까웠습니다.
2. 모르는 부분은 에이전트에게 바로 물어볼 수 있다
예전 같으면 권한 문제나 디렉토리 구조가 헷갈릴 때 검색부터 했을 것입니다. 물론 공식 문서를 확인하는 일도 중요하지만, 이번에는 Claude Code에게 현재 상태를 직접 점검하게 할 수 있었습니다.
예를 들어 다음과 같은 방식입니다.
현재 디렉토리에서 Claude Code 관련 파일을 찾아줘.
이 파일들이 어떤 역할을 하는지 설명해줘.
프로젝트 디렉토리로 옮겨야 할 것과 그대로 둬도 되는 것을 구분해줘.
이렇게 질문하니 단순히 답을 듣는 것을 넘어, 현재 내 환경에 맞는 설명을 받을 수 있었습니다.
3. 시작하고 나면 다음 단계가 보인다
설치 전에는 무엇을 해야 할지 막막했습니다. 그런데 막상 설치하고 Skill을 만들고 나니, 다음에 해보고 싶은 것들이 자연스럽게 떠올랐습니다.
개인 지식 위키 구조 만들기
자주 쓰는 프롬프트를 Skill로 정리하기
프로젝트별
.claude설정을 구분해서 관리하기바이브 코딩을 위한 작업 규칙과 체크리스트 만들기
에이전트에게 파일 검토, 문서화, 이전 작업을 맡겨보기
결국 시작해야 다음 고민도 구체화된다는 것을 느꼈습니다.
마무리하며
이번 주차 경험을 통해 가장 크게 느낀 것은 이것입니다.
망설이지 말고 지금 시작하자.
예전에는 새로운 도구를 시작하기 전에 사용법을 충분히 익혀야 한다고 생각했습니다. 하지만 이제는 조금 다르게 생각하게 되었습니다.
LLM이 있고, 에이전트가 있습니다. 모르는 부분이 생기면 바로 질문할 수 있고, 질문한 결과를 바탕으로 실제 작업까지 이어갈 수 있습니다.
물론 권한, 파일 이동, 설정 변경처럼 조심해야 할 부분은 여전히 있습니다. 하지만 그렇기 때문에 더더욱 혼자 감으로 처리하기보다, 에이전트에게 검토를 요청하고 단계적으로 진행하는 방식이 도움이 되었습니다.
Claude Code를 아직 설치하지 않았다면, 너무 오래 준비만 하지 않아도 괜찮을 것 같습니다. 작은 작업 하나부터 시작해보면 생각보다 많은 부분을 에이전트와 함께 해결할 수 있습니다.
도움 받은 글
Anthropic Claude Code Docs:
.claude디렉토리 구조 관련 문서Anthropic Claude Code Docs: 권한 관리 관련 문서
Anthropic Skills 공개 저장소 및 Agent Skills 소개 자료
