초보자가 자주 묻는 질문

확인 날짜 안내

확인 날짜가 섞인 페이지다. Claude Code 답은 공식 문서 수집일(2026-10-18·2026-10-21, 원본 날짜 미상), Cowork 답은 Help Center 문서·발표 글(2026-09-16)과 제품 가이드(원본 날짜 미상, 수집 2026-10-18), Gemini CLI 답은 2026-06-18·2026-10-09·2026-10-13 원본 기준이다. 페이지 확인 날짜는 그중 가장 오래된 날짜다(Gemini API 키 사용자의 상태는 2026-06-18 공지에만 근거한다). 낯선 말은 용어 사전에서 찾는다. 따라 하는 순서는 처음 시작하기 - 비개발자를 위한 AI 에이전트 입문 코스에 있다.

1. 무엇을 쓸까#

Q1. Cowork와 채팅은 뭐가 다른가?#

2026-09-16 발표로 둘은 하나의 Claude로 합쳐지는 중이고, 짧은 질문이든 보고서든 작업을 어디에 맡길지 고르지 않고 같은 Claude에 맡긴다. 다만 출시는 Pro·Max부터 계정마다 시점이 다르고, Pro·Max 플랜에서 입력창에 "Chat"·"Cowork" 선택지가 아직 보이면 통합 화면을 받지 않은 것이라 그때까지는 예전처럼 나눠 쓴다. 통합 전 Cowork는 데스크톱 앱에서 내 폴더와 업무 앱(커넥터, 용어 사전)을 연결해 실제 업무를 맡기는 모드였다. 근거: Claude Cowork · Claude Cowork와 채팅 통합 공지, Claude Cowork와 채팅 통합 도움말, Claude Cowork 시작하기

Q2. 개발자가 아니어도 Claude Code를 쓸 수 있나?#

공식 문서는 Claude Code가 코딩에 가장 강하지만 문서 쓰기, 파일 찾기, 주제 조사처럼 명령줄에서 할 수 있는 일이면 무엇이든 도울 수 있다고 말한다. 터미널(용어 사전) 말고도 데스크톱 앱, IDE 확장, claude.ai/code 같은 인터페이스가 있다. 다만 내 작업 폴더의 파일을 직접 고치고 명령을 실행하므로 권한 모드부터 정하고 시작한다. 근거: Claude Code, Claude Code 권한 모드 고르기 · Claude Code 작동 방식

Q3. Cowork는 무료 플랜으로 쓸 수 있나?#

제품 가이드는 Claude 데스크톱 앱과 유료 구독(Pro, Max, Team, Enterprise)을 조건으로 든다. 통합 발표(2026-09-16)는 Team·Free 플랜이 곧 뒤따른다고만 말하고, Free 플랜에서 어떤 기능까지 쓰게 되는지는 원본에 없다. Docs·Slides·Design은 같은 날 기준 유료 플랜 베타였다. 근거: Claude Cowork "쓰기 위한 조건" · Claude Cowork 시작하기, Claude Cowork와 채팅 통합 공지

Q4. Claude Code는 어떻게 설치하나?#

이 위키에는 첫 설치 절차가 아직 없다(공식 Setup·Quickstart 문서를 이 사이트에서 아직 다루지 않는다). CLI 레퍼런스에는 설치·재설치 명령 claude install [version](예: claude install stable)과, 세션 없이 설치 상태와 설정 오류를 읽기 전용으로 보여 주는 claude doctor가 있다. 근거: Claude Code CLI 플래그 · Claude Code CLI 레퍼런스

Q5. Gemini CLI를 아직 써도 되나?#

