비엔지니어를 위한 Claude Code: 안전한 업무 흐름, 프롬프트, 권한 설정

Claude Code는 개발자만을 위한 도구가 아닙니다. 마케팅, 운영, 고객지원, 영업, HR, 제품 담당자도 웹사이트 문구 수정, 문서 정리, CSV 보고서 준비, FAQ 개선, 애매한 요청을 안전한 작업 목록으로 바꾸는 데 활용할 수 있습니다.

다만 자동 조종 장치처럼 쓰면 위험합니다. Claude Code는 파일을 읽고, 수정하고, 명령을 실행할 수 있습니다. 그래서 “전부 고쳐서 배포해줘” 같은 요청은 비엔지니어가 검토하기 어렵습니다. 기본 원칙은 간단합니다. 작은 작업 하나만 맡기고, diff를 읽고, 비밀 정보·고객 데이터·운영 환경·결제·보안이 나오면 멈추고 엔지니어에게 확인합니다.

설치는 Claude Code 시작 가이드를 참고하세요. 안전 설정은 Approval / Sandbox 가이드, 권한 설정 가이드와 함께 보면 좋습니다.

꼭 알아야 할 말

터미널은 글자로 컴퓨터에 지시하는 창입니다. diff는 변경 전과 후의 차이입니다. 권한은 Claude Code가 바로 할 수 있는 일, 승인 후 할 수 있는 일, 절대 하면 안 되는 일을 나누는 규칙입니다.

용어	쉬운 설명	확인할 것
Terminal	글자 기반 조작 창	올바른 폴더인가
Diff	변경 내역	예상한 파일만 바뀌었나
Approval	실행 전 승인	명령을 이해했나
Sandbox	제한된 작업 공간	범위를 벗어나지 않나
Secret	API 키, 비밀번호, 토큰	함부로 읽히지 않기

안전한 흐름

flowchart LR
  A["목표 쓰기"] --> B["조사만 요청"]
  B --> C["질문과 위험 확인"]
  C --> D["작은 수정 하나 승인"]
  D --> E["diff 요약 읽기"]
  E --> F{"운영 또는 비밀 정보?"}
  F -->|예| G["멈추고 엔지니어에게 문의"]
  F -->|아니오| H["검사 실행 후 사람이 판단"]

첫 요청에는 “아직 파일을 수정하지 마세요”라고 쓰세요. 이 한 문장이 Claude Code를 바로 실행하는 도구가 아니라 조사와 계획을 하는 도우미로 바꿉니다.

권한 설정 예시

공식 문서:

처음에는 읽기와 테스트는 허용하고, 쓰기는 승인받고, 비밀 정보와 되돌리기 어려운 명령은 막는 방식이 좋습니다.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Read",
      "Grep",
      "Glob",
      "Bash(npm run build)",
      "Bash(npm run test)"
    ],
    "ask": [
      "Edit",
      "Write",
      "Bash(git diff)",
      "Bash(git status)"
    ],
    "deny": [
      "Read(.env*)",
      "Read(**/secrets/**)",
      "Bash(rm -rf *)",
      "Bash(git reset --hard)",
      "Bash(git push *)",
      "Bash(npm publish *)"
    ]
  }
}

allow는 허용, ask는 승인 요청, deny는 차단입니다. .env 파일에는 키나 토큰이 들어가는 경우가 많아 일반 업무에서는 읽히지 않는 편이 안전합니다.

애매한 요청을 체크리스트로 바꾸기

신중한 업무 도우미처럼 행동하세요. 아직 파일은 수정하지 마세요.

목표:
처음 방문한 고객도 문의 페이지를 쉽게 이해하게 만들고 싶습니다.

해주세요:
1. 관련될 가능성이 높은 파일을 찾기.
2. 수정 전에 확인해야 할 질문 5개 만들기.
3. 작업을 작은 단위로 나누기.
4. 엔지니어 확인이 필요한 위험 작업 표시하기.
5. 오늘 할 수 있는 가장 작은 안전 작업 추천하기.

웹 문구, FAQ, 내부 문서, 이메일 템플릿, 운영 절차 모두에 쓸 수 있습니다.

사례 1: 웹사이트 문구 수정

배포하거나 게시하지 마세요.

가격 페이지의 문구만 검토하세요.
파일:
- site/src/content/pricing.mdx
- site/src/pages/pricing.astro

