Quick Reference
Code execution and file creation은 Claude가 격리된 실행 컨테이너에서 코드를 실행해 다운로드 가능한 파일을 만드는 capability입니다. Free, Pro, Max, Team, Enterprise에서 웹, Claude Desktop, 모바일로 사용할 수 있으며, capability가 켜져 있어야 합니다. 생성·업로드 파일은 파일당 최대 30 MB이고, 대표 출력은 XLSX, PPTX, DOCX, PDF입니다.
| 필요한 결과 | 제공할 입력 | 완료 전에 확인할 것 |
|---|---|---|
| 계산식이 있는 XLSX | 원본 표, 계산 규칙, 시트 구조 | 수식, 단위, 필터, 차트 축 |
| PPTX·DOCX·PDF | 대상 독자, 개요, 시각 요구 | 글자 넘침, 페이지 나눔, 이미지·인용 |
| CSV·TSV 분석 | 열의 의미, 제외 조건, 집계 기준 | 누락값, 결합·그룹 기준, 재계산 |
| 외부 패키지·데이터 | 필요한 도메인과 이유 | network egress와 MCP 경계 |
입력 데이터 + 산출물 형식 + 계산/표현 규칙
-> 격리 환경에서 생성
-> 파일 다운로드 또는 Google Drive 저장
-> 대상 앱에서 열어 수식·레이아웃·출처 검증실행 환경과 파일 범위
이 capability는 Excel 스프레드시트, PowerPoint, Word 문서, PDF를 만들고 편집할 수 있으며, CSV·TSV 같은 입력을 분석해 차트나 PNG를 만들 수도 있습니다. 파일을 만들었다는 응답은 전달 완료가 아닙니다. 다운받을 파일 형식, 필요한 시트·섹션, 값의 출처, 계산 규칙, 확인할 셀이나 페이지를 요구에 넣어야 검증 가능한 결과가 됩니다.
좋은 요청
"첨부 CSV에서 취소 행을 제외하고 월별 순매출을 계산해라.
XLSX의 Summary 시트에는 제품군·월별 합계·전월 대비를 넣고,
각 계산식이 들어간 cell을 표시해라."PDF가 30 MB를 넘는 경우에도 computing environment에서 처리할 수 있는 경우가 있지만, 일반 업로드·다운로드 한도는 파일당 30 MB입니다. 큰 파일을 나누거나 필요한 표·page만 제공할지는 실제 작업 전에 결정합니다.
network egress와 외부 연결
Code execution은 격리 환경 안에서 실행되지만 네트워크 외부 통신(network egress)을 켜면 패키지 설치와 외부 리소스 접근이 가능해집니다. Team·Enterprise Owner는 조직의 capability와 외부 통신 범위를 관리합니다. 민감한 입력으로 시작할 때는 가장 좁은 범위부터 엽니다.
| egress 범위 | 실행 환경이 할 수 있는 일 | 언제 고르는가 |
|---|---|---|
| 꺼짐 | 미리 설치된 패키지만 사용, 인터넷 없음 | 기밀 파일 분석·내부 자료 |
| package manager만 | npm, PyPI 등 승인된 패키지 설치 | 필요한 library가 분명할 때 |
| package manager + 특정 domain | 허용한 resource만 접근 | 신뢰한 데이터 source가 있을 때 |
| 모든 domain | 넓은 인터넷 접근 | 위험 검토 뒤 제한적으로 사용 |
network egress를 꺼도 MCP 연결은 그 연결을 통해 통신할 수 있습니다. 따라서 "egress off"만으로 외부 반출 경계가 닫혔다고 판단하지 말고, MCP server의 토큰, 접근 데이터, 허용 도구를 따로 검토합니다. 외부 파일이나 웹페이지에 들어 있는 지시가 프롬프트 인젝션으로 작동할 수 있으므로, 예상하지 않은 다운로드·네트워크 요청이 보이면 중지하고 입력과 연결을 확인합니다.
파일 검증
생성 직후에는 파일을 실제 대상 앱에서 열어 확인합니다. 스프레드시트는 값뿐 아니라 수식, 이름 정의, 숫자 형식, 필터, 차트 참조를, 발표 자료는 슬라이드 크기, 글꼴 대체, 이미지 잘림, 넘침을, 문서와 PDF는 제목 계층, 페이지 나눔, 표 줄바꿈, 인용 출처를 봅니다.
파일 검증 순서
1. 원본 입력 수와 산출 합계가 맞는지 확인
2. 대표 수식·표·차트를 사람이 재계산
3. 대상 앱에서 레이아웃과 호환성 확인
4. 수신자·공유 범위에 맞게 민감 정보 제거자주 틀리는 부분
격리 환경은 호스트 시스템과 분리돼 있지만, network egress나 MCP connector를 열면 입력에 있던 민감 정보가 외부로 나갈 경로가 생길 수 있습니다. 기능을 켠 것과 외부 연결을 허용한 것은 별도 결정입니다.
- 파일이 생성됐다는 말만 믿고 업무 결과로 바로 보내지 않습니다. 파일을 열어 계산·표현·출처를 검토합니다.
- Team·Enterprise의 egress 기본값을 개인 플랜과 같다고 가정하지 않습니다. 현재 Organization settings를 확인합니다.
- capability를 꺼도 기존 대화의 첨부 자료가 사라진다고 가정하지 않습니다. 파일과 대화의 보관·삭제는 별도 정책으로 관리합니다.
참고 링크
1 sources