Skip to main content

설정하기

Claude Desktop의 Settings > Cowork에서 Claude의 동작 방식을 제어하는 핵심 설정을 관리합니다. 이 페이지에서는 전역 지시어, 스킬, 커넥터, 권한 설정을 다룹니다.

설정 구조 한눈에 보기

flowchart TD
    subgraph Settings["Settings > Cowork"]
        GI["전역 지시어
(Global Instructions)"] SK["스킬
(Skills)"] CN["커넥터
(Connectors)"] PM["권한
(Permissions)"] end GI -->|모든 세션에 적용| SESSION["Cowork 세션"] SK -->|스킬 자동 호출| SESSION CN -->|외부 서비스 연결| SESSION PM -->|접근 범위 제어| SESSION style Settings fill:#eaeaea,stroke:#6e6e6e,color:#09110f style SESSION fill:#d6ebe7,stroke:#1c7c70,color:#09110f

설정 메뉴 접근

Claude Desktop에서 설정에 접근하는 방법:

  1. 설정 열기: ⌘ Command + , (macOS) 또는 메뉴 바에서 Claude Desktop > Settings
  2. Cowork 탭 선택: 좌측 패널에서 Cowork 탭 클릭
  3. 설정 카테고리:
    • Global instructions: 모든 세션에 적용되는 지시어
    • Skills: 스킬 마켓플레이스 및 내 스킬 관리
    • Connectors: MCP 서버 및 외부 서비스 연결
    • Permissions: 파일/폴더 접근 권한 관리

Cowork 설정 — 폴더와 스킬 연결

Cowork 설정 화면에서 작업 폴더를 지정하고 필요한 스킬과 커넥터를 활성화합니다.

Cowork 스킬 검증 — 설치된 스킬 목록 확인

설치된 스킬이 올바르게 로드되었는지 검증하고, 사용 가능한 모든 슬래시 명령을 확인할 수 있습니다.

전역 지시어 (Global Instructions)

전역 지시어는 모든 Cowork 세션의 시작점에서 Claude가 읽는 영구 규칙입니다.

설정 방법

  1. Settings > Cowork에서 Global instructions 섹션 찾기
  2. Edit 버튼 클릭
  3. 지시어 입력 (아래 예제 참조)
  4. 저장

전역 지시어 예제

# 작업 스타일

- 모든 코드 변경 사항을 명확하게 설명하세요
- 복잡한 작업은 단계별로 나누어 진행하세요
- 결정을 내리기 전에 항상 대안을 고려하세요

# 출력 형식

- 코드는 마크다운 코드 블록으로 제출하세요
- 파일 변경 사항은 요약해서 보고하세요
- 완료 후 다음 단계를 제안하세요

# 언어

- 한국어로 응답하세요
- 기술 용어는 원문을 유지하세요

전역 지시어 활용 팁

목적예제
작업 스타일“항상 단계별로 접근하고, 각 단계를 완료한 후 확인받으세요”
형식 규칙“모든 코드 변경 사항을 테이블로 요약하세요 (파일 | 변경 | 이유)”
안전 가드“파일을 삭제하기 전에 항상 백업 여부를 확인하세요”
팀 컨벤션“커밋 메시지는 Conventional Commits 형식을 따르세요”

스킬 (Skills)

스킬은 재사용 가능한 절차적 지침 묶음입니다. /로 시작하는 슬래시 명령으로 호출하며, 특정 작업(문서 작성, 콘텐츠 제작, 오피스 산출물 생성 등)을 단계별로 수행합니다.

스킬 마켓플레이스

  1. Settings > Cowork > Skills
  2. Marketplace 탭에서 스킬 브라우징
  3. 원하는 스킬의 Install 클릭
  4. 설치된 스킬은 내 스킬 탭에서 확인

스킬 사용

claude — cowork (스킬 호출 예시)
> /blog
> /newsletter
> /landing-page
  • /blog — 블로그 글 작성 스킬
  • /newsletter — 뉴스레터 기획·작성 스킬
  • /landing-page — 랜딩 페이지 제작 스킬

인기 스킬 카테고리

카테고리예시
문서 생성/blog, /docx-generator, /pptx-designer
콘텐츠 제작/newsletter, /card-news, /social-media
오피스 산출물/xlsx-creator, /hwpx-writer, /pdf-writer
프로젝트/project

위 예시는 cowork-plugins 마켓플레이스에 실제로 배포된 스킬 이름입니다. 설치한 스킬에 따라 호출 가능한 명령이 달라지며, / 입력 시 자동완성 목록에서 확인할 수 있습니다.

커넥터 (Connectors)

커넥터는 MCP(Model Context Protocol) 서버와 외부 서비스를 Claude Cowork에 연결합니다.

MCP 서버 연결

  1. Settings > Cowork > Connectors
  2. + 버튼으로 새 커넥터 추가
  3. 커넥터 유형 선택:
    • Local: 로컬 MCP 서버 (stdio 또는 HTTP)
    • Cloud: 클라우드 호스팅 MCP 서버

로컬 MCP 서버 설정 예시

# stdio 기반 서버
name: "Filesystem MCP"
command: "npx"
args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]

