📝 한줄 요약
API 키가 뭔지 몰라도, 폴더 구조가 복잡해도 - Claude Code 채팅창에 "모르겠다"고 치면 다음 단계가 열린다.
🎯 타겟 독자
Claude Code가 낯선 분
설치는 했는데 막막해서 손을 못 대고 있는 분
가끔 들어가면 그때마다 새로운 기분이 드는 분
😫 문제 상황 (Before)
Claude Code 사용이 익숙하지 않다. 게다가 가끔씩만 들어가다 보니 들어갈 때마다 새롭다. 그래서 연습 차원에서 이것저것 눌러보고 있는 중이다.
오늘은 20기 학습자료로 돌아가서 실행해보지 않은 스킬 - pkm-search(내 노트 검색) 를 켜보기로 했다.
연습 삼아 20기 학습자료에 있는 내용을 검색해봤다.
"GPTers 20기 AI 워크스페이스 학습 목표가 뭐야?"
그랬더니 Claude가 워크스페이스를 뒤진 끝에 이렇게 말했다.
"pkm-search 스킬이 아직 설정이 완료되지 않은 상태입니다."
설정을 안 했다니. 그럼 설정을 해야지. 시작됐다.
🛠️ 사용한 도구
Claude Code (VSCode 익스텐션)
pkm-search 스킬 (Gemini File Search API 기반)
Google AI Studio (Gemini API 키 발급)
🔧 작업 과정
"API키?" - 모르면 그냥 물 어봤다
설정을 시작하자 Claude가 말했다.
"Gemini API 키가 필요합니다."
API 키? 처음 들어보는 건 아닌데 어디서 어떻게 받는지 몰랐다. 그래서 그냥 채팅창에 물어봤다.
Claude는 링크까지 알려줬다. 링크 들어가서 버튼 누르고 키 복사해서 붙여 넣었더니 바로 연결됐다.
모르면 물어보면 된다. Claude Code 채팅창은 검색창이기도 하다.
"폴더가 너무 많아요" — Claude가 더 나은 방법을 알고 있었다
설정을 마치고 동기화를 하려니 문제가 생겼다. 워크스페이스 전체(233개 파일)가 검색 대상이 되어버린 것이다. 20기 학습자료만 검색하고 싶은데 다른 폴더들까지 다 걸리는 상황이었다.
처음엔 이렇게 생각했다.
"VSCode를 닫고 20기 폴더만 열어서 다시 시작하면 되지 않을까?"
VS CODE 껐다가 오픈폴더 해서 D:\02_claude\30-collected\35-gpters-study\20기_학습자료_AI워크스테이션 이 폴더만 다시 열어서 해도 될까? 너의 의견 알려줘좋은 생각입니다. 다만 트레이드 오프가 있습니다.
폴더를 좁히면 좋은 점
sync 대상 파일 수가 줄어서 빠름
검색 노이즈 감소 (관련 없는 파일 제외)
주의할 점
pkm-search는 이미 d:\02_claude 기준으로 233개 파일을 Gemini에 올려놓은 상태
폴더를 바꾸면 config_template.json의 base_path와 search_paths를 수정 후 init.py + sync.py를 다시 실행해야 함 (기존 Store는 재사용 가능)
제 의견
지금 목적이 "20기 학습자료에서 검색"이라면 VSCode 폴더를 바꾸지 않고 config_template.json의 search_paths만 아래처럼 좁히는 게 더 효율적입니다:
"search_paths": [
"30-collected/35-gpters-study/20기_학습자료_AI워크스테이션"
]
VSCode 루트를 바꾸면 .claude/CLAUDE.md 등 설정 파일도 못 읽게 됩니다.
어떻게 하실까요?Claude에게 물어봤다. 그랬더니 장단점을 설명해 줬다.
장점: 범위가 깔끔해짐
단점: VSCode 루트를 바꾸면
.claude/CLAUDE.md등 설정 파일을 못 읽게 됨. 뭔가 꼬이고 해결하려면 또 뭔가를 해야 함
그리고 이렇게 말했다.
"그냥 놔두세요. 설정 파일 한 줄만 바꾸면 20기 폴더만 검색하게 만들 수 있습니다."
그러라고 했더니 Claude가 직접 고쳐줬다. VSCode도 안 껐고, 파일도 안 옮겼다. 설정 파일 한 줄이 바뀌었을 뿐인데 동기화 대상이 233개 → 21개로 줄었다.
마지막 — 검색이 됐다
설정 완료 후 처음 질문을 다시 입력했다.
"GPTers 20기 AI 워크스페이스 학습 목표"
✅ 결과 (After)
pkm-search가 자세히 뭔지 모른 채, 그냥 채팅창에 쳐봤다
쳤더니 실제로 움직였다
"모르면 일단 쳐보면 된다"는 걸 확인함
💬 AI 활용 팁
1. 모르면 그냥 채팅창에 물어봐라 "API 키?", "어떻게 하면 돼요?" — 이런 질문도 다 받아준다. 구글 검색보다 빠를 때가 많다.
2. 내 생각보다 Claude가 더 나은 방법을 알 때가 있다 "폴더를 바꿔야 하나?"라고 물었더니 "그냥 설정 파일만 고치면 돼요"라고 했다. 직접 해보기 전에 한 번 물어보는 게 낫다.
3. 줄바꿈 단축키 — 이거 모르면 당황한다
VSCode 익스텐션:
Shift + Enter→ 줄바꿈터미널:
Alt + Enter→ 줄바꿈VSCode 익스텐션에서
Alt + Enter치면 줄바꿈 없이 바로 실행된다. 작은 것인데 마음의 걸림돌이 된다. 미리 알아두자.
다른 이야기 인데..
클로드코드에서 줄바꿈 할때는 shitt+enter 치면 되는데
alt+enter는 터미널에서 줄바꿈 명렁어네?
클로드코드에서 alt+enter치면 줄바꿈 되지 않고, 그냥 enter만 작동하는 것 같다.맞습니다.
Shift+Enter → Claude Code 입력창에서 줄바꿈
Alt+Enter → 터미널(bash)에서 줄바꿈 (Claude Code 입력창에서는 그냥 Enter와 동일하게 작동)
Claude Code는 VSCode 익스텐션이냐, 터미널이냐에 따라 동작이 다릅니다.
환경 줄바꿈 전송
VSCode 익스텐션 Shift+Enter Enter터미널(CLI) Alt+Enter Enter
지금 VSCode 익스텐션으로 쓰고 계시니까 Shift+Enter만 기억하면 됩니다.4. 막막하면 다시보기 보면서 하나씩 한 번에 다 익히려 하지 말고, 다시보기 켜두고 따라하면서 하나씩 버튼을 눌러보는 것도 방법 이다.
