이 페이지의 목차
확인 2026-09-16근거 자료 13건갱신 2026-10-26언급 4곳
이 페이지의 목차
확인 날짜 안내

확인 날짜가 섞인 페이지다. A 갈래의 통합 화면 내용은 Help Center 문서·발표 글 기준(2026-09-16), 나뉜 화면 내용은 제품 가이드(원본 날짜 미상, 수집 2026-10-18) 기준이다. B 갈래는 Claude Code 공식 문서 수집일(2026-10-18·2026-10-21, 원본 날짜 미상) 기준이다. 페이지 확인 날짜는 그중 가장 오래된 날짜다. 명령·화면 위치·버전 조건은 몇 주 단위로 바뀌므로 강의 전에 링크한 페이지와 공식 문서를 다시 확인한다. 새 원본 없이 이미 위키에 있는 페이지와 그 근거 원본만으로 엮었다.

처음 보는 말은 용어 사전에서 찾는다. 자주 묻는 질문은 초보자가 자주 묻는 질문에 모았다.

0. 나에게 맞는 갈래 고르기#

이런 경우갈래근거
PDF 묶음 요약, Slack 대화로 상태 보고, 지저분한 표 정리처럼 문서·메시지·표 업무를 맡기고 싶다. 터미널은 쓰지 않는다A. 코드 없이 시작 (Claude Cowork)원본이 권하는 첫 업무 세 가지가 모두 이런 일이다 Claude Cowork 시작하기
주간 보고서와 발표 슬라이드를 한 대화에서 함께 맡기고 싶다A의 3단계Claude Cowork와 채팅 통합 공지
작업 폴더의 파일을 직접 고치고 명령을 실행하는 에이전트를 쓰고 싶다(코딩에 가장 강하지만 문서 쓰기·파일 찾기·자료 조사도 돕는다)B. Claude Code 안전하게 시작Claude Code 작동 방식
회사 전체에 정책을 걸어야 한다이 코스 범위 밖 → Claude Code 관리자 권한 통제Claude Code 권한 모드

두 갈래는 서로 독립적이다. 어느 쪽이 낫다는 판단은 원본에 없다.

  1. 시작

    갈래 고르기

A. 코드 없이 시작 - Claude Cowork

  1. A1 첫 세팅

  2. A2 첫 업무 위임

  3. A3 보고서·슬라이드 맡기기

B. Claude Code 안전하게 시작

  1. B1 설치·작동 방식 이해

  2. B2 권한 모드 고르기

  3. B3 샌드박스·작업 공간 신뢰

  4. B4 CLAUDE.md로 지시 남기기

  5. B5 스킬로 반복 업무 만들기

A. 코드 없이 시작: Claude Cowork#

2026-09-16부터 Cowork와 일반 채팅이 하나의 Claude로 합쳐지는 중이다. Pro·Max부터 계정마다 시점이 다르게 들어오므로, 같은 단계도 내 화면이 "나뉜 화면"(입력창에 Chat·Cowork 선택지가 보임)인지 "통합 화면"인지에 따라 자리가 다르다. Claude Cowork와 채팅 통합 도움말 → Claude Cowork

A1. 첫 세팅#

  • 목표: Claude가 내 업무 앱과 폴더에 닿을 수 있게 연결하고, 얼마나 자주 확인받을지와 늘 지킬 지시를 정해 둔다.
  • 준비물: Claude 데스크톱 앱(macOS 또는 Windows), 유료 구독(Pro, Max, Team, Enterprise), 세션 내내 인터넷 연결. Team·Enterprise는 관리자가 조직에 Cowork를 켜야 할 수 있다. Claude Cowork 시작하기
  • 할 일: Claude Cowork 시작 세팅을 따른다. 핵심은 세 가지다.
  • 됐는지 확인하는 법: Pro·Max 플랜에서 입력창에 "Chat"·"Cowork" 선택지가 아직 보이면 통합 화면을 받지 않은 것이다(원본은 이 한 방향만 말한다). 폴더는 연결하기 전에는 어떤 파일도 보지 않고, 처음 파일 작업을 요청하면 연결 안내가 뜬다. 통합 화면에서는 접근을 준 폴더가 Trusted folders 목록에 나온다(어느 화면에 있는지는 원본에 없다). Claude Cowork와 채팅 통합 도움말Claude Cowork 시작하기
  • 흔한 막힘: 회사 계정(Team·Enterprise)에서 Cowork가 안 보인다면 관리자가 조직에 켜야 할 수 있다. Claude Cowork 시작하기 이 위키에는 Cowork 전용 문제 해결 페이지가 아직 없다. 조건과 현재 제약은 Claude Cowork의 "쓰기 위한 조건"·"현재 제약과 사용량" 절에 있다.

