터미널용 Claude Code 프로젝트 디렉토리 선택기 구축 팁

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

fzf를 활용해 터미널에서 Claude Code 프로젝트 폴더와 실행 모드를 간편하게 선택하는 셸 스크립트 구현 방법이다.

배경

Claude Code 사용 시 여러 프로젝트 폴더를 오가며 실행 모드를 선택해야 하는 번거로움을 줄이기 위해 fzf 기반의 터미널 선택기를 제작하여 공유했다.

의미 / 영향

복잡한 AI 도구의 사용성을 개선하기 위해 별도의 무거운 소프트웨어 대신 가벼운 셸 스크립트와 기존 CLI 도구를 조합하는 방식이 효율적임을 확인했다. 특히 보안 옵션을 스크립트에 내장함으로써 실무 환경에서 안전하게 AI 에이전트를 활용하는 모범 사례를 제시했다.

커뮤니티 반응

대체로 긍정적이며, 셸 스크립트를 활용한 효율적인 워크플로 개선 방식에 관심을 보였다.

합의점 vs 논쟁점

합의점

fzf가 터미널 기반 워크플로의 생산성을 높이는 데 유용하다는 점
AI 에이전트의 권한을 제한하는 샌드박싱 옵션의 중요성

실용적 조언

brew install fzf로 fzf를 먼저 설치해야 스크립트가 작동한다.
스크립트 내의 base 변수를 실제 프로젝트가 저장된 경로로 수정해야 한다.
source ~/.zshrc를 실행하여 변경 사항을 즉시 반영한다.

섹션별 상세

fzf를 이용한 대화형 디렉토리 탐색 구현. fzf 도구를 활용하여 지정된 기본 경로 내의 모든 하위 디렉토리를 검색 가능한 목록으로 변환한다. basename 명령어로 전체 경로 대신 폴더명만 노출하고 grep으로 특정 패턴을 제외하여 가독성을 높였다. 사용자가 목록에서 항목을 선택하면 해당 경로가 변수에 저장되어 다음 단계로 전달된다.

bash

a() {
  local base="/path/to/your/projects"
  local dir=$(basename -a "$base"/*/ | grep -v '#' | fzf --prompt="Project: " | xargs -I {} echo "$base/{}/")
  [[ -z "$dir" ]] && return
  local mode=$(printf "claude
claude --dangerously-skip-permissions
opencode" | fzf --prompt="Mode: ")
  [[ -z "$mode" ]] && return
  cd "$dir" && eval "$mode"
}

fzf를 사용하여 프로젝트 폴더와 실행 모드를 선택하고 실행하는 셸 함수

다중 실행 모드 선택 시스템 구축. 프로젝트 폴더 선택 직후 claude의 다양한 실행 옵션을 메뉴 형태로 제시한다. 일반 실행, 권한 확인 건너뛰기, 오픈코드 모드 등을 printf와 fzf 조합으로 나열하여 사용자가 즉석에서 선택하게 했다. 이는 매번 긴 명령어를 입력해야 하는 번거로움을 해결하고 오타로 인한 실행 오류를 방지한다.

보안을 위한 샌드박싱 설정 적용. Claude Code 실행 시 --add-dir . 옵션을 추가하여 AI 에이전트의 파일 시스템 접근 권한을 현재 디렉토리로 한정했다. 이 방식은 에이전트가 프로젝트 외부의 민감한 데이터에 접근하거나 시스템 설정을 변경하는 위험을 차단한다. 순수 셸 스크립트만으로 별도의 무거운 도구 없이 보안 워크플로를 구현했다는 점이 특징이다.

코드 예제

bash

brew install fzf

fzf 도구 설치 명령어

실무 Takeaway

fzf와 간단한 셸 스크립트 조합으로 Claude Code 전용 프로젝트 관리 도구를 직접 제작할 수 있다.
.zshrc에 별칭(Alias)이나 함수를 등록하여 터미널, SSH, 모바일 환경 어디서든 동일한 워크플로를 유지한다.
add-dir . 옵션을 통해 AI 에이전트의 작업 범위를 제한함으로써 보안성을 확보한 상태로 코딩 보조를 받을 수 있다.

언급된 도구

fzf추천

터미널용 퍼지 파인더

Claude Code추천

자율 AI 코딩 에이전트