작업:
1. 처음 구매자가 이해하기 어려운 표현 찾기.
2. 대체 문구를 표로 제안하기.
3. 내 승인을 기다리기.
4. 승인한 문구만 반영하기.
5. git diff를 쉬운 한국어로 설명하기.

문구, 디자인, 가격 계산, 결제, 배포를 한 번에 요청하지 마세요. 위험 수준이 다릅니다.

사례 2: 문서와 교육 자료

docs/onboarding/을 읽고 docs/onboarding/day-one-checklist.md를 만드세요.

규칙:
- 기존 문서는 삭제하지 않기.
- 기술 용어는 처음 나올 때 쉽게 설명하기.
- 불확실한 내용은 "확인 필요"로 남기기.
- 마지막에 HR 또는 IT에 물어볼 질문 3개 쓰기.

문서 정리는 Claude Code 문서 생성과 함께 보면 좋습니다.

사례 3: CSV와 스프레드시트

실제 고객 데이터 전에 샘플 데이터로 먼저 확인하세요.

date,customer,plan,status,amount
2026-06-01,Acme,Standard,open,12000
2026-06-01,Northwind,Pro,closed,30000
2026-06-02,Contoso,Standard,open,12000

data/inquiries.csv를 점검하고 안전한 추출 스크립트를 만드세요.

규칙:
- 먼저 열 이름과 행 수만 보고하기.
- 개인정보처럼 보이는 열이 있으면 중단하기.
- scripts/open-inquiries.mjs 만들기.
- node scripts/open-inquiries.mjs 실행 시 output/open-inquiries.csv 생성하기.
- 추출된 행 수 보고하기.

스프레드시트 자동화는 Claude Code 스프레드시트 자동화를 참고하세요.

사례 4: 업무 자동화 초안

처음부터 완전 자동화를 만들지 말고 사람이 따라 할 수 있는 절차를 먼저 만드세요.

매일 오전 9시 운영 루틴을 위한 docs/daily-ops-checklist.md를 만드세요.

입력:
- 미해결 고객 문의 확인.
- 어제 매출 확인.
- 오류 알림 확인.
- 오늘의 우선순위를 Slack에 게시.

출력:
- 단계별 체크리스트.
- 예상 소요 시간.
- 자동화 가능한 부분.
- 사람 판단이 필요한 부분.
- 실패 시 되돌리는 방법.

반복 스크립트로 발전시키려면 업무 흐름 자동화 사례를 읽어보세요.

위험표

위험	문제	안전한 대응
”전부 고쳐줘”	검토할 변경이 너무 많음	파일 하나, 목표 하나
`.env` 읽기	비밀 정보 노출	차단하고 문의
`git push` 허용	미검토 변경이 외부로 나감	게시와 배포는 수동
실제 고객 데이터	개인정보 위험	샘플로 먼저 테스트
테스트 없음	오류가 운영에 보임	build, test, 미리보기
오류 재시도 반복	같은 실패 반복	오류 설명 먼저 요청

삭제, 게시, 결제, 로그인, 고객 데이터, 계약, 운영 환경이 나오면 멈추세요.

매일 쓰는 체크리스트

시점	확인
시작 전	오늘 끝낼 작업 하나 정하기
조사 중	”아직 수정하지 마세요” 쓰기
수정 전	대상 파일 확인
승인 시	도구와 명령 읽기
수정 후	diff 요약 요청
공유 전	게시, 전송, 삭제, 배포가 없었는지 확인
불안할 때	diff와 질문을 엔지니어에게 전달

교육과 상담

ClaudeCodeLab은 비기술 팀을 위한 Claude Code 도입을 돕습니다. 팀용 프롬프트, 권한 설정, 리뷰 규칙, 웹 업데이트, FAQ, CSV 리포트, 내부 문서 자동화를 함께 설계할 수 있습니다.

첫 프로젝트는 작고 반복 가능하며 확인하기 쉬워야 합니다. 그래야 팀이 요청하고, 검토하고, 멈추는 습관을 배웁니다.

직접 확인한 결과

웹 문구 수정, 온보딩 체크리스트, CSV 추출 세 가지로 이 흐름을 테스트했습니다. “아직 수정하지 마세요”, “질문부터 하세요”, “위험 작업을 분리하세요”를 넣었을 때 diff가 훨씬 검토하기 쉬웠습니다. 반대로 바로 “완성해줘”라고 하면 비엔지니어가 판단하기 어려운 변경이 많아졌습니다.