byminseok.com

Workspace 환경 세팅 기록

개발기록

Workspace 환경 세팅 기록

2026년 2월 14일

Claude Code를 본격적으로 쓰기 시작하면서, 그동안 되는대로 만들어뒀던 workspace를 정리하고 기본 환경을 세팅했다.

CLAUDE.md 글로벌 설정

Claude Code는 대화 시작 시 CLAUDE.md 파일을 자동으로 읽어서 프로젝트 맥락과 규칙을 파악한다. 위치에 따라 적용 범위가 달라진다.

  • ~/.claude/CLAUDE.md — 글로벌. 어떤 폴더에서 열든 항상 적용
  • ./CLAUDE.md — 해당 프로젝트 폴더에서만 적용
  • 하위 폴더에도 둘 수 있고, 글로벌 + 프로젝트별 설정을 조합할 수 있음

나는 특정 프로젝트에 종속되지 않는 개인 설정(기술 수준, 디자인 선호, 코드 스타일 등)이라 글로벌 위치(~/.claude/CLAUDE.md)에 만들었다. 나중에 프로젝트별 빌드 명령어나 고유 규칙이 생기면 해당 폴더에 별도 CLAUDE.md를 추가하면 된다.

담은 내용

  • 나에 대해: CS+철학 전공 기술기획자, 전업 개발자 아님, 배워가는 중
  • 기술 스택: HTML/CSS/JS 주력, Python, 점차 API/DB/서버로 확장
  • 코드 규칙: 한국어 주석, 새 기술 도입 시 이유 설명, 단순하고 직관적인 설계
  • 디자인: 아틀리에 스타일(기본)과 테라코타 스타일 두 가지. 상세 스펙은 _design/ 폴더의 파일을 참조하도록 경로 명시
  • 글쓰기: 줄글 선호, 옵시디언 호환 마크다운
  • 대화: 한국어, 간결하게

참고로 웹앱에서 쓰는 포포(업무)나 로로(개인) 같은 캐릭터 설정은 넣지 않았다. Claude Code는 코딩 도구라 성격 지침보다 실용적 규칙이 더 잘 먹힌다.

Workspace 폴더 구조 정리

되는대로 쌓아뒀던 폴더들을 프로젝트별 플랫 구조로 재구성했다.

Before

workspace/
├── creatorsmorinng/              ← 오타
├── taylor/                       ← 잡다한 모음 (대시보드, 날씨봇, 디자인, 회의록)
├── techforimpact/
├── terracotta-light-theme.md     ← 루즈한 파일
├── taylor-atelier-enhanced.skill ← 루즈한 파일
├── tfi-retro-archive(구버전)/    ← 폐기된 프로젝트
├── tfi-retro-library/
├── tfiplanning(2025)/
└── theorakim.github.io/

After

workspace/
├── _archive/                      관리 - 보관용 (구버전 등)
├── _design/                       관리 - 디자인 리소스 & 설정 파일
├── creatorsmorning/               개인 - 창작하는아침 캘린더
├── pangyo-weather-bot/            개인 - 판교 날씨 카톡봇
├── tfi-github/                    업무 - GitHub org 로컬 미러
├── tfi-meeting-notes/             업무 - 회의록
├── tfi-planning-docs/             업무 - 기획/전략 문서
├── tfi-retro-library/             업무 - 회고 아카이브
├── tfi-sustainable-dashboard/     업무 - 지속가능트랙 대시보드
└── theorakim.github.io/           개인 - 블로그

정리 원칙

  • 프로젝트별 플랫 구조: 상위 분류 폴더(work/, personal/) 없이 프로젝트마다 독립 폴더
  • tfi- 프리픽스: 테크포임팩트 업무 프로젝트는 모두 tfi-로 시작해서 업무/개인 구분
  • _ 프리픽스: 프로젝트가 아닌 관리용 폴더(_archive, _design)는 밑줄로 구분
  • 한글/괄호 제거: 폴더명에서 경로 문제 방지
  • taylor/ 해체: 잡다하게 모여있던 내용물을 각각 적절한 위치로 분리

Git 현황 파악

workspace 내 git repo 연결 상태도 확인했다.

개인 계정 (theorakim)

로컬 폴더 GitHub repo
tfi-retro-library theorakim/tfi-retro-library
tfi-sustainable-dashboard theorakim/sustainabletrack
pangyo-weather-bot theorakim/pangyo-action
theorakim.github.io theorakim/theorakim.github.io
_archive/tfi-retro-archive theorakim/tfi-retro-archive

조직 계정 (tech-for-impact)

로컬 폴더 GitHub repo
tfi-github/campus tech-for-impact/campus
tfi-github/guidelines tech-for-impact/guidelines
tfi-github/services tech-for-impact/services

Git 없는 폴더

_design/, creatorsmorning/, tfi-meeting-notes/, tfi-planning-docs/

참고

  • tfi-retro-library와 tfi-sustainable-dashboard는 회사 업무 프로젝트인데 개인 repo에 올라가 있음. 나중에 조직 repo로 이전 검토 필요
  • tfi-retro-library, theorakim.github.io의 .gitignore에 .DS_Store 추가함. macOS가 자동 생성하는 파일이라 git에서 추적할 필요 없음

배운 것들

  • CLAUDE.md는 자유롭게 쓰면 된다. 개발자식 기술 규칙만 넣을 필요 없고, 자기 수준과 선호를 넣는 게 오히려 실용적
  • 폴더 이름 변경은 git에 영향 없다. git repo를 담고 있는 바깥 폴더의 이름을 바꿔도 내부 .git과 remote 연결은 그대로
  • .gitignore는 파일을 삭제하는 게 아니라 git 추적에서 제외하는 것. 파일은 그대로 있고 Finder도 정상 동작