계정 종류에 따라 다르다. 개인 계정(Google AI Pro·Ultra, 무료)은 2026-06-18부터 요청 처리가 멈춰 Login with Google로는 접근할 수 없고, Google은 Antigravity CLI로 옮기라고 안내한다. 기업 라이선스(Gemini Code Assist Standard·Enterprise)와 API 키 사용자는 2026-06-18 기준 영향이 없었지만, Standard·Enterprise 구독은 2026-10-09부터 새로 살 수 없고 Google은 마지막 갱신일이나 계약 종료일 전에 Gemini Enterprise로의 전환을 계획하라고 권한다(2026-10-13 기준). 근거: Gemini CLI, Gemini CLI에서 Antigravity CLI로 옮기기 · Gemini CLI의 Antigravity CLI 전환 공지(2026-05-19, 기업 라이선스·API 키 접근 유지), Gemini CLI 개인 계정 요청 처리 중단 공지, Gemini Code Assist 개인 계정 중단 안내, Gemini Code Assist Standard·Enterprise 종료 일정

2. 내 파일과 컴퓨터는 안전한가#

Q6. AI가 내 파일을 마음대로 지울 수 있나?#

Cowork는 폴더를 연결하기 전에는 어떤 파일도 보지 않고, 통합 화면에서는 기본으로 로컬 파일을 영구 삭제하기 전에 묻는다("by default", 2026-09-16 기준). Claude Code는 v2.1.283 이상에서 따로 정하지 않으면 대화형 터미널·VS Code 세션이 자동 모드로 시작해, 사람 대신 분류기가 동작을 검토한다(Q8). Manual 모드는 파일 편집과 셸 명령 대부분 앞에서 묻지만, acceptEdits 모드는 작업 폴더 안의 rm·mv 같은 흔한 파일 명령을 묻지 않고, bypassPermissions는 거의 모든 확인을 건너뛴다. 루트·홈·작업 폴더 같은 치명 경로를 지우는 rm은 어떤 모드에서도 자동 승인되지 않지만, 실행 환경 변수로 이 검사 일부를 끌 수 있다. 근거: 권한 모드, Claude Code 권한 모드 고르기 1절, Claude Cowork · Claude Cowork 시작하기, Claude Cowork와 채팅 통합 도움말, Claude Code 권한 모드

Q7. 실수하면 되돌릴 수 있나?#

Claude Code는 파일을 편집하기 전에 스냅샷(체크포인트, 용어 사전)을 남겨 Esc 두 번으로 되감을 수 있다. 다만 되돌리는 것은 Claude가 편집한 파일 변경뿐이고, 데이터베이스·API·배포처럼 바깥 시스템에 한 일과 심볼릭 링크·하드 링크 파일은 되돌리지 못한다. 그래서 원본은 되돌릴 수 없는 동작을 권한 모드와 규칙으로 통제하라고 한다. 근거: Claude Code 세션·체크포인트 다루기 3절 · Claude Code 작동 방식

Q8. 자동 모드는 안전한가?#

자동 모드는 사람 대신 두 번째 모델(분류기)이 동작을 검토해 확인 창을 줄이는 모드로, 민감 데이터 외부 전송, 운영 배포, force push 같은 동작을 기본으로 막는다. 그러나 원본은 자동 모드가 안전을 보장하지 않으며 민감한 작업의 검토를 대신하는 용도가 아니라고 경고한다. 작업 저장소로의 push는 기본으로 묻지 않고 돌 수 있으니 사람 확인이 필요하면 permissions.ask 규칙을 더하되, 이 규칙은 명령을 쓰인 그대로 맞춘다. 근거: 권한 모드, Claude Code 자동 모드 설정하기 · Claude Code 권한 모드, Claude Code 자동 모드 설정

Q9. 샌드박스를 켜면 다 막히나?#

아니다. 샌드박스(용어 사전)는 Claude가 실행하는 셸 명령과 그 하위 프로세스만 감싸고, 파일 편집 도구·훅·로컬 MCP 서버·내가 !로 직접 친 명령(대부분의 세션)은 밖에서 돈다. 켜 두어도 샌드박스에서 실패한 명령은 Claude가 밖에서 다시 돌리자고 할 수 있고(allowUnsandboxedCommands: false로 닫는다), 샌드박스가 못 뜨면 기본으로 샌드박스 없이 돌며, Windows 네이티브에서는 돌지 않는다. 원본은 샌드박스가 위험을 줄이지만 완전한 격리 경계가 아니라고 적는다. 근거: 샌드박스, Claude Code 샌드박스 설정하기 · Claude Code 샌드박스