A2. 첫 업무 위임#

  • 목표: 연습용 질문 대신 오늘 직접 하려던 실제 업무 하나를 맡겨, Claude가 잘하는 것과 못하는 것, 어떤 배경 정보가 필요한지를 배운다. Claude Cowork 시작하기

  • 준비물: A1 세팅, 맡길 업무 하나, 그 업무의 입력(파일이면 그 파일이 든 폴더, 앱 데이터면 그 앱의 커넥터). Claude Cowork 시작하기

  • 할 일: Claude Cowork 첫 업무 위임을 따른다. 원본이 든 첫 지시문 중 하나(원문):

    Point it at a folder of PDFs and ask for a one-page brief.

    통합 화면에서는 동료에게 브리핑하듯 원하는 결과("a one-page summary"), 형식(Word 문서, 슬라이드 덱, Slack에 붙여 넣을 메시지), Claude가 쓸 입력(파일, 링크, 앱) 세 가지를 담으면 결과가 좋아진다고 Help Center 문서는 말한다. Claude Cowork와 채팅 통합 도움말

  • 됐는지 확인하는 법: Claude가 단계마다 하는 일과 추론을 보여 주므로 따라가며 방향을 보고, 틀리면 중간에 끼어들어 바로잡는다. Claude Cowork 시작하기 통합 화면에서는 끝난 결과가 대화 안에 오고, Claude가 만든 파일은 대화 옆에 나타난다. Claude Cowork와 채팅 통합 도움말 결과물이 맞는지 판정하는 기준은 원본에 없다.

  • 흔한 막힘: 시크릿(Incognito) 채팅에서 시작하면 이전 화면으로 열려 파일을 만들 수 없다(2026-09-16 기준). Claude Cowork와 채팅 통합 도움말 → Claude Cowork "현재 제약과 사용량". 다운로드·삭제·공유 설정 변경 앞에서 확인 창이 뜨는 것은 막힘이 아니라 안전장치다("묻지 않고 실행" 모드에서도 뜬다고 제품 가이드는 말한다). Claude Cowork 시작하기

A3. 보고서·슬라이드 맡기기#

B. Claude Code 안전하게 시작#

Claude Code는 기본으로 claude를 실행한 폴더와 그 하위 폴더의 파일을 읽고 고치며 명령을 실행한다. 그래서 이 갈래는 "무엇을 묻지 않고 하게 둘지"를 먼저 정하고, 그다음에 지시와 반복 업무를 쌓는 순서다. Claude Code 작동 방식 → Claude Code

