데일리 밥

코딩 몰라도 쓰는 코딩 AI — 설치부터 첫 실행, 맡겨도 되는 일과 안 되는 일

Daily BaapIT/전자기기· 수정

코딩 몰라도 코딩 AI 를 쓸 수 있나 — 결론부터

됩니다. Claude Code 같은 도구는 채팅창에 답만 띄우는 게 아니라 내 컴퓨터의 실제 파일을 읽고 고칠 수 있어서, “이 폴더 사진 수백 장을 내용대로 이름 바꿔줘” 같은 말만 해도 실행까지 해줍니다. 다만 설치는 터미널(명령어를 입력하는 검은 화면)을 한 번 거쳐야 하고, 되돌리기·권한 설정을 모르고 쓰면 파일이 꼬일 수 있어서 그 부분을 짚어 드릴게요.

이 글은 Anthropic 공식 문서(code.claude.com/docs)를 기준으로, 2026년 8월 시점에 확인한 내용만 담았습니다.

시작하기 전에 — 필요한 것들

Claude Code(터미널용)를 쓰려면 아래가 필요하다고 공식 퀵스타트 문서에 나와 있어요.

  • 계정: Claude Pro, Max, Team, Enterprise 구독 중 하나이거나 Claude Console(API) 계정. 무료 플랜으로는 터미널용 Claude Code 를 쓸 수 없다고 적혀 있어요 (Claude Code 문서 — 빠른 시작)
  • 운영체제: macOS 13.0 이상, Windows 10 버전 1809 이상, 또는 Linux/WSL (Claude Code 문서 — 터미널 설정)
  • 지원 국가: 유료 플랜은 지원 국가에 실제로 있는 사람만 쓸 수 있다고 안내돼 있어요. 국가 목록은 Anthropic — 지원 국가 목록 에서 확인할 수 있어요

터미널 자체가 부담스럽다면, 터미널 없이 쓰는 데스크톱 앱도 공식으로 있어요. macOS·Windows 용 앱을 내려받아 설치할 수 있고, Linux 에서는 apt 로 설치할 수 있다고 안내 문서에 나와 있어요(Claude Code 문서 — 터미널 설정). 이 글은 터미널 버전을 기준으로 씁니다.

코딩 몰라도 맡길 수 있는 일

공식 문서와 안내 페이지에 실제로 나오는 예시들이에요.

파일·사진 정리 공식 터미널 안내서에 실제로 이렇게 시켜 보라는 예문이 있어요.

“바탕화면에 있는 스크린샷들을 보고 사진 안에 뭐가 있는지 보고 그걸 기준으로 이름을 바꿔줘” 라고 해 보세요.

Claude Code 가 사진을 하나씩 열어 보고 내용에 맞춰 파일명을 다시 붙여 줍니다(Claude Code 문서 — 터미널 설정).

메모·문서 폴더 정리 공식 문서에는 “메모 저장소나 문서 폴더 안에서 실행하면 코드를 다루듯이 마크다운 파일들을 검색하고 고치고 재정리할 수 있다”는 내용이 있어요. 코드 프로젝트가 아니어도 아무 폴더에서나 켤 수 있다는 뜻이에요(Claude Code 문서 — 자주 쓰는 작업).

표·데이터 가공 CSV 나 엑셀 파일 여러 개를 하나로 합치거나, 중복 값을 찾아내거나, 서식을 통일하는 식으로 썼다는 사용 사례가 여러 후기 글에서 자주 보이더라고요. Claude Code 는 필요하면 파이썬 같은 스크립트를 직접 짜서 실행하기 때문에, “이 CSV 다섯 개를 하나로 합치고 중복 행은 지워줘” 같은 말로 시킬 수 있어요. 다만 이건 공식 문서가 CSV 를 콕 집어 설명한 부분이 아니라 실사용 사례를 통해 확인한 내용이라는 점은 밝혀 둘게요.

반복되는 문서 서식 적용 여러 파일에 같은 머리말을 넣거나, 여러 문서의 날짜 표기를 통일하는 식의 반복 작업도 “폴더 안 파일들을 다루듯” 처리할 수 있는 범주에 들어가요. 코드가 아니라 텍스트 파일이라도 Claude Code 가 열고 고칠 수 있는 대상이면 됩니다.