Q10. 대화에서 "그건 하지 마"라고 해 두면 지키나?#

자동 모드에서는 대화로 말한 경계(예: "don't push")를 분류기가 막는 신호로 쓰지만, 이 경계는 규칙으로 저장되지 않고 분류기가 검사 때마다 대화 기록에서 다시 읽는다. 그래서 대화가 길어져 요약(컴팩션)될 때 그 말을 담은 메시지가 지워지면 사라질 수 있고, 확실히 막으려면 deny 규칙을 쓰라고 원본은 말한다. 자동 모드가 아니어도 /compact는 대화를 구조화된 요약으로 바꾼다. 다만 명령(Bash) 규칙은 명령을 글자 그대로 맞추므로 다르게 쓴 같은 동작까지 막는다는 보장은 아니고, 조직 관리 설정이나 Team·Enterprise 로그인이 없으면 설치한 mod(도구 호출을 승인·거부할 수 있는 확장, 용어 사전)가 deny가 거부한 호출도 승인할 수 있다. 근거: Claude Code 권한 모드 고르기 5절, Claude Code 권한 규칙 문법 · Claude Code 권한 모드, Claude Code 자동 모드 설정, Claude Code 컨텍스트 창, Claude Code 권한 설정

Q11. 남이 준 폴더(저장소)를 Claude Code로 열어도 괜찮나?#

처음 여는 폴더의 설정 가운데 권한을 넓히는 것(프로젝트 permissions.allow 규칙 등)은 신뢰 대화상자를 수락한 뒤에만 적용되고, 대화상자는 그 폴더가 줄 규칙과 디렉터리를 먼저 보여 준다. 그러나 대화상자는 대화형 세션에서만 뜨고, 상위 폴더만 신뢰했거나 -p·SDK로 돌릴 때는 저장소의 훅·env·헬퍼 명령(apiKeyHelper처럼 설정 파일에 적어 두면 Claude Code가 대신 실행하는 보조 명령, 용어 사전) 같은 일부 설정이 신뢰 전에도 쓰인다. -p·SDK로 돌리면 저장소 .mcp.json에 적힌 MCP 서버도 묻지 않고 연결된다(SDK는 프로젝트 설정을 읽게 했을 때. 상위 폴더만 신뢰한 대화형 세션은 연결 전에 묻는다). 남의 폴더의 스킬은 allowed-tools가 신뢰와 상관없이 적용되니 실행 전에 검토한다. 근거: 작업 공간 신뢰 · Claude Code 권한 설정, Claude Code 스킬

Q12. Cowork는 내 컴퓨터 파일을 다 보나?#

아니다. 폴더를 명시적으로 연결하기 전에는 어떤 파일도 보지 않고, 처음 파일 작업을 요청할 때 연결 안내가 뜬다. 통합 화면에서는 접근을 준 폴더가 Trusted folders 목록에 나오고, 로컬 파일은 Claude Desktop이 열려 있는 동안에만 닿는다(2026-09-16 기준). 통합 화면에는 폴더 연결 말고도 내 컴퓨터의 앱을 화면에서 클릭·입력하며 직접 쓰는 컴퓨터 사용(Pro·Max 베타)과 내장 브라우저가 있고, 이것들도 Claude Desktop이 열려 있는 동안에만 닿는다. 근거: Claude Cowork "무엇을 연결하는가" · Claude Cowork 시작하기, Claude Cowork와 채팅 통합 도움말

3. 회사에서 쓸 때#

Q13. 회사에서 못 쓰게 막을 수 있나?#