B1. 설치·작동 방식 이해#

  • 목표: Claude Code가 무엇에 닿고, 실수했을 때 무엇을 되돌릴 수 있는지 안다.
  • 준비물: Claude Code를 쓸 곳 하나. 터미널(용어 사전), 데스크톱 앱, IDE 확장, claude.ai/code 등이 있다. Claude Code 작동 방식
  • 할 일:
    • 설치: 이 위키에는 첫 설치 절차가 아직 없다. CLI 레퍼런스에는 네이티브 바이너리를 설치·재설치하는 claude install [version](원본 예: claude install stable)만 있고, 설치 순서는 원본이 Setup 문서로 넘긴다. Claude Code CLI 레퍼런스
    • 작동 방식 읽기: 에이전트 루프(맥락 수집 → 행동 → 결과 확인을 끝날 때까지 반복)와 Claude Code "작동 방식" 절의 접근 범위를 읽는다. Claude Code 작동 방식
    • 두 안전장치 알기: 편집 전 스냅샷(체크포인트, Esc 두 번으로 되감기)과 권한 모드. 체크포인트는 Claude가 편집한 파일만 되돌리고 데이터베이스·API·배포 같은 바깥 시스템에 한 일은 되돌리지 못한다. Claude Code 작동 방식 → Claude Code 세션·체크포인트 다루기
    • 명령 둘러보기: 세션 입력창에 /만 쳐서 쓸 수 있는 명령 목록을 본다. 처음에는 /help, /context, /compact, /clear, /rewind, /diff 정도면 된다. 플랜·플랫폼에 따라 안 보이는 명령이 있다(2026-10-26 기준). 작업 흐름별 표는 Claude Code 슬래시 명령. Claude Code 명령어 레퍼런스
  • 됐는지 확인하는 법: 터미널에서 claude doctor를 실행하면 세션을 열지 않고 설치 상태와 설정 파일 검증 오류를 읽기 전용으로 보여 준다. 세션 안의 /doctor는 설치·설정 문제를 진단하고 고칠 수도 있다. Claude Code CLI 레퍼런스Claude Code 작동 방식
  • 흔한 막힘: 시작할 때 Settings Error가 뜬다. 설정 파일이 잘못된 JSON이거나 거부된 값일 때다. → Claude Code 설정 바꾸기·확인·문제 해결 5절 Claude Code 설정 파일과 우선순위

B2. 권한 모드 고르기#

  • 목표: Claude가 파일 편집·명령 실행 앞에서 얼마나 자주 물을지를 정한다.

  • 준비물: B1. 버전 확인: v2.1.283 이상은 따로 정하지 않으면 대화형 터미널·VS Code 세션이 자동 모드로 시작한다(자동 모드를 쓸 수 없으면 Manual). Claude Code 권한 모드

  • 할 일: Claude Code 권한 모드 고르기를 따른다. 모든 동작을 직접 보고 싶으면 Manual 모드로 시작한다(원문 명령). Claude Code 권한 모드

    bash
    claude --permission-mode default

    CLI 세션 중에는 Shift+Tab으로 모드를 바꾼다. 이 기기에서 시작하는 터미널 세션의 기본값으로 두려면 ~/.claude/settings.json에 "permissions": {"defaultMode": "default"}를 넣는다. 프로젝트나 조직(managed) 설정에 이 값이 있으면 그쪽이 앞서고, VS Code 확장은 VS Code 사용자 설정의 claudeCode.initialPermissionMode를 쓴다. Claude Code 권한 모드 모드 이름(Manual, acceptEdits, plan, auto, bypassPermissions 등)의 풀이는 용어 사전.

  • 됐는지 확인하는 법: 상태 표시줄에 지금 모드가 뜬다(Manual이면 ⏸ manual mode on). VS Code는 프롬프트 상자 아래 모드 표시, 데스크톱 앱 Code 탭은 보내기 버튼 옆 모드 선택기다. Claude Code 권한 모드

  • 알아 둘 조건: 원본은 자동 모드가 확인 창을 줄이지만 안전을 보장하지 않고 민감한 작업의 검토를 대신하지 않는다고 경고한다. 거의 모든 확인을 건너뛰는 bypassPermissions는 인터넷 없는 컨테이너·VM 같은 격리 환경에서만 쓰라고 한다. deny 규칙은 모든 모드에서 막지만, 명령 규칙은 글자 그대로 맞추고 설치한 mod(도구 호출을 승인·거부할 수 있는 확장, 용어 사전)가 조건에 따라 넘을 수 있다(세부는 권한 모드). Claude Code 권한 모드Claude Code 권한 설정

  • 흔한 막힘: 자동 모드를 골랐는데 Manual로 시작한다. 그 세션에서 자동 모드를 쓸 수 없다는 뜻이다(설정 파일·모델·조직 조건). → Claude Code 권한 모드 고르기 6절 Claude Code 권한 모드

