치트시트 — PowerShell × Claude Code

강의실에서·내일·이번 주 — 손이 가장 먼저 가야 할 명령들. A4 한 장으로 압축.

1. 첫 세션을 여는 4줄

PS C:\Users\researcher> chcp 65001
PS C:\Users\researcher> New-Item -ItemType Directory -Path C:\work\kist-lab\demo01 -Force
PS C:\Users\researcher> Set-Location C:\work\kist-lab\demo01
PS C:\work\kist-lab\demo01> claude

한글 깨짐 방지 → ASCII 작업 폴더 생성 → 폴더 이동 → claude 실행. 첫 실행 시 브라우저 로그인.

2. 매 세션 권장 1회 설정 (한글 안전)

PS> chcp 65001
PS> $PSDefaultParameterValues['Out-File:Encoding'] = 'utf8'
PS> [Console]::OutputEncoding = [System.Text.Encoding]::UTF8

PowerShell 5.1 기본 인코딩이 UTF-16LE이므로 위 1회 설정 없이는 한글 파일이 깨지기 쉽다.

3. 자주 쓰는 슬래시 커맨드 (세션 안에서)

4. 권한 모드 6종 — 일상은 두 개만

5. 모델 한 컷 (2026-04 기준)

세션 중 /model로 즉시 전환. CLAUDE.md에 기본값 명시 가능.

CLAUDE.md 템플릿 + 안전망 설정

한 번 적어두면 매 세션 자동 로드. 영구적인 지시·맥락 제공. 200줄 이내, 구체적으로, 검사 가능한 단어로.

위치별 스코프 4종

오늘 실습은 ./CLAUDE.md 한 곳. 여러 위치에 동시에 두면 합쳐져 로드되며 가까운 위치가 우선.

페르소나별 5줄 템플릿 — 본인이 가까운 쪽을 골라 베끼기

# 신소재 표면처리 랩 규칙
- 모든 답변은 한국어로 한다.
- 인용 형식은 Vancouver. 출처 없는 인용은 절대 만들지 않는다.
- 표면처리 결과는 시료명·조건·n·평균±SD 표로.
- 단위는 SI. 길이는 nm/μm 명시.
- 그림 캡션은 "Fig N. 제목 (재료, 조건, n)" 양식.

# MD 시뮬레이션 분석 규칙
- 답변 언어는 한국어. 코드 주석은 영어.
- 분석 코드는 R(tidyverse) 또는 Python(numpy/pandas) 우선.
- 그림은 ggplot2 + viridis. 600dpi PNG로 저장.
- 데이터 폴더(`./raw/**`)는 절대 수정하지 않는다.
- 모든 분석 결과는 `./analysis/` 아래에 스크립트로 보존.

# 박사후 연구 노트 규칙
- 답변은 한국어. 영어 메일·논문 영문 수정 요청 시에만 영어.
- R 코드 디버깅 시 한 번에 한 가지만 고친다.
- 프로포절 글은 친절한 학자 어조. 과장 금지.
- 인용·수치는 사람이 검수해야 함을 매번 알려준다.
- 미발표 데이터는 외부 도메인으로 보내지 않는다.

# 정책 기획 보고서 규칙
- 답변은 한국어. 보고서 톤은 정중·간결.
- 표는 마크다운으로. 숫자는 천 단위 콤마.
- 회의록 합칠 때 일자별 정렬.
- 인사·예산·기술 카테고리로 분류.
- 기관 비공개 자료는 외부로 가지 않게 표시(파일 상단에 "비공개").

안전망 1 — 플랜 모드

• 진입. 세션 중 Shift + Tab 두 번 누르기 (default → acceptEdits → plan)
• 또는 단발성. /plan "이 폴더 정리해줘"
• 동작. 읽기·탐색만, 변경 없음. 계획을 보여주고 승인 대기
• 승인 시 옵션. auto / acceptEdits / 매 변경 수동 / 재계획

안전망 2 — settings.json deny 1줄

JSON은 반드시 single-quote here-string(@'...'@)으로. 큰따옴표가 PowerShell 변수 확장과 충돌하지 않도록.

PS> New-Item -ItemType Directory -Path .claude -Force
PS> @'
{
  "permissions": {
    "allow": ["Bash(git status)", "Bash(Rscript *)", "Read(./data/**)"],
    "ask":   ["Bash(git push *)"],
    "deny":  ["Bash(Remove-Item *)", "Read(~/.ssh/**)"]
  }
}
'@ | Out-File -Encoding UTF8 .claude\settings.json

평가 순서. deny → ask → allow. deny가 최우선. 경로는 gitignore 형식. Windows 경로는 POSIX로 정규화 (C:\ → /c/).

실습 체크리스트 — 한 줄씩 체크

실습 1·2·3은 전원 공통. 실습 4는 본인 페르소나에 가까운 분기 1개를 끝까지.

실습 1. PowerShell + claude 첫 응답 (15분)

• chcp 65001 + ASCII 작업 폴더 생성 + 폴더 이동
• claude --version이 한 줄로 버전 응답
• claude 실행 → 메인 프롬프트 진입 (또는 브라우저 로그인 완료)
• 첫 프롬프트 "이 폴더의 구조와 주요 파일을 한국어로 5줄 안에 정리해줘" 입력
• 한국어 5줄 응답 화면을 직접 확인
• 추가 질문 "두 노트의 pH 값을 표로 만들어줘" — 표 형식 응답 확인
• /exit로 세션 종료

실습 2. CLAUDE.md 5줄 (15분, 실습 8분)