Claude Code는 조직이 managed settings(용어 사전)로 기능 단위를 막을 수 있다: 자동 모드 없애기(disableAutoMode), bypassPermissions 막기(disableBypassPermissionsMode), deny 규칙이며, 사용자·프로젝트 설정은 managed 값을 덮어쓰지 못한다(몇몇 보안 키는 낮은 범위의 더 엄격한 값이 이긴다). 한계로 기기 로컬 관리자인 직원은 관리 파일 자체를 고칠 수 있고 managed settings는 Claude Code만 묶으며, Claude Code 사용 자체를 금지하는 방법은 이 위키에는 아직 없다. 금지는 아니지만, managed settings에 forceLoginOrgUUID(조직 ID)를 두면 claude.ai 계정 로그인을 회사 조직으로 묶을 수 있다(다른 설정 파일에 둔 단일 값은 로그인 때 조직을 미리 고를 뿐 제한하지 않는다). Cowork는 Team·Enterprise에서 관리자가 조직에 켜야 할 수 있다. managed Bash deny는 Cowork의 셸 명령에도 적용되지만, 정책이 그 Cowork 세션에 닿을 때만이다. 내 기기에서 도는 Cowork 세션은 기본으로 기기의 MDM·관리 파일을 읽지만 claude.ai 관리 콘솔의 서버 관리 설정은 Team·Enterprise 로그인이어도 가져오지 않고, 조직이 전체 VM 샌드박스(requireCoworkFullVmSandbox)를 켠 세션과 원격 Cowork 세션에는 기기 정책이 없다. 근거: Claude Code 관리자 권한 통제, managed settings, Claude Code 설정 키 레퍼런스 9절 · Claude Code 권한 모드, Claude Code managed settings 배포, Claude Code 설정 파일과 우선순위, Claude Code 설정 키 전체 레퍼런스, Claude Code 권한 설정, Claude Cowork 시작하기

Q14. 직원이 회사 설정을 몰래 바꾸거나 위험한 모드를 켤 수 있나?#

프로젝트 설정 파일에 넣은 auto·bypassPermissions 시작 모드는 효과가 없지만, 직원 자신의 사용자 설정이나 한 세션의 --permission-mode로는 여전히 고를 수 있어서, 막으려면 위 두 잠금 키를 managed settings에 둔다. 몇몇 보안 키는 낮은 범위의 더 엄격한 값이 이기므로 직원이 더 제한할 수는 있어도 더 풀 수는 없다. 단, 원본은 이 규칙 밖의 경우를 든다. 기기의 로컬 관리자인 직원은 관리 파일 자체를 고칠 수 있고(그래서 MDM 도구가 주기적으로 다시 배포할 수 있다), managed model은 잠금이 아니라 기본값이며, managed settings는 Claude Code만 묶어 다른 도구로 API를 부르는 직원에게는 적용되지 않는다(Q13의 Cowork 조건도 참고). 또 v2.1.257 전 버전에서는 bypassPermissions가 어느 파일에서든 효과가 있었다. 근거: Claude Code 관리자 권한 통제 1절, Claude Code 설정 파일, managed settings · Claude Code 권한 모드, Claude Code 설정 파일과 우선순위, Claude Code managed settings 배포

4. 지시와 반복 업무#

Q15. CLAUDE.md에 쓰면 반드시 지키나?#

아니다. CLAUDE.md(용어 사전)는 Claude가 읽고 따르려는 지시일 뿐 강제 장치가 아니고, 특히 모호하거나 충돌하는 지시는 엄격히 지켜진다는 보장이 없다. 원본은 확인할 수 있게 구체적으로 쓰고("Run npm test before committing"), 파일당 200줄 이하로 두고, 반드시 막아야 할 일은 권한 규칙이나 훅으로 막으라고 한다. 근거: 메모리(CLAUDE.md), CLAUDE.md 문제 해결 증상 1 · Claude Code 메모리

Q16. 매번 같은 설명을 반복하지 않으려면 어디에 적나?#

Cowork 통합 화면에서는 Settings > General의 Instructions for Claude에 톤·출력 형식·내 역할 같은 상시 지시를 두고, 관련 작업의 파일·지시·맥락은 프로젝트로 묶어 모든 대화에서 쓴다(2026-09-16 기준). Claude Code에서는 프로젝트의 CLAUDE.md에 두고, 개인 선호는 ~/.claude/CLAUDE.md에 둔다. 같은 절차를 계속 붙여 넣고 있다면 스킬로 만든다. 근거: Claude Cowork 시작 세팅, CLAUDE.md 작성·구성, 업무 절차를 스킬로 만들기 · Claude Cowork와 채팅 통합 도움말, Claude Code 메모리, Claude Code 스킬