B3. 샌드박스·작업 공간 신뢰#

  • 목표: Claude가 실행하는 명령이 닿을 파일·인터넷 주소를 운영체제 수준에서 묶고, 처음 여는 폴더가 스스로 권한을 넓히지 못하게 하는 단계를 이해한다.
  • 준비물: macOS, Linux, WSL2 중 하나. Windows 네이티브에서는 샌드박스가 돌지 않으므로 WSL2 안에서 Claude Code를 돌린다. Linux·WSL2는 bubblewrap·socat이 필요하다(Ubuntu/Debian: sudo apt-get install bubblewrap socat). Claude Code 샌드박스
  • 할 일:
  • 됐는지 확인하는 법:

    • 샌드박스: 아래 명령을 Claude에게 돌려 달라고 한다. macOS는 Operation not permitted, Linux·WSL2는 Read-only file system으로 실패하면 샌드박스가 도는 것이다. 실패한 뒤 Claude가 이 명령을 샌드박스 밖에서 다시 돌리자고 하면 거절한다. 내가 !로 직접 치면 대개 샌드박스 밖에서 돌아 시험이 되지 않는다. Claude Code 샌드박스

      bash
      touch ~/sandbox-probe

    • 작업 공간 신뢰: 대화상자를 수락하기 전에는 저장소의 permissions.allow·additionalDirectories가 쓰이지 않는다. claude -p에서는 stderr(오류·경고 메시지가 나오는 출력 통로, 용어 사전)에 this workspace has not been trusted 경고가 뜬다. Claude Code 권한 설정

  • 알아 둘 조건(쉽게 줄여도 빼지 않는 예외):
    • 샌드박스는 기본으로 꺼져 있고 셸 명령과 그 하위 프로세스만 감싼다. 파일 편집 도구·훅·로컬 MCP 서버·내가 !로 친 명령(대부분의 세션)은 밖에서 돈다. 샌드박스에서 실패한 명령은 Claude가 밖에서 다시 돌리자고 할 수 있고(allowUnsandboxedCommands: false로 닫는다), 샌드박스가 못 뜨면 기본으로 샌드박스 없이 돈다(failIfUnavailable: true면 시작 때 종료). 원본은 샌드박스가 위험을 줄이지만 완전한 격리 경계가 아니라고 적는다. Claude Code 샌드박스 → 샌드박스
    • 신뢰 대화상자는 대화형 세션에서만 뜬다. 상위 폴더만 신뢰했거나 -p·SDK로 돌릴 때는 저장소의 훅·env·헬퍼 명령(apiKeyHelper처럼 설정 파일에 적어 두면 Claude Code가 대신 실행하는 보조 명령, 용어 사전) 같은 일부 설정이 신뢰 전에도 쓰이고, -p·SDK에서는 저장소 .mcp.json의 MCP 서버도 묻지 않고 연결된다(SDK는 프로젝트 설정을 읽게 했을 때). 신뢰 단계가 저장소의 모든 실행을 막는 것은 아니다. Claude Code 권한 설정
  • 흔한 막힘: touch가 성공했다. 홈 디렉터리가 쓰기 허용 디렉터리가 아니라면 ~/sandbox-probe를 지우고 /sandbox로 샌드박스가 켜졌는지, 의존성이 있는지 본다. → Claude Code 샌드박스 설정하기 3절·8절(증상별 문제 해결) Claude Code 샌드박스

