[카테고리:] IT 활용 팁

  • 윈도우 PowerShell에서 Claude Code 설치하는 방법: 처음부터 실행까지

    윈도우 PowerShell에서 Claude Code 설치하는 방법: 처음부터 실행까지

    윈도우에서 Claude Code를 처음 설치한다면 PowerShell에서 시작하는 것이 가장 단순합니다. 핵심은 세 가지입니다. PowerShell인지 먼저 확인하고, 공식 설치 명령을 실행한 뒤, `claude` 명령으로 로그인과 실행 테스트를 끝내는 것입니다.

    Read in English: How to Install Claude Code in Windows PowerShell: From First Setup to First Run

    Windows PowerShell에서 Claude Code 설치 흐름을 보여주는 설명 이미지
    이미지: Thinknote 제작, Claude Code PowerShell 설치 흐름 요약

    이 글은 Windows PowerShell 기준입니다. CMD에서는 명령이 달라질 수 있고, WSL·macOS·Linux 설치법은 별도 명령을 사용합니다.

    먼저 확인할 것: PowerShell인지, CMD인지

    가장 흔한 실수는 PowerShell 명령을 CMD에서 실행하거나, CMD 명령을 PowerShell에서 실행하는 것입니다. 프롬프트가 PS C:\로 시작하면 PowerShell입니다. 그냥 C:\만 보이면 CMD일 가능성이 큽니다.

    상황의미대응
    프롬프트가 PS C:\로 시작PowerShell 사용 중이 글의 명령을 그대로 따라가면 됩니다.
    프롬프트가 C:\로 시작CMD 사용 중일 가능성시작 메뉴에서 PowerShell을 열거나 Windows Terminal에서 PowerShell 탭을 선택합니다.
    irm을 인식하지 못함대개 CMD에서 PowerShell 명령을 실행한 경우PowerShell을 다시 열고 명령을 실행합니다.
    && 구문 오류CMD 명령을 PowerShell에서 실행한 경우PowerShell용 명령과 CMD용 명령을 섞지 않습니다.

    1단계: Node.js가 필요한지 확인하기

    Anthropic 공식 문서 기준 Claude Code는 Windows 10 1809 이상 또는 Windows Server 2019 이상에서 사용할 수 있습니다. 설치 방식은 크게 공식 네이티브 설치와 npm 설치가 있습니다. 초보자라면 공식 PowerShell 설치 명령을 먼저 쓰는 편이 쉽습니다. npm 방식은 Node.js 22 이상 환경에서 대안으로 사용할 수 있습니다.

    node --version
    npm --version

    위 명령이 버전을 보여주면 Node.js와 npm이 설치되어 있습니다. 없다면 아래처럼 WinGet으로 Node.js LTS를 설치할 수 있습니다. 단, 공식 네이티브 설치 명령을 쓸 경우 Node.js를 반드시 먼저 설치해야 하는 것은 아닙니다.

    winget install OpenJS.NodeJS.LTS

    2단계: PowerShell에서 Claude Code 설치하기

    Windows PowerShell에서는 Anthropic 공식 빠른 설치 명령을 사용합니다. PowerShell을 열고 아래 명령을 실행합니다.

    irm https://claude.ai/install.ps1 | iex

    보안이 걱정된다면 바로 실행하기 전에 설치 스크립트를 먼저 열어 확인할 수 있습니다. 이 경우에도 출처가 공식 도메인인지 확인하는 습관이 중요합니다.

    irm https://claude.ai/install.ps1

    3단계: 설치 확인하기

    설치가 끝나면 새 PowerShell 창을 열고 버전을 확인합니다. 공식 문서에서는 정상 설치 시 버전 번호와 함께 Claude Code가 표시된다고 설명합니다.

    claude --version

    더 자세히 확인하려면 진단 명령을 실행합니다. 이 명령은 세션을 시작하지 않고 설치 상태와 설정 문제를 읽기 전용으로 점검합니다.

    claude doctor

    4단계: 로그인하고 첫 세션 시작하기

    Claude Code는 무료 Claude.ai 플랜만으로는 사용할 수 없습니다. 공식 문서 기준 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. 설치 후 아래 명령을 실행하면 브라우저 로그인 흐름이 열립니다.

    claude

    API 과금 기반으로 쓰려면 Console 계정 인증을 선택할 수 있습니다. 이미 API 키 환경변수를 쓰는 고급 사용자는 인증 방식이 달라질 수 있지만, 키 값은 절대 블로그나 코드 저장소에 직접 적지 않는 것이 원칙입니다.

    claude auth login --console
    claude auth status --text

    5단계: 프로젝트 폴더에서 실행하기

    Claude Code는 그냥 챗봇을 여는 도구가 아닙니다. 현재 폴더의 코드와 파일을 읽고, 필요한 경우 수정하며, 명령을 실행하는 코딩 에이전트입니다. 그래서 먼저 작업할 프로젝트 폴더로 이동한 뒤 실행하는 것이 좋습니다.

    cd C:\Users\me\Workspace\my-project
    claude

    처음 실행하면 폴더를 신뢰할지 묻는 안내가 나올 수 있습니다. 본인이 만든 프로젝트나 신뢰할 수 있는 저장소에서만 승인하세요. 모르는 폴더, 내려받은 압축 파일, 출처가 불명확한 코드는 먼저 내용을 확인하는 편이 안전합니다.

    npm으로 설치하는 대안

    Node.js 22 이상을 이미 쓰고 있다면 npm 전역 설치도 가능합니다. 공식 문서에 따르면 npm 패키지는 플랫폼별 네이티브 바이너리를 내려받아 연결합니다.

    npm install -g @anthropic-ai/claude-code
    claude --version
    설치 방식추천 대상메모
    공식 PowerShell 설치처음 설치하는 윈도우 사용자명령이 짧고 Windows용 공식 빠른 설치 흐름에 가깝습니다.
    npm 설치Node.js 22 이상을 이미 쓰는 개발자기존 Node/npm 환경을 관리하는 사람에게 편합니다.
    WinGet 설치패키지 관리자를 선호하는 사용자수동 업데이트 정책을 함께 확인해야 합니다.

    자주 나는 오류와 해결법

    오류 또는 증상가능한 원인해결 방법
    irm을 찾을 수 없음CMD에서 PowerShell 명령을 실행함PowerShell을 열고 다시 실행합니다.
    && 관련 오류PowerShell에서 CMD 명령을 실행함PowerShell용 명령과 CMD용 명령을 구분합니다.
    claude 명령을 찾을 수 없음설치 경로가 새 세션에 반영되지 않음PowerShell을 새로 열고 claude --version을 다시 실행합니다.
    로그인이 계속 실패계정 권한 또는 브라우저 인증 문제claude auth status --text로 상태를 확인하고 다시 로그인합니다.
    프로젝트에서 권한 안내가 나옴Claude Code가 폴더 접근 신뢰를 확인함신뢰할 수 있는 프로젝트에서만 승인합니다.

    처음 실행할 때 추천하는 명령

    설치가 끝났다면 바로 큰 작업을 맡기기보다, 현재 프로젝트를 설명해달라는 작은 요청부터 시작하는 것이 좋습니다. 그러면 Claude Code가 저장소 구조를 어떻게 읽는지 확인할 수 있습니다.

    claude
    
    # Claude Code 안에서 입력
    이 프로젝트 구조를 간단히 설명해줘.
    실행 가능한 테스트나 빌드 명령이 있으면 함께 알려줘.

    함께 보면 좋은 글

    FAQ

    Windows PowerShell에서 Claude Code 설치 명령은 무엇인가요?

    공식 빠른 설치 명령은 irm https://claude.ai/install.ps1 | iex입니다. PowerShell에서 실행해야 하며, CMD에서는 다른 명령을 사용해야 합니다.

    Claude Code 설치에 Node.js가 꼭 필요한가요?

    공식 네이티브 설치를 쓰면 Node.js를 먼저 설치하지 않아도 됩니다. 다만 npm 방식으로 설치하려면 Node.js 22 이상 환경이 필요합니다.

    Claude Code는 무료 Claude 계정으로 쓸 수 있나요?

    공식 문서 기준 Claude Code는 Pro, Max, Team, Enterprise 또는 Console 계정이 필요합니다. 무료 Claude.ai 플랜만으로는 사용할 수 없습니다.

    설치 후 가장 먼저 확인할 명령은 무엇인가요?

    claude --version으로 버전을 확인하고, 문제가 있으면 claude doctor로 설치 상태를 점검하세요.

    프로젝트 폴더에서 실행해야 하는 이유는 무엇인가요?

    Claude Code는 현재 폴더의 파일과 코드 구조를 바탕으로 작업합니다. 원하는 프로젝트 폴더로 이동한 뒤 claude를 실행해야 엉뚱한 폴더를 읽는 실수를 줄일 수 있습니다.

    참고자료

    정리하면, 윈도우에서는 PowerShell을 열고 공식 설치 명령을 실행한 뒤 claude --version, claude doctor, claude 순서로 확인하면 됩니다. 설치 자체보다 중요한 것은 실행 위치와 권한입니다. 신뢰할 수 있는 프로젝트 폴더에서 시작하고, API 키나 계정 정보는 절대 코드에 직접 남기지 마세요.

  • 맥 파일 정리: 하위 폴더 속 파일만 쉽게 추출하는 법

    맥 파일 정리: 하위 폴더 속 파일만 쉽게 추출하는 법

    맥에서 하위 폴더 속 파일만 따로 모아야 할 때

    맥을 사용하다 보면 여러 하위 폴더에 흩어진 파일을 한곳에 모아야 할 때가 있습니다.

    Read in English

    맥에서 하위 폴더 파일을 정리하고 추출하는 작업 화면 이미지
    하위 폴더에 흩어진 파일을 하나의 폴더로 정리하는 과정을 표현한 이미지

    예를 들어 프로젝트 자료, 사진, 다운로드 파일, 스캔 문서가 폴더별로 나뉘어 있을 수 있습니다. 이때 폴더 구조는 필요 없고 파일만 따로 모으고 싶다면 두 가지 방법을 사용할 수 있습니다.

    첫 번째는 Finder 검색 기능을 활용하는 방법입니다. 두 번째는 터미널에서 find 명령어를 사용하는 방법입니다.

    파일 수가 많지 않다면 Finder가 편합니다. 파일이 많거나 반복 작업이 필요하다면 터미널 방식이 더 빠릅니다.

    먼저 확인할 것: 복사와 이동은 다릅니다

    작업을 시작하기 전에 복사와 이동의 차이를 구분해야 합니다.

    복사는 원본 파일을 그대로 두고 새 위치에 같은 파일을 하나 더 만드는 방식입니다. 이동은 원래 위치에서 파일을 빼내 새 위치로 옮기는 방식입니다.

    중요한 자료라면 처음부터 이동하지 않는 것이 좋습니다. 먼저 복사로 테스트한 뒤 결과를 확인하고, 필요할 때만 이동을 진행하세요.

    방법 1. Finder 검색으로 파일만 모으기

    가장 쉬운 방법은 Finder의 검색 기능을 이용하는 것입니다. 명령어를 몰라도 되고, 결과를 눈으로 확인하면서 작업할 수 있습니다.

    1단계. 최상위 폴더 열기

    Finder를 열고 파일들이 들어 있는 최상위 폴더로 이동합니다.

    예를 들어 다음과 같은 구조가 있다고 가정해 보겠습니다.

    프로젝트 폴더
    ├── 1차 자료
    │   ├── 문서1.pdf
    │   └── 문서2.docx
    ├── 2차 자료
    │   ├── 이미지1.jpg
    │   └── 이미지2.png
    └── 참고자료
        └── 메모.txt
    

    목표는 프로젝트 폴더 아래의 하위 폴더 구조를 무시하고 파일만 한곳에 모으는 것입니다.

    2단계. Finder 검색창 열기

    최상위 폴더를 연 상태에서 다음 단축키를 누릅니다.

    Cmd(⌘) + F
    

    또는 Finder 우측 상단의 검색 아이콘을 클릭해도 됩니다.

    3단계. 검색어 입력하기

    검색창에 아래 검색어를 입력합니다.

    NOT kind:folder
    

    여기서 중요한 점은 NOT을 대문자로 입력하는 것입니다.

    이 검색어는 “폴더가 아닌 항목만 보여 달라”는 의미입니다. 즉, 하위 폴더는 제외하고 파일만 검색 결과에 표시합니다.

    4단계. 검색 범위를 현재 폴더로 바꾸기

    검색창 아래쪽을 보면 검색 위치를 선택하는 옵션이 있습니다.

    기본값이 이 Mac으로 되어 있으면 전체 맥에서 검색될 수 있습니다. 그러면 원하지 않는 파일까지 결과에 섞일 수 있습니다.

    그래서 검색 범위를 현재 작업 중인 폴더 이름으로 바꿔야 합니다.

    예를 들어 프로젝트 폴더 안에서 검색 중이라면 이 Mac이 아니라 프로젝트 폴더를 선택합니다.

    5단계. 파일을 전체 선택한 뒤 복사 또는 이동하기

    검색 결과에 파일만 표시되면 다음 단축키로 전체 선택합니다.

    Cmd(⌘) + A
    

    복사하려면 다음 순서로 진행합니다.

    Cmd(⌘) + C → 대상 폴더로 이동 → Cmd(⌘) + V
    

    이동하려면 다음 순서로 진행합니다.

    Cmd(⌘) + C → 대상 폴더로 이동 → Cmd(⌘) + Option(⌥) + V
    

    이동을 선택하면 원래 위치의 파일은 사라지고 대상 폴더로 옮겨집니다.

    Finder 방식이 적합한 경우

    Finder 방식은 다음 상황에 적합합니다.

    • 파일 수가 많지 않은 경우
    • 명령어 사용이 익숙하지 않은 경우
    • 파일을 눈으로 확인하면서 옮기고 싶은 경우
    • 실수로 잘못 이동하는 것을 피하고 싶은 경우

    단, 파일 수가 수천 개 이상이면 Finder가 느려질 수 있습니다. 이때는 터미널 방식이 더 안정적입니다.

    방법 2. 터미널 명령어로 파일만 복사하기

    파일이 많거나 하위 폴더가 복잡하다면 터미널을 사용하는 것이 좋습니다.

    터미널에서는 find 명령어로 하위 폴더 안의 파일만 찾을 수 있습니다. 그리고 찾은 파일을 원하는 폴더로 복사하거나 이동할 수 있습니다.

    1단계. 터미널 실행하기

    다음 단축키를 누릅니다.

    Cmd(⌘) + Space
    

    Spotlight 검색창이 열리면 터미널 또는 Terminal을 입력하고 실행합니다.

    2단계. 파일을 모아둘 폴더 만들기

    파일을 모아둘 새 폴더를 먼저 만들어 두는 것이 좋습니다.

    예를 들어 바탕화면에 모은파일이라는 폴더를 만들 수 있습니다. 터미널에서 만들려면 다음 명령어를 입력합니다.

    mkdir ~/Desktop/모은파일
    

    Finder에서 직접 새 폴더를 만들어도 됩니다.

    파일을 복사하는 명령어

    원본 파일은 그대로 두고 대상 폴더로 복사하려면 다음 형식을 사용합니다.

    find 원본폴더경로 -type f -exec cp {} 대상폴더경로 \;
    

    예를 들어 Downloads/자료 폴더 안의 모든 파일을 바탕화면의 모은파일 폴더로 복사하려면 다음과 같이 입력합니다.

    find ~/Downloads/자료 -type f -exec cp {} ~/Desktop/모은파일 \;
    

    여기서 마지막의 \;는 불필요한 문자가 아닙니다. find -exec 명령이 어디서 끝나는지 알려 주는 필수 표시입니다. Mac 터미널의 zsh/bash에서는 세미콜론을 그대로 쓰면 셸이 먼저 해석하므로, 앞에 역슬래시를 붙여 \;처럼 입력해야 합니다.

    이 명령어는 자료 폴더 아래의 모든 하위 폴더를 검사합니다. 그리고 폴더는 제외하고 파일만 찾아 모은파일 폴더로 복사합니다.

    파일을 이동하는 명령어

    파일을 원래 위치에서 빼내 대상 폴더로 이동하려면 cp 대신 mv를 사용합니다.

    find 원본폴더경로 -type f -exec mv {} 대상폴더경로 \;
    

    예시는 이렇게 볼 수 있습니다.

    find ~/Downloads/자료 -type f -exec mv {} ~/Desktop/모은파일 \;
    

    이 명령어를 실행하면 원본 폴더 안에 있던 파일들이 대상 폴더로 이동됩니다. 이동 후에는 기존 하위 폴더 안에 파일이 남아 있지 않습니다.

    경로 입력이 어렵다면 드래그 앤 드롭을 활용하기

    터미널에서 가장 헷갈리는 부분은 폴더 경로 입력입니다.

    경로를 직접 입력하기 어렵다면 Finder에서 폴더를 터미널 창으로 드래그 앤 드롭하세요. 그러면 폴더 경로가 자동으로 입력됩니다.

    파일을 이동하는 경우 전체 흐름은 이렇게 볼 수 있습니다.

    find [원본 폴더 드래그] -type f -exec mv {} [대상 폴더 드래그] \;
    

    실제 명령어는 아래와 비슷한 형태가 됩니다.

    find /Users/사용자이름/Downloads/자료 -type f -exec mv {} /Users/사용자이름/Desktop/모은파일 \;
    

    공백이 있는 폴더명도 드래그 앤 드롭하면 자동으로 처리되므로 직접 입력하는 것보다 안전합니다.

    같은 이름의 파일이 있으면 주의해야 합니다

    서로 다른 하위 폴더에 같은 이름의 파일이 있을 수 있습니다.

    예를 들어 다음과 같은 파일이 있다고 가정해 보겠습니다.

    A폴더/report.pdf
    B폴더/report.pdf
    

    두 파일을 같은 폴더로 모으면 파일 이름이 충돌합니다. 이 경우 명령어 방식에 따라 기존 파일이 덮어쓰기될 수 있습니다.

    중요한 자료라면 먼저 복사 방식으로 테스트하세요. 이동은 결과를 확인한 뒤 진행하는 편이 안전합니다.

    덮어쓰기를 피하는 안전한 복사 명령어

    같은 이름의 파일을 덮어쓰지 않으려면 cp -n 옵션을 사용할 수 있습니다.

    find 원본폴더경로 -type f -exec cp -n {} 대상폴더경로 \;
    

    예시는 이렇게 볼 수 있습니다.

    find ~/Downloads/자료 -type f -exec cp -n {} ~/Desktop/모은파일 \;
    

    -n 옵션은 대상 폴더에 같은 이름의 파일이 이미 있을 때 덮어쓰지 않도록 합니다.

    처음 작업한다면 이 방식이 더 안전합니다.

    Finder와 터미널 중 어떤 방법을 선택해야 할까?

    상황 추천 방법
    파일 수가 적다 Finder
    명령어가 익숙하지 않다 Finder
    파일을 눈으로 확인하면서 옮기고 싶다 Finder
    파일 수가 많다 터미널
    하위 폴더가 매우 복잡하다 터미널
    반복 작업이 필요하다 터미널
    빠르게 일괄 처리하고 싶다 터미널

    처음 시도한다면 Finder 방식으로 확인해 보는 것이 좋습니다. 대량 작업이 필요하거나 Finder가 느리다면 터미널 방식을 사용하면 됩니다.

    작업 전 체크리스트

    실수 없이 파일을 모으려면 아래 항목을 먼저 확인하세요.

    • 원본 폴더가 맞는지 확인합니다.
    • 파일을 모아둘 대상 폴더를 미리 만듭니다.
    • 중요한 자료는 먼저 복사로 테스트합니다.
    • 같은 파일 이름이 있을 수 있는지 확인합니다.
    • 이동 명령어는 테스트 후 사용합니다.

    이 다섯 가지만 확인해도 파일 손실 위험을 크게 줄일 수 있습니다.

    정리

    맥에서 하위 폴더 구조를 무시하고 파일만 한곳에 모으는 방법은 크게 두 가지입니다.

    Finder에서는 NOT kind:folder 검색을 사용하면 파일만 쉽게 골라낼 수 있습니다. 터미널에서는 find 명령어와 -type f 옵션을 사용하면 대량의 파일도 빠르게 처리할 수 있습니다.

    초보자라면 Finder 방식을 추천합니다. 파일이 많거나 반복 작업이 필요하다면 터미널 방식을 추천합니다.

    중요한 자료를 다룰 때는 바로 이동하지 말고 먼저 복사로 테스트하세요. 특히 같은 이름의 파일이 여러 폴더에 있을 수 있으므로 덮어쓰기 여부를 반드시 확인하는 것이 좋습니다.

    FAQ

    Finder에서 NOT kind:folder가 제대로 작동하지 않으면 어떻게 하나요?

    NOT을 대문자로 입력했는지 확인하세요. 또한 검색 범위가 이 Mac이 아니라 현재 작업 중인 폴더로 설정되어 있는지도 체크해 두세요.

    파일을 복사하지 않고 이동하려면 어떻게 하나요?

    Finder에서는 Cmd + C 후 대상 폴더에서 Cmd + Option + V를 누르면 이동됩니다. 터미널에서는 cp 대신 mv 명령어를 사용하면 됩니다.

    같은 이름의 파일이 있으면 어떻게 되나요?

    같은 이름의 파일이 대상 폴더에 이미 있으면 충돌이 발생할 수 있습니다. 안전하게 복사하려면 cp -n 옵션을 사용하는 것이 좋습니다.

    하위 폴더까지 그대로 복사되는 건 아닌가요?

    Finder에서 NOT kind:folder를 사용하거나 터미널에서 -type f 옵션을 사용하면 폴더가 아니라 파일만 선택됩니다. 그래서 하위 폴더 구조는 복사되지 않습니다.

    터미널 명령어가 부담스러우면 어떤 방법이 좋나요?

    파일 수가 많지 않다면 Finder 방식이 가장 쉽습니다. 터미널은 대량 파일 처리나 반복 작업이 필요할 때 사용하는 것이 좋습니다.