Claude Code 자동화 실행 환경 & 설정 가이드

Claude Code를 활용해 반복적인 작업을 자동화하려면 실행 환경 구성과 자동화 설정(Task Scheduler 연동) 이 필요하다. 여기서는 Windows 환경과 OneDrive + Obsidian 기반 워크플로우를 예시로 정리했다.

1. 실행 환경 구성

1.1 Claude CLI 설치

Claude Code는 CLI(Command Line Interface)로 실행된다. 설치 후에는 전역 실행이 가능해야 하지만, Windows에서는 경로 문제로 claude 명령어가 바로 동작하지 않을 수 있습니다.

• 기본 실행 경로 예시:
• C:\Users\<사용자>\AppData\Roaming\npm\claude.cmd
• 이 경로를 환경 변수 PATH에 추가해야 claude 명령만으로 실행 가능하다.

👉 설치 후 반드시 claude -h로 동작 여부를 확인하자.

1.2 실행 폴더 지정

자동화 실행 시 기준 폴더를 정해두면 관리가 편하다. 예를 들어:

C:\Users\<사용자>\OneDrive\문서\Obsidian\Repository

이 폴더 안에서 자동화 스크립트나 결과 파일이 관리되도록 구성할 수 있습니다. 저 폴더를 기준으로 OneDrive를 통해 동기화를 수행하면서, PC 및 스마트폰에서도 Obsidian으로 접근해서 사용하고 있다.

2. 자동화 실행 예시

Claude CLI는 -p 옵션과 함께 실행할 수 있습니다. 예를 들어 특정 collector를 자동 실행하도록 설정하면:

claude -p --permission-mode bypassPermissions /economic-tracker
claude -p --permission-mode bypassPermissions /claude-collector
claude -p --permission-mode bypassPermissions /codex-collector

• --permission-mode bypassPermissions : 자동화 실행 시 권한 확인을 건너뜀
• /economic-tracker, /claude-collector 등 : 실행할 작업 단위(collector). custom command이다.

이렇게 여러 collector를 순차 실행하도록 배치파일(.bat)로 만들어 둘 수 있다. 물론 보라 cli command로 넣을 수 있다.

3. Task Scheduler 연동

Windows Task Scheduler를 이용하면 특정 시간/주기에 자동으로 Claude Code를 실행할 수 있다.

1. 작업 생성
   • 작업 스케줄러 실행 → 새 작업 만들기
   • 이름 예: Claude Automation
2. 트리거 설정
   • 매일/매주/부팅 시 등 원하는 조건으로 설정
3. 동작 설정
   • 프로그램/스크립트: C:\Users\<사용자>\AppData\Roaming\npm\claude.cmd
   • 인수 추가: -p --permission-mode bypassPermissions /economic-tracker
   • 시작 위치: C:\Users\<사용자>\OneDrive\문서\Obsidian\Repository
4. 테스트
   • 우클릭 → 실행
   • 로그를 확인해 collector들이 정상적으로 실행되는지 확인

4. 실행 환경 선택: 로컬 PC vs 클라우드

자동화를 위한 실행 환경은 크게 두 가지 방식이 있다:

항목	로컬 Mini PC (Intel N100/N150)	Google Cloud Windows VM (On-Demand)
초기 비용	약 20만 원 (구매비)	없음
월 유지비	약 2천 원 (전기료)	약 2만 원 (60시간 기준)
관리	직접 패치/백업 필요	GCP가 자동 관리
확장성	로컬 한정	무제한, API/스케줄러 연동
장점	저렴, 오프라인 사용 가능	유지보수 불필요, 확장성 높음

👉 단순 개인용(Obsidian + OneDrive 동기화 중심 자동화) → N100 미니PC가 전기료 대비 매력적
👉 LLM API 트리거, 대규모 자동화가 필요 → Google Cloud Windows VM이 적합

---

5. 마무리

이 과정을 통해 얻을 수 있는 효과는:

• 반복 작업의 완전 자동화 (수동 실행 불필요)
• Obsidian + OneDrive를 통한 데이터 자동 동기화
• 로컬/클라우드 선택에 따른 비용·편의성 최적화