Q17. 스킬과 서브에이전트는 무엇이 다른가?#

스킬(용어 사전)은 어느 대화에든 불러 싣는 재사용 지시·절차이고, 서브에이전트는 메인 대화와 따로 떨어진 자기 컨텍스트에서 일하고 결과 요약만 돌려주는 작업자다. 공식 문서는 컨텍스트 격리가 필요하거나 대화 창이 차 가면 서브에이전트를 쓰라고 하고, 블로그 글(2026-06-18)은 단계마다 보고 조종하고 싶은 절차는 스킬, 다시 볼 일 없는 중간 결과가 많은 곁가지 일(깊은 검색, 로그 분석)은 서브에이전트로 구분한다. 둘은 함께 쓸 수도 있다. 근거: Claude Code 확장 기능 고르기, 스킬, 서브에이전트 · Claude Code 확장 기능 개요, Steering Claude Code

Q18. Claude Code에서 만든 내 스킬을 Cowork에서도 쓸 수 있나?#

바로는 안 된다. 공식 스킬 문서에 따르면 Cowork 세션은 내 기기의 ~/.claude/skills/를 읽지 않고, claude.ai 계정에서 켠 스킬을 세션 시작 때 동기화해 쓴다. 계정에 올릴 때 frontmatter는 name, description, license, compatibility, metadata, allowed-tools 여섯 개만 쓸 수 있고, Claude Code 전용 본문 기능(동적 컨텍스트 주입 등)은 claude.ai 채팅에서 동작하지 않는다(2026-10-18 기준). 근거: Claude Cowork "스킬", 업무 절차를 스킬로 만들기 6절 · Claude Code 스킬

5. 일을 맡긴 뒤#

Q19. 노트북을 닫아도 일하나?#

Cowork(통합 화면)는 큰 작업을 노트북을 닫거나 페이지를 떠나도 클라우드에서 계속 돌리고, 휴대폰에서 진행을 보고 질문에 답할 수 있다. 하지만 내 컴퓨터의 파일이나 앱을 쓰는 작업은 Claude Desktop이 열려 있어야 한다. 예약 작업은 클라우드에서 돌 수 있어 컴퓨터가 꺼져 있어도 이어진다(2026-09-16 기준). 근거: Claude Cowork, Claude 대화 하나로 보고서·슬라이드 맡기기 4·8단계 · Claude Cowork와 채팅 통합 도움말, Claude Cowork와 채팅 통합 공지

Q20. 결과물이 맞는지 어떻게 확인하나?#

Cowork는 단계마다 하는 일과 추론을 보여 주므로 따라가며 보고, 틀리면 중간에 끼어들어 바로잡는다. 메시지 보내기나 중요한 파일 바꾸기처럼 결과가 실제로 남는 일은 가까이서 검토하라고 Help Center 문서는 권한다. 결과물의 품질을 판정하는 기준은 원본에 없다. Claude Code 스킬은 같은 프롬프트를 스킬을 켠 채·끈 채 새 세션에서 돌려 비교하라고 공식 문서는 말한다. 근거: Claude Cowork 첫 업무 위임 "됐는지 확인하는 법", 업무 절차를 스킬로 만들기 5절 · Claude Cowork 시작하기, Claude Cowork와 채팅 통합 도움말, Claude Code 스킬

이 위키에 아직 없는 답#

• Claude Code 첫 설치 절차(공식 Setup·Quickstart 이 사이트에서 아직 다루지 않음)
• Claude Code·Cowork 사용 자체를 조직에서 금지하는 방법
• Cowork 예약 작업을 고치거나 끄는 방법, Cowork 전용 문제 해결
• Free 플랜에서 통합 Claude의 어떤 기능을 쓰는지

관련#

• 처음 시작하기 - 비개발자를 위한 AI 에이전트 입문 코스
• 용어 사전
• Claude Code 관리자 권한 통제 — 고객이 묻는 통제 질문의 근거 표