Claude Cowork 에러 메시지 총정리 ② — 워크스페이스는 뜨는데 안 될 때 (폴더·커넥터·파일 저장 오류)
Claude 데스크톱의 Cowork를 켰더니 워크스페이스(작업 공간)는 정상적으로 떴다. 그런데 막상 시켜보면 파일이 저장되지 않거나, 연결해 둔 커넥터가 “이 커넥터는 인증이 필요합니다”라는 말만 반복하거나, 분명히 만들었다는 파일이 폴더에 보이지 않는다. VM이 아예 안 뜨는 문제는 지난 ①편에서 다뤘고, 이번 글은 “워크스페이스는 멀쩡히 뜨는데 그 다음이 안 되는” 에러들을 메시지별로 정리한다.
결론부터 말하면, 이 단계의 오류는 대부분 권한·인증·저장 위치 세 가지 중 하나다. VM 오류처럼 시스템 기능을 켜야 하는 무거운 문제가 아니라, 폴더 연결을 다시 하거나 커넥터를 껐다 켜는 수준으로 풀리는 경우가 많다. 어느 유형인지부터 구분하고 순서대로 처방하자.
이 글의 기준: Claude Cowork는 리서치 프리뷰(정식 출시 전) 기능이라, 화면 메뉴 명칭·버튼 위치·에러 문구가 업데이트마다 자주 바뀐다. 아래 절차는 2026년 7월 기준이며, 세부 UI는 버전에 따라 다를 수 있다. [확인 필요]
이 글의 범위 — VM 오류는 ①편, 여기는 그 다음 단계
Cowork 문제는 크게 두 층으로 나뉜다. 어느 층인지 알면 헤맬 일이 절반으로 준다.
| 구분 | ①편 — 워크스페이스가 아예 안 뜸 | ②편 (이 글) — 뜨는데 그 다음이 안 됨 |
|---|---|---|
| 대표 증상 | “Failed to start Claude’s workspace” / VM service not running | 파일 저장 실패, 커넥터 인증 실패, 파일이 안 보임 |
| 진짜 원인 | Hyper-V·가상 머신 플랫폼·WSL2 등 가상화 스택 | 폴더 권한 / 커넥터 인증 토큰 / 저장 경로 |
| 해결 난이도 | Windows 기능 켜기·재부팅 등 무거움 | 폴더 재연결·커넥터 토글 등 가벼움 대체로 |
워크스페이스가 애초에 안 뜬다면 이 글이 아니라 ①편(가상화·VM 오류)을 먼저 보자. 아래 절차는 워크스페이스가 정상 부팅된 상태를 전제로 한다.
먼저 구분 — 내 에러는 어느 유형인가
지금 보고 있는 증상이 아래 셋 중 어디에 해당하는지부터 짚자. 유형이 정해지면 바로 해당 섹션으로 넘어가면 된다.
저장·수정이 실제로 반영 안 됨
또는 “Couldn’t reach the MCP server”
엉뚱한 위치에 저장된 듯
몇 분째 준비가 안 끝남
① 폴더가 안 붙거나 파일이 저장 안 될 때
Cowork에서 가장 흔한 실전 오류다. Claude가 “파일을 수정했습니다”라고 말하는데 정작 내 폴더를 열어 보면 아무 변화가 없다. 십중팔구 폴더가 제대로 연결(마운트)되지 않았거나, 읽기 권한만 주고 쓰기 권한은 안 준 것이다.
시스템 설정 > 개인정보 보호 및 보안 > 파일 및 폴더에서 Claude 데스크톱에 원하는 폴더 접근 권한이 켜져 있는지 확인한다. 폴더마다 개별로 허용해야 하는 경우가 있다.빠른 자가 확인: “테스트.txt 파일을 만들고 아무 내용이나 써줘”라고 시킨 뒤 내 폴더에서 직접 그 파일이 생기는지 확인하자. 생기면 쓰기 권한 정상, 안 생기면 위 STEP 1~2(연결·쓰기 권한)로 돌아간다.
② 커넥터·MCP “인증이 필요합니다” / 연결 실패
Slack·Google·Notion 같은 커넥터(MCP)를 연결해 쓰다 보면 인증 관련 오류가 자주 나온다. Claude가 UI에 띄우는 문구는 크게 두 가지이고, 문구 하나에 원인이 여럿 섞여 있어 헷갈리기 쉽다.
| 에러 문구 | 실제 의미 | 먼저 해볼 것 |
|---|---|---|
| 이 커넥터는 인증이 필요합니다 (This connector requires authentication) |
토큰이 없거나 세션 중 인증이 풀림 | 커넥터 OFF→ON 토글, 재연결 |
| Couldn’t reach the MCP server | 연결 핸드셰이크 실패(꼭 네트워크 문제는 아님) | 서버 상태·URL 확인, 잠시 후 재시도 |
| Authorization with the MCP server failed | OAuth는 시작됐으나 인증/권한 단계에서 실패 | 재로그인, 관리자 동의(SSO) 확인 |
먼저 챙길 것 — 참조 ID: 커넥터 연결이 실패하면 에러 알림과 주소창 URL에
ofid_로 시작하는 참조 ID가 들어 있다(예: flow_id=ofid_...). 문제를 신고하거나 원인을 추적할 때 이 ID가 핵심 단서다. 실패 직후 바로 복사해 두자(시간이 지나면 만료된다). ✓ 공식 문서 확인
커스텀 커넥터 개발자라면: Anthropic 공식 “커넥터 문제 해결” 문서에 DNS 사설 IP, 리다이렉트로 인한 인증 헤더 소실, OAuth 디스커버리(
/.well-known/...) 404, PKCE(S256) 미지원 등 단계별 진단 체크리스트가 정리돼 있다. 출처의 공식 문서 링크를 참고하자.
③ 만든 파일이 안 보이거나 엉뚱한 곳에 저장될 때
Claude가 “파일을 만들었습니다”라고 했는데 내 폴더엔 없다. 대개 저장 위치를 착각했거나, Cowork 내부 임시 공간에만 만들어졌기 때문이다.
~/Documents 같은 상대경로 대신 /Users/이름/Documents/파일.txt 식 전체경로로 지정하면 안정적
~)이나 상대경로 대신 전체경로(full path)를 직접 주는 편이 안정적이다. 저장 후 “방금 만든 파일의 정확한 경로를 알려줘”라고 물어 위치를 확인한다.④ “워크스페이스 시작 중”이 안 끝날 때
워크스페이스가 완전히 실패한 건 아닌데 “시작 중” 상태로만 오래 머무는 경우다. 잠깐의 지연이면 기다리면 되지만, 반복되면 가벼운 재시작으로 대개 풀린다.
재시작해도 계속 “시작 실패”라면 이건 단순 지연이 아니라 VM 자체가 안 뜨는 문제다. 여기서 더 씨름하지 말고 ①편(가상화·VM 오류)의 Windows 기능 점검 절차로 넘어가자.
정리 — 에러 메시지별 대처 한눈에
Cowork가 뜨는데 안 될 때, 이 순서로 처리하자
- 1 저장이 안 되면: 폴더 연결 확인 → 쓰기 권한 부여 → 폴더 재연결 (섹션 ①)
- 2 “인증 필요”면: 커넥터 OFF→ON 토글 → 앱 재시작 → SSO 재인증 확인 (섹션 ②)
- 3 연결 실패(Couldn’t reach/Authorization failed):
ofid_참조 ID 복사 → 잠시 후 재시도 (섹션 ②) - 4 파일이 안 보이면: 저장 위치 명시 → 전체경로 지정 → 파일명 검색 (섹션 ③)
- 5 “시작 중”만 계속: 30~60초 대기 → 트레이 종료 후 재실행 (섹션 ④)
- 6 그래도 부팅 실패: ①편(VM·가상화 오류)으로