안녕하세요! 🙂 아래는 2026년 8월 현재 공식 문서 기준 안내입니다. 공식 문서는 작업 디렉터리를 확장하는 방법을 세 가지로 구분하고 있어요. 시작할 때 --add-dir 인자를 쓰는 방법, 세션 중에 /add-dir 명령을 쓰는 방법, 그리고 영구적으로 설정하려면 settings 파일의 additionalDirectories 에 추가하는 방법입니다. claude /permissions 의 Workspace 탭에서 "Add directory…"로 추가하신 건 이 중 두 번째, 세션 중 추가 에 해당해요. 그래서 파일에는 남지 않고 클로드 코드를 종료하면 사라집니다. 첨부해주신 문서 섹션은 "settings 파일에 직접 써 두면 어떻게 동작하는가"를 설명하는 부분이라, UI에서 추가하면 자동 저장된다는 뜻은 아니에요. 영구적으로 두시려면 settings.local.json 에 직접 작성하시면 됩니다. Windows 경로는 JSON에서 백슬래시를 두 번 써야 하는 점만 주의해 주세요. json { "permissions": { "allow": ["Bash"], "additionalDirectories": [ "D:\\coding\\claude-study\\claude-code-master\\workspace" ] } } 한 가지 더 알아두시면 좋은 차이가 있어요. additionalDirectories 로 추가한 디렉터리는 파일 접근 권한만 부여하고, 그 폴더의 .claude/ 설정은 불러오지 않습니다. 반면 --add-dir 이나 /add-dir 로 추가하면 해당 폴더의 스킬과 서브에이전트까지 함께 로드돼요. 단순히 파일만 읽고 쓰면 되는 경우와, 다른 폴더의 스킬·서브에이전트까지 쓰고 싶은 경우가 다르니 목적에 맞게 선택하시면 됩니다. claude 그리고 프로젝트 설정의 additionalDirectories 는 워크스페이스 신뢰 다이얼로그를 수락한 뒤에야 적용됩니다. 설정을 넣었는데 반영이 안 되는 것 같으면 이 부분을 확인해 보세요. claude 문서까지 직접 찾아보시고 파일 내용까지 확인해서 질문 주셔서 저도 정확하게 답변드릴 수 있었어요 🙂 출처 (2026년 8월 기준): Working directories · Additional directories grant file access, not configuration 감사합니다 🙂
안녕하세요! 🙂 node_modules 폴더가 없어서 생긴 오류 예요. npm run dev 는 package.json 에 적힌 next dev 를 대신 실행해주는 명령이에요. 그런데 이 next 라는 프로그램은 컴퓨터에 원래부터 있는 게 아니라, 프로젝트 폴더 안 node_modules 에 설치되어야 쓸 수 있습니다. 올려주신 파일 목록을 보면 node_modules 폴더가 없죠. 그래서 윈도우가 "그런 명령은 없는데요"라고 답한 거예요. create-next-app 실행 중에 패키지 설치 단계가 끝까지 진행되지 않은 것으로 보입니다. 프로젝트 폴더에서 아래 두 줄을 차례로 실행해 보세요. bash npm install npm run dev npm install 이 끝나면 node_modules 폴더가 생기고, 그다음 npm run dev 가 정상적으로 실행될 거예요. 그리고 이런 환경 오류야말로 클로드 코드에게 바로 물어보시면 가장 빨리 해결됩니다. 클로드 코드는 지금 프로젝트 폴더 안에 있으니 파일 상태를 직접 확인하고 원인을 찾아줘요. 이렇게 던져보세요. npm run dev을 실행했더니 이 에러가 났어. 'next'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다. 현재 프로젝트 상태를 확인해서 원인을 찾고 해결해줘. 에러 메시지를 그대로 복사해서 붙여넣는 게 핵심 이에요. 요약하거나 다듬지 않으셔도 됩니다. 오히려 원문 그대로가 정보량이 훨씬 많거든요. 설치 오류는 PC 환경마다 다르게 나타나는 경우가 많아서, 저도 이런 상황에서는 터미널 명령을 하나씩 찾아보는 대신 클로드 코드에게 맡기는 편이에요. 강의에서 배우신 워크플로우를 실제로 써먹는 순간이기도 하고요 🙂 혹시 클로드 코드로도 해결이 안 되면, 주고받은 내용을 캡처해서 남겨주세요. 감사합니다 🙂
안녕하세요! 🙂 오랜만에 켜셔서 로그인 세션이 만료된 것뿐이라 걱정하지 않으셔도 됩니다. 아래는 2026년 8월 현재 공식 문서 기준 안내예요. 클로드 코드는 로그인 정보를 토큰 형태로 저장해 두는데, 오래 사용하지 않으면 이 토큰이 폐기됩니다. 오류 메시지의 OAuth access token has been revoked 가 딱 그 의미예요. 강의를 따라 하다가 뭔가 잘못되신 게 아니라, 그냥 다시 로그인하면 되는 상황입니다. 클로드 코드가 실행된 상태에서 아래를 입력해 주세요. /login 브라우저가 열리면서 로그인 화면이 뜨고, 완료하면 바로 이어서 사용하실 수 있어요. 혹시 로그인했는데도 같은 오류가 다시 나온다면, /logout 으로 저장된 토큰을 완전히 지운 뒤 다시 /login 을 실행해 보세요. 이러면 대부분 해결됩니다. Claude Code Docs 출처 (2026년 8월 기준): Claude Code 오류 레퍼런스 다시 공부 시작하시는군요. 응원하겠습니다 💪 감사합니다 🙂
안녕하세요! 🙂 기존 데스크탑 앱은 삭제하지 않으셔도 됩니다. 둘은 서로 충돌하지 않고 함께 쓸 수 있어요. 아래는 2026년 8월 현재 공식 문서 기준 안내입니다. 먼저 헷갈리기 쉬운 부분부터 정리할게요. 데스크탑 앱에는 클로드 코드가 이미 포함되어 있어서 별도 설치가 필요 없지만, 터미널에서 claude 명령으로 쓰시려면 CLI를 따로 설치해야 합니다. 즉 데스크탑 앱과 CLI는 같은 클로드 코드를 쓰는 서로 다른 출입구 예요. 앱을 설치했다고 터미널 명령까지 자동으로 되는 건 아닙니다. Claude Code Docs 그래서 지금 하실 일은 이거 하나예요. 터미널을 열고 아래를 입력해 보세요. bash claude --version 버전 번호가 나오면 CLI도 이미 설치되어 있는 거라 그대로 강의를 따라오시면 되고, 명령을 찾을 수 없다고 나오면 강의대로 CLI를 설치하시면 됩니다. 이때도 기존 데스크탑 앱은 지우실 필요 없어요. 설정과 대화 기록을 같은 폴더( ~/.claude )에서 공유하기 때문에 계정도 설정도 따로 관리되지 않습니다. 강의는 터미널(CLI) 기준으로 진행돼요. 화면이 같아야 따라오시기 편하니 실습은 CLI로 하시고, 시각적으로 diff를 확인하고 싶으실 때 데스크탑 앱을 함께 쓰시는 걸 추천드립니다 🙂 출처 (2026년 8월 기준): 데스크탑 앱 시작하기 · 설치 가이드 감사합니다 🙂
안녕하세요! 🙂 정말 좋은 질문이에요. 결론부터 말씀드리면, 여기서 말하는 '필요한 정보'는 기술 지식이 아니라 '내가 원하는 것' 입니다. 이렇게 나눠보면 명확해져요. 코드를 어떻게 짜는지, 어떤 기술을 쓰는지는 클로드가 이미 알고 있거나 직접 찾아냅니다. 반면 누구를 위해, 무엇을, 왜 만드는지는 오직 질문자님만 알고 있어요. 이건 클로드가 아무리 뛰어나도 알아낼 방법이 없습니다. 그래서 이 부분만 정확히 전달하면 되는 거예요. 그러니까 지식이 0이어도 전혀 문제가 없습니다. 예를 들어 이 정도면 충분해요. 동네 필라테스 학원 홈페이지를 만들고 싶어요. 방문자가 수업 시간표를 보고 전화로 상담 예약하는 게 목적이에요. 차분하고 깔끔한 느낌이면 좋겠어요. 기술 용어가 하나도 없죠. 그래도 클로드는 여기서 필요한 걸 다 뽑아냅니다. 반대로 "홈페이지 만들어줘"라고만 하면 클로드는 아무거나 만들 수밖에 없어요. 판단할 정보가 없으니까요. 그리고 뭘 말해야 할지조차 모르겠다면, 질문을 클로드에게 시키시면 됩니다. 홈페이지를 만들려고 하는데 제가 관련 지식이 전혀 없어요. 필요한 걸 하나씩 질문해 주세요. 이러면 클로드가 묻고 질문자님은 답만 하시면 돼요. 이 과정이 강의에서 다루는 탐색 → 계획 → 구현 중 첫 단계인 탐색입니다. 처음부터 다 알고 시작하는 게 아니라, 모르는 걸 대화로 채워가는 것 자체가 워크플로우예요. 정리하면 이렇습니다. 기술은 클로드가 채우고, 의도는 내가 채운다. 이 둘이 만나면 결과물이 나옵니다 🙂 감사합니다 🙂
안녕하세요! 🙂 먼저 말씀드리면 설정을 잘못하신 게 아니에요. 아래는 2026년 8월 현재 공식 문서 기준 안내입니다. Windows에서 Git for Windows가 없으면 PowerShell 도구로, 설치되어 있으면 Git Bash를 통해 Bash 도구로 명령을 실행합니다. 다만 Git for Windows가 설치되어 있어도 PowerShell 도구가 Bash와 함께 추가 옵션으로 순차 배포되는 중이고, CLAUDE_CODE_USE_POWERSHELL_TOOL 을 1 로 켜거나 0 으로 끌 수 있어요. Claude Code Docs PowerShell 도구는 비교적 최근에 추가된 기능이라 아직 전체 사용자에게 한 번에 열리지 않고 순차적으로 적용되는 중이에요. 수강생분 환경에 먼저 도착한 상황이라고 보시면 됩니다. 강의와 동일하게 Bash로 맞추고 싶으시면 settings.json 에 아래를 추가하고 클로드 코드를 재시작해 주세요. json { "env": { "CLAUDE_CODE_USE_POWERSHELL_TOOL": "0" } } 권한 관리 강의를 보고 계시니 당분간은 이렇게 맞춰두시는 걸 권해요. 권한 규칙은 도구 이름 단위로 지정하기 때문에, 강의에서 다루는 Bash(...) 규칙과 실제 실행되는 도구를 일치시켜 두는 편이 덜 헷갈립니다. 반대로 레지스트리나 서비스 관리처럼 Windows 네이티브 작업이 많아지면 그때 다시 1 로 켜시면 돼요. Claude Code Docs 클로드 코드는 업데이트가 워낙 빨라서 이런 변화가 종종 있어요. 영상과 화면이 다르면 편하게 질문 남겨주세요. 그때그때 최신 문서 기준으로 확인해서 알려드리겠습니다 🙂 출처 (2026년 8월 기준): Windows 설치 가이드 · PowerShell 도구 감사합니다 🙂
안녕하세요! 🙂 첫 번째는 사실 특별한 방법이 없어요. 저도 Cursor 통합 터미널( Ctrl + 백틱)을 열고 claude 를 입력합니다. 이게 전부라서 검색으로는 안 나왔을 거예요 ㅎㅎ 참고로 Anthropic에서 VS Code/Cursor용 확장 프로그램도 제공하는데, 설치하면 채팅 패널 형태로도 쓸 수 있어요. 강의는 CLI 기준이라 지금처럼 터미널로 쓰셔도 전혀 문제없습니다. → VS Code에서 Claude Code 사용하기 두 번째, 터미널 탭 이름은 잘못되신 게 아니에요. VS Code는 탭 제목에 기본적으로 감지된 프로세스 이름을 표시합니다. 클로드 코드는 Node.js로 동작하니까 실행 중이면 node , 종료 상태면 셸 이름인 bash 나 powershell 이 뜨는 거예요. 제 화면이 node 였던 건 그때 클로드 코드가 켜져 있었기 때문입니다. → Terminal Appearance visualstudio 노란색 삼각형은 확장 프로그램이 터미널 환경 변수를 변경해서 재시작이 필요할 때 뜨는 경고 아이콘인 경우가 가장 많아요. 아이콘에 마우스를 올리면 어떤 변경인지 내용과 함께 Relaunch 버튼이 나옵니다. 눌러서 재시작하셔도 되고, 그냥 두셔도 클로드 코드 사용에는 지장 없어요. → Extension environment contributions visualstudiovisualstudio 세 번째가 실제 원인이 있는 문제예요. Cursor(VS Code)의 기본 단축키 Ctrl+R 이 Open Recent(최근 항목 열기) 라서, 에디터가 키 입력을 먼저 가로채고 터미널까지 전달하지 않는 겁니다. 그래서 "select to open" 창이 뜨는 거예요. settings.json 에 아래 한 줄을 추가하시면 Ctrl+R 이 터미널로 전달됩니다. 명령 앞에 - 를 붙이면 "에디터가 가로채지 말고 셸로 보내라"는 뜻이에요. visualstudio json "terminal.integrated.commandsToSkipShell": ["-workbench.action.openRecent"] → Keyboard shortcuts and the shell 마지막으로 단축키를 한 번 정리해 드릴게요. 현재 클로드 코드에서 도구 실행 내역을 상세히 보는 건 Ctrl+O (트랜스크립트 뷰어), Ctrl+R 은 이전에 입력했던 프롬프트를 검색하는 기능입니다. "작업 내역을 다 보는" 게 목적이시면 Ctrl+O 를 눌러보세요. → Claude Code 단축키 claude 감사합니다 🙂
안녕하세요! 🙂 결론부터 말씀드리면, @ 입력 후 목록에서 직접 선택 하시면 한 번에 잡힙니다. @ 뒤에 이름만 타이핑해서 보내면 클로드 코드는 이걸 파일 멘션 으로 해석해요. 그래서 prd-generator 라는 파일을 찾아 헤매다가 결국 클로드가 직접 PRD를 작성해버린 겁니다. 템플릿이 안 지켜진 것도 서브에이전트가 아예 실행되지 않아서예요. 호출은 두 가지 방법이 있어요. @ 입력 후 타입어헤드에서 prd-generator (agent) 선택 직접 타이핑하실 거면 @agent-prd-generator 처럼 agent- 접두사를 붙이기 (타이핑 중에는 파일 목록이 뜨지만 전송하면 에이전트로 인식됩니다) claude @ 목록에 아예 안 뜬다면 두 가지만 확인해 주세요. 먼저 프론트매터의 name 값이 prd-generator 가 맞는지요. 파일명이 아니라 name 값이 식별자입니다. 그리고 .claude/agents/ 폴더를 세션 도중에 처음 만드셨다면 클로드 코드를 완전히 재시작해 주세요. 공식 문서에도 세션 시작 시점에 없던 폴더는 감지되지 않아 재시작이 필요하다고 나와 있어요. ( 공식 문서 ) claudeclaude 하나만 더 말씀드리면, 클로드에게 "왜 그랬냐"고 물어서 받은 답변(Bash 경로 해석 실패 → Glob으로 성공)은 그럴듯하게 들리지만 실제 원인이라는 보장이 없어요. LLM은 자기가 왜 그렇게 행동했는지 들여다볼 수 없어서, 질문을 받으면 사후에 말이 되는 설명을 만들어냅니다. 이걸 근거로 디버깅하면 계속 헤매게 돼요. 원인은 문서와 실제 동작으로 확인하시는 게 훨씬 빠릅니다. 감사합니다 🙂
안녕하세요! 🙂 먼저 eggmun(문성진)님께서 답변 남겨주셨네요. 감사합니다 🙏 말씀해주신 대로 경고 아이콘에 마우스를 올려두면 이유가 툴팁으로 뜨고, 대부분은 그대로 사용하셔도 되는 안내성 메시지예요. 궁금해하셨던 node / bash 차이만 덧붙일게요. 잘못하고 계신 거 아니에요. 터미널 탭에 표시되는 이름은 그 터미널에서 실행 중인 프로세스 이름 이라, 클로드 코드가 실행 중이면 node , 종료했거나 아직 실행 전이면 셸 이름인 bash 로 뜹니다. 제 화면이 node 였던 건 그때 클로드 코드가 켜져 있었기 때문이에요. 툴팁 확인해보시고 계속 걸리는 부분 있으면 캡처해서 남겨주세요. 확인해 드릴게요. 감사합니다 🙂
안녕하세요! 🙂 미션은 수강생분들이 직접 손으로 해보시도록 돕기 위한 장치일 뿐, 수료 여부와는 관련이 없습니다. 인프런 수료증은 강의 영상을 100% 수강하신 뒤 '강의 완료' 버튼을 누르면 자동으로 발급되는 것으로 안내되고 있어요. 미션 수행 여부는 조건에 포함되지 않으니 걱정하지 않으셔도 됩니다. 다만 수료증 발급 정책은 인프런에서 관리하는 부분이라, 정확한 내용은 인프런 고객센터 1:1 문의로 확인해 보시는 걸 권해드려요. 감사합니다 🙂