# HTTP 기반 서버
name: "Custom MCP Server"
url: "http://localhost:3000/mcp"
headers:
  Authorization: "Bearer YOUR_API_KEY"

인기 커넥터

커넥터용도
Filesystem MCP로컬 파일 시스템 접근
GitHub MCPGitHub 리포지토리 연동
Google Drive MCPGoogle Drive 파일 접근
Slack MCPSlack 메시지 송수신
Database MCP데이터베이스 쿼리 실행

권한 관리 (Permissions)

Cowork가 파일/폴더에 접근하기 이전에 사용자 승인이 필요합니다.

권한 카테고리

Settings > Cowork에서 관리:

권한설명기본값
Bash터미널 명령 실행Ask
File Access파일 읽기/쓰기Ask
Network외부 API 호출Ask
Agent서브에이전트 호출Allow

권한 모드

  • Ask: 매번 묻기 (가장 안전)
  • Allow: 묻지 않고 허용
  • Deny: 묻지 않고 거부

권한 변경 관리

Cowork 앱에서 권한을 변경한 뒤에는 다음 세션부터 즉시 반영됩니다. 자주 묻는 권한 팝업을 줄이려면 Settings > Cowork > Permissions UI에서 해당 카테고리를 Allow로 변경하세요.

권한은 Cowork 앱의 설정 화면에서만 관리합니다. CLI 전용 구성 파일을 직접 편집할 필요 없이, Permissions 패널의 토글과 드롭다운으로 카테고리별 접근 범위를 그래픽으로 지정하면 즉시 적용됩니다.

고급 설정

토큰 예산 관리

  1. Settings > General > Tokens
  2. 최대 토큰 수 설정 (기본값: 200,000)
  3. Compact 세션: 컨텍스트 압축 빈도 설정

모델 선택

  1. Settings > Models
  2. Cowork용 기본 모델 선택
  3. 작업 유형별 모델 설정:
    • Coding: Claude Sonnet 4.6 (권장)
    • Writing: Claude Opus 4.7 (권장)
    • Analysis: Claude Haiku 4.5 (빠른 응답)

로그 및 디버깅

Settings > Advanced:

  • Debug mode: 개발자 로그 활성화
  • Log level: Error / Warn / Info / Debug
  • Export logs: 로그 파일 내보내기

설정 확인하기

설정이 제대로 적용되었는지 확인하는 방법:

  1. 새 Cowork 세션 시작 — ⌘ Command + Shift + N
  2. 아래 테스트 프롬프트 입력
claude — cowork (테스트)
> 내 전역 지시어를 읽고, 현재 설정된 스킬과 커넥터를 요약하세요.

문제 해결

문제해결책
전역 지시어가 적용되지 않음Claude Desktop 재시작, 지시어 문법 확인
스킬이 보이지 않음Marketplace에서 스킬 재설치, 동기화 확인
MCP 서버 연결 실패서버 로그 확인, 포트 충돌 점검
권한 팝업이 계속 뜸Permissions 설정에서 Allow로 변경

Sources