B4. CLAUDE.md로 지시 남기기#

  • 목표: 매 세션 다시 설명하게 될 규칙·방법을 파일 하나에 적어 둔다.
  • 준비물: 작업할 프로젝트 폴더에서 연 Claude Code 세션.
  • 할 일: CLAUDE.md 작성·구성을 따른다. 세션에서 /init을 실행하면 Claude가 폴더를 분석해 시작용 CLAUDE.md(용어 사전)를 만들고, 이미 있으면 덮어쓰지 않고 개선안을 낸다. 그 뒤 Claude가 스스로 알아낼 수 없는 지시를 확인할 수 있게 구체적으로 더한다(원본 예: "Test your changes" 대신 "Run npm test before committing"). 파일당 200줄 이하가 목표다. Claude Code 메모리
  • 됐는지 확인하는 법: /context를 실행해 Memory files 목록에 파일이 있는지 본다. Claude Code 메모리
  • 알아 둘 조건: CLAUDE.md는 Claude가 읽고 따르려는 지시일 뿐 강제 장치가 아니다. 특히 모호하거나 충돌하는 지시는 엄격히 지켜진다는 보장이 없다. 반드시 막아야 할 일은 권한 규칙이나 훅으로 막는다(그 장치들의 조건은 권한 모드, 훅). Claude Code 메모리
  • 흔한 막힘: Claude가 CLAUDE.md를 따르지 않는다. → CLAUDE.md 문제 해결 증상 1(로드됐는지, 위치, 구체성, 파일 간 모순 순서로 점검) Claude Code 메모리

B5. 스킬로 반복 업무 만들기#

  • 목표: 채팅에 계속 붙여 넣는 절차 하나를 스킬(용어 사전)로 만들어, 다음부터 이름으로 부른다.

  • 준비물: 반복하는 절차 하나. 같은 지시·체크리스트를 계속 붙여 넣고 있거나, CLAUDE.md의 한 절이 절차로 자랐다면 후보다. 원본 예시 스킬은 git 저장소에서 시험한다. Claude Code 스킬

  • 할 일: 업무 절차를 스킬로 만들기를 따른다. 원본 예시는 개인 스킬 폴더를 만들고 그 안에 SKILL.md를 쓴다. Claude Code 스킬

    bash
    mkdir -p ~/.claude/skills/summarize-changes

    SKILL.md 맨 앞 머리말(frontmatter, 용어 사전)의 description에 무엇을 하는지와 언제 쓰는지를 쓰고, 그 아래 본문에 따를 지시를 쓴다. 예시 전문은 링크한 페이지 2절에 있다.

  • 됐는지 확인하는 법: 두 방법으로 부른다. 설명과 맞는 말(What did I change?)을 하거나 /summarize-changes를 직접 친다. 짧은 변경 요약과 위험 목록이 나오면 된다. 트리거됐다고 의도대로 일한 것은 아니므로, 같은 프롬프트를 스킬을 켠 채·끈 채로 새 세션에서 돌려 비교한다. Claude Code 스킬

  • 알아 둘 조건: 스킬은 Claude가 해석하는 지시라 건너뛸 수 있으니 매번 반드시 지켜야 할 규칙에는 맞지 않는다(훅으로). 남이 만든 공유 저장소의 스킬은 실행 전에 allowed-tools를 검토한다. 이 필드는 작업 공간 신뢰와 상관없이 적용돼 스킬이 스스로에게 넓은 도구 권한을 줄 수 있다. Claude Code 스킬

  • 흔한 막힘: 기대할 때 스킬이 안 불린다. → 스킬 문제 해결 1절(설명 키워드, What skills are available?로 목록 확인, YAML 오류) Claude Code 스킬

다음 단계#

언제 쓰고 언제 쓰지 않는가#

  • 쓴다: AI 에이전트를 처음 쓰는 사람이 첫날 무엇부터 할지 정할 때, 비개발자 대상 실습의 순서를 짤 때, 교육생에게 "어디까지 왔고 다음은 무엇인가"를 보여 줄 때.
  • 쓰지 않는다:
  • 주의: 단계별 "됐는지 확인하는 법"은 원본에 있는 방법만 적었다. Cowork 결과물의 품질 판정 기준, Claude Code 첫 설치 절차, 예약 작업을 고치거나 끄는 방법은 이 위키에는 아직 없다.

관련#