설치부터 첫 실행까지

공식 터미널 안내서(Claude Code 문서 — 터미널 설정)에 나온 절차 그대로예요. 한 번도 터미널을 안 써 본 사람 기준으로 정리했습니다.

macOS

  1. Cmd + Space 를 눌러 스팟라이트 검색을 연다 → “Terminal” 을 입력하고 Enter → 깜빡이는 커서가 있는 창이 뜨면 그게 터미널이다
  2. 아래 줄을 그대로 복사해서 터미널에 붙여넣고(Cmd + V) Enter 를 누른다
curl -fsSL https://claude.ai/install.sh | bash
  1. 글자가 좌르륵 지나가다가 “Claude Code successfully installed!” 가 뜨면 설치 완료
  2. claude 라고 입력하고 Enter — 처음 실행하면 브라우저 창이 열리면서 로그인 화면으로 넘어간다. 화면 안내대로 로그인하면 끝

Windows

  1. Win + X → Windows PowerShell(또는 Terminal) 선택. 창 왼쪽에 PS C:\ 가 보이면 PowerShell 이 맞다(PS 없이 C:\ 만 보이면 CMD 이므로 다시 선택)
  2. 아래 줄을 붙여넣고 Enter
irm https://claude.ai/install.ps1 | iex
  1. “Claude Code successfully installed!” 가 뜨면 완료. claude 를 입력해 실행

공식 문서는 Windows 에서 Git for Windows 를 같이 설치하는 걸 권장해요. 없어도 PowerShell 로 대신 동작하지만, Git for Windows 를 깔면 Claude Code 가 Bash(리눅스식 명령어) 도구를 쓸 수 있다고 설명돼 있어요(Claude Code 문서 — 터미널 설정).

command not found: claude 나 'claude' is not recognized 오류가 뜨면 설치 경로가 시스템 경로(PATH)에 안 잡힌 경우예요. 설치가 끝날 때 화면에 뜨는 해결 명령을 그대로 실행하고 터미널을 새로 열면 대부분 해결된다고 안내돼 있어요.

로그인 후 프로젝트 폴더에서 claude 를 켜면 버전·모델·현재 폴더 위치가 위에 표시된 프롬프트가 나와요. /help 를 입력하면 쓸 수 있는 명령어 목록이 뜹니다.

터미널 창이 열린 노트북 화면, 설치 명령을 입력하는 것부터 시작한다

권한을 어디까지 줄지

Claude Code 는 파일을 고치거나 명령을 실행하기 전에 물어볼지 말지를 “권한 모드”로 정합니다. 세션 안에서 Shift + Tab 을 누르면 모드가 순서대로 바뀌어요(Claude Code 문서 — 권한 모드).

모드 뭘 물어보지 않고 하나 이럴 때
매뉴얼(default, 기본값) 없음 — 파일 수정, 명령 실행, 외부 접속 모두 매번 승인을 물어봄 처음 쓸 때, 뭘 하는지 하나씩 보고 싶을 때
acceptEdits 파일 수정만 자동 승인 파일 고치는 건 믿지만 명령 실행은 계속 확인하고 싶을 때
plan 아무것도 실제로 안 고침, 계획만 제안 뭘 할지 먼저 검토하고 싶을 때
auto 대부분 자동 — 대신 별도의 검토용 모델(“분류기”)이 위험해 보이는 행동을 걸러냄 Pro·Max·Team 플랜에서는 이게 기본 시작 모드
bypassPermissions 전부 자동 — 확인 자체를 안 함 격리된 컨테이너·가상머신처럼 실수해도 컴퓨터에 영향이 안 가는 환경

auto 모드는 Pro·Max·Team 플랜에서 기본으로 켜져 있는 시작 모드라고 공식 문서에 나와 있어요. 이 모드에서는 파일 읽기 같은 건 그냥 넘어가고, 프로젝트 폴더 안 파일 수정은 대체로 자동 진행되고, 셸 명령이나 프로젝트 바깥 작업·외부 접속처럼 위험도가 높은 행동만 분류기가 따로 검토합니다.

