번역 자료 / / 2025. 5. 20. 07:28

[cursor docs] @ Files

개요

Cursor의 @ Files 기능은 코드베이스 내의 특정 파일을 빠르게 탐색하고, AI가 해당 파일의 맥락을 정확히 이해할 수 있도록 도와줍니다. 이 글에서는 @ Files의 개념, 주요 기능, 실제 사용 방법, 그리고 실무에서의 활용 팁을 단계별로 설명합니다.

@ Files란?

@ Files는 코드 내에서 파일 단위로 빠르게 이동하거나, AI가 특정 파일의 내용을 우선적으로 참고하도록 지정할 수 있는 기능입니다. 대규모 프로젝트에서도 원하는 파일을 신속하게 찾고, 관련 정보를 효율적으로 확인할 수 있습니다.

주요 기능

  • 빠른 파일 탐색: @ 뒤에 파일명을 입력하면 프로젝트 내 모든 파일을 검색할 수 있습니다.
  • 파일 기반 컨텍스트 제공: AI가 특정 파일의 전체 내용 또는 구조를 우선적으로 참조합니다.
  • 자동 완성 및 추천: 파일명 일부만 입력해도 자동 완성 기능이 동작합니다.
  • 대규모 프로젝트 지원: 수많은 파일이 있는 환경에서도 빠른 탐색이 가능합니다.

실제 사용 방법

  1. 파일 검색: 에디터에서 @를 입력한 뒤, 찾고자 하는 파일명을 입력하면 해당 파일로 바로 이동할 수 있습니다.
  2. AI 컨텍스트 강화: 프롬프트나 명령어에서 @파일명을 사용하면, AI가 해당 파일의 내용을 우선적으로 참고합니다.
  3. 자동 완성 활용: 파일명을 전부 입력하지 않아도, 일부만 입력하면 자동 완성 리스트가 나타나 빠르게 선택할 수 있습니다.

실무 활용 팁

  • 대규모 프로젝트에서는 파일 검색 기능을 적극 활용해, 원하는 파일로 빠르게 이동하세요.
  • AI에게 특정 파일의 맥락을 명확히 전달하고 싶을 때 @파일명을 프롬프트에 포함시키면 더욱 정확한 답변을 받을 수 있습니다.
  • 비슷한 이름의 파일이 많을 때는 자동 완성 리스트에서 원하는 항목을 쉽게 선택할 수 있습니다.

참고 자료

반응형
  • 네이버 블로그 공유
  • 네이버 밴드 공유
  • 페이스북 공유
  • 카카오스토리 공유