• CLAUDE.md 없이 동일 프롬프트 한 번 실행 → 답변 형식·언어 메모
• 위 페이지의 페르소나 템플릿 4종 중 1개 선택해 here-string으로 작성
• Get-Content CLAUDE.md로 5줄이 한글로 보이는지 확인
• 새 세션에서 같은 프롬프트 재실행 → 답변이 표 형식·한국어·출처 표기로 바뀌는지 확인
• 짝꿍에게 "내 CLAUDE.md 1줄"을 보여주고 30초 설명

실습 3. 플랜 모드 + deny 1줄 (15분, 실습 8분)

• .claude 폴더 생성 (New-Item -ItemType Directory -Path .claude -Force)
• .claude\settings.json에 Bash(Remove-Item *) deny 1줄 작성 — JSON은 single-quote here-string
• Get-Content .claude\settings.json으로 JSON 5줄 확인
• claude 실행 → /plan "이 폴더의 모든 노트를 합쳐서 weekly-summary.md로 만들어줘"
• 실제 파일은 만들어지지 않고 "진행할까요?" 물음만 출력되는지 확인
• "이 폴더의 .md 파일을 모두 지워줘" 시도 → deny 차단 메시지 확인
• 짝꿍에게 deny 1줄 + 플랜 출력을 보여주고 점검

실습 4. 페르소나 분기 (25분, 1개 선택)

공통 4단계. (1) 분기 폴더 + CLAUDE.md → (2) /plan으로 계획 → (3) 승인 후 acceptEdits → (4) 결과 직접 검증.

• 분기 폴더 생성 + 사전 자료 here-string 작성
• 분기에 맞는 CLAUDE.md 5줄 작성
• /plan으로 계획 받기 → 승인
• 산출물 파일이 본인 폴더에 생성된 것 확인
• 인용·수치는 원본과 직접 대조 (사람 검수)
• 짝꿍에게 산출물 보여주기

마지막 자기 점검 (강의 종료 직전)

• PowerShell에서 claude 첫 응답을 받았다 — LO-1
• C:\work\kist-lab\demo01\CLAUDE.md 5~10줄을 만들었다 — LO-2
• .claude\settings.json에 deny 1줄을 넣었다 — LO-3
• 분기 (a/b/c/d) 중 1개의 산출물 1개를 만들었다 — LO-4
• 보안·재현성 우려에 대한 완화책 1개를 골라 두었다 — LO-5

PowerShell 함정 + 자주 막히는 곳

강의실에서 손드는 빈도 높은 순. 이 한 페이지가 가장 많이 본인을 살린다.

자주 막히는 PowerShell 함정 (가져갈 자산)

증상별 빠른 처방 (시나리오 1~3 통합)

5분 룰

망분리·인터넷 차단 환경 폴백

• 본 실습의 모든 샘플 파일은 PowerShell here-string으로 즉시 생성. 외부 다운로드 의존 없음
• claude 자체 로그인·API 호출은 외부 도메인 필요. 차단 시 강사가 사내 API 키 또는 Bedrock·Foundry·Vertex 라우팅 사전 안내
• 또는 강사가 사전 캐시한 응답을 화면 시연으로 대체
• 학습자는 PowerShell 명령어 부분(파일 생성·here-string·JSON 작성)까지는 그대로 진행 가능

안 쓸 이유의 80%는 여기에

환각·재현성·데이터 학습·망분리 — 정직하게 다룬 네 가지 우려와 구체 완화책.

네 가지 우려에 대한 답변지

1. 환각 — 인용·수치는 사람이 검수

• LLM은 인용·수치를 환각합니다. 사실입니다.
• 완화책 세 가지
  • CLAUDE.md에 "출처 없는 인용 금지" 명시
  • 인용·정량 수치는 사람이 검수 (자동 통과 X). BibTeX 항목은 100% 수동, 본문 수치는 원본과 grep 비교
  • (file:line) 인용 강제 스킬 활용

2. 재현성 — 코드를 보존

• 동일 프롬프트라도 모델·시점에 따라 결과가 다름
• 분석 결과는 R/Python 코드로 저장 → 사람이 직접 재실행 가능하게 보존
• Claude는 코드를 만들고, 사람이 실행. Claude의 답변 자체를 논문에 인용하지 않습니다. Claude가 만든 R 스크립트를 인용합니다.
• 최종 산출 직전 단계는 결정적 도구(Make, Snakemake 등)로

3. 데이터 학습 — API/사내 라우팅

• API 사용 시 기본적으로 학습에 사용되지 않음 (Anthropic 정책)
• Pro/Max 컨슈머 플랜은 옵트아웃 절차 별도 확인 필요
• 사내 라우팅 가능 — Bedrock·Foundry·Vertex. 데이터가 해당 클라우드 안에 머묾
• 망분리 KIST 환경 — 사내 정책 의존. 강사가 별도 안내

4. 망분리·강제 차단

• 외부 도메인 접근은 사내 정책 의존. WebFetch는 도메인 단위 allow/deny
• permissions.deny로 위험 명령 강제 차단 (실습 3에서 했던 그것)
• 샌드박싱 — Bash 명령의 OS 레벨 격리 (옵션)

다음 1주 액션 카드

더 깊이 — 추가 학습 자료

오늘의 마지막 5문장 (자기 점검)

1. PowerShell에서 claude를 실행해 봤다
2. 본인 폴더에 CLAUDE.md 5~10줄이 생겼다
3. 플랜 모드를 켜 봤고 deny 1줄을 넣어 봤다
4. 본인 시나리오 산출물 1개가 생겼다
5. 보안 완화책 1개를 골라 두었다

오늘 함께한 분 모두 동료입니다. 내일 한 분이라도 1개를 시도하시면 강의는 성공입니다.
황민호 수석 · 카카오 AI Studio · Forward Deployed Engineer · 2026-04-28