Anthropic 이 auto 모드를 설명한 엔지니어링 블로그(Anthropic 엔지니어링 블로그 — 자동 모드)에는 분류기가 실제로 막는 사례들이 나와 있어요 — 예를 들어 “오래된 브랜치를 정리해줘” 라고만 했는데 대량 삭제로 번지는 경우, 다른 인증 토큰을 몰래 찾아 쓰려는 경우, 만든 스크립트를 깃허브 Gist 같은 외부 공간에 올려 정보가 새어 나가는 경우예요. 다만 이 글에는 분류기가 위험한 행동의 17%는 놓친다는 수치도 함께 적혀 있고, “완전히 권한을 건너뛰는 것보다는 안전하지만 사람의 꼼꼼한 검토를 대신하지는 못하며 중요한 인프라에는 맞지 않는다”고 못 박아 뒀어요.

--dangerously-skip-permissions(bypassPermissions 와 같은 기능)는 처음 켤 때 책임을 인지했는지 묻는 경고창이 뜬다고 문서에 나와 있고, 관리자(root/sudo) 권한으로는 아예 실행할 수 없게 막혀 있어요. 인터넷이 안 되는 컨테이너나 가상머신처럼 격리된 환경에서만 쓰라고 권장돼 있고요.

처음 쓰는 사람에게는 기본값인 매뉴얼 모드를 그대로 두거나, 파일 수정만 자동으로 넘어가는 acceptEdits 정도가 적당해 보여요. bypassPermissions 는 코딩을 모르는 상태에서는 무엇이 위험한 행동인지 판단하기 어려우니 권하지 않습니다.

