Claude Code 막막해도 채팅창에 직접 써봐야 익숙해진다
2026.04.04
📝 한줄 요약
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. 막막하면 다시보기 보면서 하나씩 한 번에 다 익히려 하지 말고, 다시보기 켜두고 따라하면서 하나씩 버튼을 눌러보는 것도 방법이다.
😊오늘 21기 AI워크스페이스 모각 오프 모임이 많이 도움 되었습니다.
로그인하고 댓글을 남겨 주세요
직접 해보는것만큼 빠르게 배우는 방법은 없나봐요 정말. 저도 요즘 하나도 모르겠다 하는 상태인데, 용기를 얻어갑니다!! 감사해요!




20기의 학습을 회고하시고 있으시네요
기초가 탄탄해지면 AI가 더 똑똑해집니다.
AI는 정말 이 시대의 선물인 것 같습니다. 뭐든 뚝딱뚝딱~