설정하기
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:#09110fClaude Desktop에서 설정에 접근하는 방법:
- 설정 열기:
⌘ Command+,(macOS) 또는 메뉴 바에서Claude Desktop > Settings - Cowork 탭 선택: 좌측 패널에서
Cowork탭 클릭 - 설정 카테고리:
- Global instructions: 모든 세션에 적용되는 지시어
- Skills: 스킬 마켓플레이스 및 내 스킬 관리
- Connectors: MCP 서버 및 외부 서비스 연결
- Permissions: 파일/폴더 접근 권한 관리
전역 지시어는 모든 Cowork 세션의 시작점에서 Claude가 읽는 영구 규칙입니다.
- Settings > Cowork에서 Global instructions 섹션 찾기
- Edit 버튼 클릭
- 지시어 입력 (아래 예제 참조)
- 저장
# 작업 스타일
- 모든 코드 변경 사항을 명확하게 설명하세요
- 복잡한 작업은 단계별로 나누어 진행하세요
- 결정을 내리기 전에 항상 대안을 고려하세요
# 출력 형식
- 코드는 마크다운 코드 블록으로 제출하세요
- 파일 변경 사항은 요약해서 보고하세요
- 완료 후 다음 단계를 제안하세요
# 언어
- 한국어로 응답하세요
- 기술 용어는 원문을 유지하세요
| 목적 | 예제 |
|---|---|
| 작업 스타일 | “항상 단계별로 접근하고, 각 단계를 완료한 후 확인받으세요” |
| 형식 규칙 | “모든 코드 변경 사항을 테이블로 요약하세요 (파일 | 변경 | 이유)” |
| 안전 가드 | “파일을 삭제하기 전에 항상 백업 여부를 확인하세요” |
| 팀 컨벤션 | “커밋 메시지는 Conventional Commits 형식을 따르세요” |
스킬은 재사용 가능한 프롬프트 템플릿입니다. /로 시작하는 슬래시 명령으로 호출합니다.
- Settings > Cowork > Skills
- Marketplace 탭에서 스킬 브라우징
- 원하는 스킬의 Install 클릭
- 설치된 스킬은 내 스킬 탭에서 확인
claude — cowork (스킬 호출 예시)
> /blog > /summarize > /refactor
/blog— 블로그 글 작성 스킬/summarize— 문서 요약 스킬/refactor— 코드 리팩토링 스킬
| 카테고리 | 예시 |
|---|---|
| 문서 생성 | /blog, /docx, /pptx |
| 코드 작업 | /refactor, /test, /review |
| 데이터 처리 | /analyze, /chart, /report |
| 워크플로우 | /project, /deploy, /release |
커넥터는 MCP(Model Context Protocol) 서버와 외부 서비스를 Claude Cowork에 연결합니다.
- Settings > Cowork > Connectors
- + 버튼으로 새 커넥터 추가
- 커넥터 유형 선택:
- Local: 로컬 MCP 서버 (stdio 또는 HTTP)
- Cloud: 클라우드 호스팅 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 MCP | GitHub 리포지토리 연동 |
| Google Drive MCP | Google Drive 파일 접근 |
| Slack MCP | Slack 메시지 송수신 |
| Database MCP | 데이터베이스 쿼리 실행 |
Cowork가 파일/폴더에 접근하기 이전에 사용자 승인이 필요합니다.
Settings > Cowork에서 관리:
| 권한 | 설명 | 기본값 |
|---|---|---|
| Bash | 터미널 명령 실행 | Ask |
| File Access | 파일 읽기/쓰기 | Ask |
| Network | 외부 API 호출 | Ask |
| Agent | 서브에이전트 호출 | Allow |
- Ask: 매번 묻기 (가장 안전)
- Allow: 묻지 않고 허용
- Deny: 묻지 않고 거부
.claude/settings.json에서 프로젝트별 권한 설정:
{
"permissions": {
"allow": {
"bash": ["npm test", "go build"],
"fileAccess": ["src/", "tests/"],
"network": ["api.github.com"]
}
}
}
- Settings > General > Tokens
- 최대 토큰 수 설정 (기본값: 200,000)
- Compact 세션: 컨텍스트 압축 빈도 설정
- Settings > Models
- Cowork용 기본 모델 선택
- 작업 유형별 모델 설정:
- 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: 로그 파일 내보내기
설정이 제대로 적용되었는지 확인하는 방법:
- 새 Cowork 세션 시작 —
⌘ Command + Shift + N - 아래 테스트 프롬프트 입력
claude — cowork (테스트)
> 내 전역 지시어를 읽고, 현재 설정된 스킬과 커넥터를 요약하세요.
| 문제 | 해결책 |
|---|---|
| 전역 지시어가 적용되지 않음 | Claude Desktop 재시작, 지시어 문법 확인 |
| 스킬이 보이지 않음 | Marketplace에서 스킬 재설치, 동기화 확인 |
| MCP 서버 연결 실패 | 서버 로그 확인, 포트 충돌 점검 |
| 권한 팝업이 계속 뜸 | Permissions 설정에서 Allow로 변경 |