더 세밀하게 조정하고 싶으면 프로젝트 폴더의 settings.json 에 허용·차단 목록을 직접 적을 수 있어요. 공식 설정 문서(Claude Code 문서 — 설정)에 실린 예시예요.

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./secrets/**)"
    ]
  }
}

비밀번호나 API 키가 들어 있는 .env 파일, secrets 폴더는 이렇게 deny 목록에 넣어 두면 Claude Code 가 아예 못 읽게 막을 수 있어요.

잘못 고쳤을 때 되돌리는 법

Claude Code 는 파일을 고칠 때마다 자동으로 스냅샷(체크포인트)을 남겨요. 대화 입력창이 비어 있을 때 Esc 를 두 번 연달아 누르거나 /rewind 를 입력하면 되돌리기 메뉴가 뜹니다(Claude Code 문서 — 체크포인트).

메뉴에서 되돌릴 시점을 고르면 세 가지 중 선택할 수 있어요.

  • 코드와 대화 모두 되돌리기 — 파일과 대화 내용을 그 시점으로 완전히 복원
  • 대화만 되돌리기 — 지금 파일은 그대로 두고 대화만 되감기
  • 코드만 되돌리기 — 대화는 유지하고 파일 변경만 취소

세션 하나당 최근 100개 체크포인트까지 저장된다고 문서에 나와 있어요. 세션은 30일이 지나면 체크포인트와 함께 자동으로 지워지고, 이 기간은 설정의 cleanupPeriodDays 값으로 바꿀 수 있다고 적혀 있어요.

되돌리기가 안 통하는 경우도 명확히 적혀 있어요.

  • Claude 가 rm, mv, cp 같은 셸(터미널) 명령으로 파일을 지우거나 옮긴 경우 — 되돌리기 대상이 아니에요. 파일 편집 도구로 직접 고친 것만 추적됩니다
  • 백그라운드로 실행된 하위 작업(서브에이전트)이 고친 파일 — 대부분 되돌리기에 안 잡혀요. 이런 경우엔 문서에서도 Git 으로 직접 되돌리라고 안내해요
  • Claude Code 밖에서 내가 직접 손으로 고친 파일 — 당연히 추적 대상이 아니에요
  • 심볼릭 링크로 연결된 파일 — 되돌리기에서 건너뛴다고 나와 있어요

공식 문서에도 “체크포인트는 세션 단위의 빠른 복구용이고, 영구적인 버전 기록과 협업에는 계속 Git 을 쓰라”고 분명히 적혀 있어요. 중요한 프로젝트라면 Claude Code 를 쓰기 전에 Git 으로 커밋을 먼저 남겨 두는 습관이 안전합니다.

자물쇠와 열쇠가 노트북 옆에 놓인 장면, 어디까지 맡길지는 권한 설정으로 정한다

맡기면 안 되는 일

  • 정말 되돌릴 수 없는 행동 — 실제 결제, 실제 이메일·메시지 발송, 프로덕션 서버 배포처럼 한 번 실행되면 취소가 안 되는 일은 auto 모드나 bypassPermissions 로 통째로 맡기기보다, plan 모드로 먼저 뭘 할지 계획만 받아 보고 매뉴얼 모드로 한 단계씩 승인하는 편이 안전해요
  • 인증 정보·비밀키가 걸린 작업 — 위에서 본 것처럼 auto 모드의 분류기도 “다른 토큰을 몰래 찾아 쓰려는” 시도를 위험 행동으로 분류해서 걸러냅니다. 코딩을 모르는 사람은 API 키나 비밀번호가 든 파일을 미리 deny 목록에 넣어 두는 게 안전해요
  • 위험 행동 판단을 전적으로 AI 에 맡기는 것 — auto 모드의 분류기조차 위험한 행동의 17%는 놓친다고 Anthropic 이 직접 밝혔어요. “자동으로 다 알아서 해 줄 것”이라고 기대하고 bypassPermissions 로 켜 두는 건 코딩 지식이 없을수록 더 위험합니다
  • 관리자(root/sudo) 권한에서의 완전 자동 실행 — --dangerously-skip-permissions 는 애초에 root/sudo 권한에서는 실행이 안 되도록 막혀 있어요

이럴 땐 쓰지 마라

지금 하려는 게 마우스로 몇 번 클릭하면 끝나는 단순한 파일 이동 한두 개 정도라면, 터미널을 설치하고 배우는 데 드는 시간이 더 클 수 있어요. 반복 규칙이 있는 작업(수십~수백 개 파일에 같은 규칙 적용하기)이 아니라면 굳이 Claude Code 를 새로 설치할 이유는 크지 않습니다.

안 되는 경우 정리

  • 무료 플랜으로는 터미널용 Claude Code 를 쓸 수 없어요 (Pro·Max·Team·Enterprise 구독이나 Console 계정 필요)
  • macOS 13.0 미만, Windows 10 1809 미만 버전은 지원 밖이에요
  • 지원 국가 목록에 없는 곳에서는 유료 플랜 자체를 못 씁니다
  • 셸 명령으로 지우거나 옮긴 파일은 /rewind 로 못 되돌려요
  • 관리자(root/sudo) 권한에서는 --dangerously-skip-permissions 실행이 막혀 있어요

✔ 요약

  • 코딩 몰라도 파일 이름 정리, 문서 폴더 재정리 같은 일은 공식 예시로 확인됨
  • CSV·표 가공은 사용 후기 기반 — 공식 문서엔 콕 집어 나오진 않음
  • 설치는 터미널 열고 curl(맥·리눅스) 또는 PowerShell 명령(윈도우) 한 줄, 이후 claude 실행
  • 터미널이 부담되면 데스크톱 앱으로 대체 가능
  • 권한 모드는 매뉴얼(기본)·acceptEdits·plan·auto·bypassPermissions 다섯 단계
  • 처음엔 매뉴얼 또는 acceptEdits 권장, bypassPermissions 는 격리 환경에서만
  • 되돌리기는 Esc 두 번 또는 /rewind — 단, 셸 명령으로 한 변경은 못 되돌림
  • Git 을 병행하는 습관이 안전망
  • 무료 플랜 불가, 국가·OS 버전 제한 있음
  • 2026년 8월 기준, 공식 문서(Claude Code 문서 — 빠른 시작, Claude Code 문서 — 권한 모드, Claude Code 문서 — 체크포인트)에서 최신 내용을 다시 확인해 보세요

← 목록으로