[iOS] Cursor 에 iOS(Xcode) 프로젝트 연동하기

안녕하세요.

오랜만에 포스팅을 올리네요.

 

오늘은 iOS 프로젝트를 연동하는 법에 대해 포스팅하려고 합니다.

 

최근 여러 ChatGPT 를 비롯해 여러 AI Tool 들이 발전하면서 AI Coding Agent 도 많이 나타나고 발전했는데요

Github Copliot, windsurf, Cursor, Claude Code, (아직 써보진 못했지만) ChatGPT Codex.. 등

 

그 중에서도 저는 회사에서 사용하고 가장 범용적이고 iOS 에서 사용성이 (그나마) 높은 Cursor 를 선택했습니다.

 

Cursor 설치

https://cursor.com/downloads

Downloads | Cursor - The AI Code Editor

 

Download 페이지에서 맞는 버전을 다운받으셔도 되고 우측 상단 다운로드에서 바로 다운로드가 가능합니다.

저는 맥북이라 macOS 에서 설치했습니다

 

설치 후 Cursor 앱을 켜면 아래 화면이 보이실텐데요.

우선 Cursor 를 사용하기 위해선 계정 생성이 필요하니 https://cursor.com/?from=home Cursor 홈페이지에서 계정을 만들어줍니다.

Cursor - The AI Code Editor

다시 Cursor 앱으로 돌아와 로그인을 하면 계정 구독 상태에 따라 Free or Pro 문구가 뜨게됩니다. (저는 Pro 구독 결제했습니다!)

Cursor 는 VSCode 를 베이스로 하기 때문에 VSCode 을 사용하시는 분들이라면 더욱 익숙하실텐데요.

저는 iOS 개발 한계상 Xcode 를 너무나도 오래 썼더니 처음에는 많이 어색했습니다.

 

이 상태에서 iOS 프로젝트 먼저 오픈해보겠습니다.

왼쪽에는 파일 탐색을 할수 있는 Explore 를 포함한 화면이 있고 가운데 화면은 실제 코드가 보이는 화면입니다.

현재는 오픈된 파일이 없어서 빈화면입니다.

 

오른쪽이 가장 중요한 Cursor 에게 명령을 내리는 부분인 Agent 탭인데요.

 

Agent 탭에서 커서에게 요청을 내리거나 질문을 할 수 있습니다.

 

Agent 에서 사용할 수 있는 명령의 형태는 현재 버전 (1.2) 에서 3가지가 있는데요

그중 Agent 와 Ask 에 대해 정리하자면

 

Agent

• Agent는 Cursor에서 제공하는 AI 기반 자동화 도구입니다.
• 사용자의 코드베이스를 이해하고 지속적으로 작업을 수행할 수 있는 자율적인 AI 어시스턴트입니다.
• 복잡한 작업을 여러 단계로 나누어 수행하며, 코드베이스의 컨텍스트를 유지합니다.

Ask

• Ask는 Cursor에서 제공하는 단일 질문-응답 형태의 AI 지원 기능입니다.
• 특정 질문이나 요청에 대해 일회성 응답을 제공합니다.
• 간단한 코드 설명, 문제 해결, 코드 생성 등에 사용됩니다.

저는 코드를 생성하거나 수정할때는 Agent 를 사용하고 ChatGPT 같이 질의 필요한 경우에는 Ask 를 사용하는 편입니다.

 

Cursor iOS 개발 환경 세팅

VSCode 는 iOS 개발에 특화된 환경이 아니라 몇가지 추가적인 세팅이 필요합니다.

지금부터 하나씩 세팅을 해주겠습니다.

 

우선 Cursor 에서 Extension 으로 추가할 수 있는 아래 환경을 추가해주시면 됩니다.

 

Extension 에서 총 3가지를 설치해줍니다.

 

• SwiftLint

• Swift

• Sweetpad

 

SwiftLint 는 iOS 개발자라면 익숙한 Swift 코드 스타일과 규칙을 자동으로 검사하고 정리해주는 도구입니다.

Swift Extension 은 Swift 의 Indexing 을 할 수 있도록 해주는 Extension 이구요

SweetPad 는 Xcode 프로젝트를 VSCode(Curso­r 포함)에서 빌드·실행·디버깅할 수 있게 해주는 iOS/Swift 개발 확장입니다.

 

Extension 설치는 이렇게 끝났고 추가적인 도구들 설치도 있으면 좋습니다.

• Xcode Build Server 설치: SourceKit-LSP를 Xcode 외부에서 코드 정의로 이동, 모든 참조 보기등과 같은 기능을 제공

brew install xcode-build-server

• xcbeautify 설치: xcodebuild 출력 결과를 이쁘게 표시

brew install xcbeautify

• SwiftFormat: 코드 포맷팅 도구

install swiftformat

 

요정도 세팅을 해도 Xcode 에 비해 아직 기능이 부족하고 단독으로 개발하기엔 많은 애로사항이 있습니다.ㅠㅠ

xcodeproj 파일을 수정하거나 반영한다던가 빌드나 테스팅에서 문제가 자주 발생한다던가..

 

그래도 Cursor 를 통해 코드를 생성 및 수정하고 Text Edit 환경으로써는 잘 동작해서 저는 둘다 사용하는 방식으로 익숙해지고 있습니다.

 

여기까지 Cursor 를 iOS 개발 환경에 적용하는 방법을 알아봤습니다.

 

마지막으로 Cursor 통해 실제 코드가 적용된 예시를 보여드리고 마무리하겠습니다.

포스팅 읽어주셔서 감사합니다.