Ollama의 기본 로컬 API 주소는 http://localhost:11434입니다(Ollama 공식 자주 묻는 질문). 맥에서 로컬 AI 코딩 환경을 만들려면 먼저 운영체제와 사용 가능한 자원을 확인하고, Ollama에서 호환 모델을 실행한 다음 VS Code 확장에 연결해 코드 생성을 시험하세요. 모델 호환성과 맥의 여유 자원에 따라 사용 경험이 달라지므로, 일상 작업에 넣기 전에 작은 시험부터 진행하는 것이 안전합니다.
이 안내는 맥에서 로컬 모델로 코드를 보조하려는 개발자와 학습자에게 적합합니다.
Ollama를 VS Code에 연결하려는 경우, 또는 현재 맥의 자원이 충분한지 판단하려는 경우에도 따라 할 수 있습니다.
준비 단계: 맥과 개발 목표 확인
로컬 추론은 모델 실행과 입력 처리를 자신의 맥에서 하는 방식입니다. 온라인 AI 서비스와 달리 네트워크 연결이나 외부 서비스 계정에 의존하지 않을 수 있지만, 모델 파일을 저장할 공간과 추론을 수행할 기기는 직접 준비해야 합니다. 처음 설치할 때 모델을 내려받으려면 인터넷 연결도 필요합니다.
설치 전에 다음 항목을 확인하세요.
- 맥OS가 Ollama의 맥용 설치 안내에 나오는 현재 지원 조건을 충족하는지 확인합니다. 지원 여부를 확인하지 않은 채 설치부터 진행하지 마세요.
- 저장 공간이 충분한지 확인합니다. 모델 파일 외에 프로젝트 파일, 개발 도구, 임시 파일도 공간을 사용합니다.
- 동시에 실행할 개발 도구를 고려합니다. 편집기, 브라우저, 빌드 도구가 자원을 함께 사용하므로 모델만 실행할 때와 실제 개발 환경의 여유 자원은 다를 수 있습니다.
- 코드 자동 완성, 코드 설명, 테스트 초안 작성 중 무엇이 필요한지 정합니다. 작업에 맞는 모델을 찾지 않고 파일 크기만 보고 고르면 결과가 기대와 다를 수 있습니다.
예를 들어, 짧은 함수 설명이나 간단한 테스트 초안이 목적이라면 작은 모델부터 실행해 실제 프로젝트 코드로 확인할 수 있습니다. 긴 파일을 다루거나 복잡한 변경을 요청할 계획이라면 응답 품질과 맥의 자원 사용을 직접 비교해야 합니다. 어떤 맥에서든 모든 모델이 원활하게 작동한다고 가정하지 마세요.
설치와 모델 실행
맥용 설치 파일과 절차는 Ollama 공식 다운로드 안내에서 확인합니다. 설치 방법이나 화면은 운영체제와 배포 방식에 따라 달라질 수 있으므로, 안내에 나온 현재 절차를 기준으로 진행하세요. 설치가 끝나면 앱이 실행되는지 확인하고, 터미널에서 모델을 호출해 Ollama와 모델 실행을 따로 점검합니다.
Qwen2.5-Coder 모델 태그 목록에는 0.5b, 1.5b, 3b, 7b, 14b, 32b와 같은 크기 표기가 있습니다. 이 값은 모델 선택에 참고할 수 있는 구분 정보이지, 특정 맥에서의 실행 속도나 코드 품질을 보장하지 않습니다. 처음에는 사용 가능한 태그와 기기 자원을 확인하고 작은 쪽부터 시험하세요.
터미널에서 진행하는 기본 흐름은 다음과 같습니다.
ollama pull qwen2.5-coder:1.5b
ollama run qwen2.5-coder:1.5b
사용할 태그가 현재 모델 페이지에 있는지 먼저 확인하세요. pull은 지정한 모델을 내려받고, run은 그 모델을 실행해 입력을 받을 수 있게 합니다. 모델에 짧은 코드 설명을 요청해 응답이 오는지 확인하면 모델 실행 여부를 구분하기 쉽습니다. 다운로드가 끝났더라도 이 검사가 통과하기 전까지 VS Code 연결이 된 것은 아닙니다.
모델 이름을 다른 태그로 바꾸면 편집기 쪽의 모델 선택도 같은 이름으로 맞춰야 합니다. 이름이 다르면 Ollama에는 모델이 있어도 확장에서 찾지 못할 수 있습니다.
VS Code 연결과 코드 생성 확인
Continue는 Ollama를 제공자로 설정할 수 있는 VS Code 확장입니다. 설치는 Continue의 편집기 확장 설치 안내를 따르고, 연결 세부 설정은 Ollama 제공자 구성 문서에서 확인하세요. 확장 이름만으로 설정이 자동 완성된다고 보지 말고, 제공자와 모델 지정 방식을 문서에 맞춰 설정해야 합니다.
실제 연결은 다음 순서로 확인합니다.
- 맥과 도구: Ollama가 실행 중인지 확인하고, VS Code에 호환 확장을 설치합니다.
- 모델 실행: 터미널에서 선택한 모델을 직접 호출해 응답을 확인합니다.
- 제공자 설정: 확장 설정에서 Ollama를 모델 제공자로 선택하고, 공식 문서에 안내된 연결 정보를 입력합니다.
- 모델 이름 일치: VS Code에 지정한 이름과 Ollama에서 실행 가능한 태그가 같은지 대조합니다.
- 낮은 위험의 시험: 비밀 키나 실제 서비스 주소가 없는 새 파일에서 간단한 함수를 설명하거나 테스트 초안을 요청합니다.
- 결과 검토: 생성된 코드를 그대로 실행하지 말고 직접 읽고, 로컬 테스트를 통과하는지 확인합니다.
작업 공간에서 확장 기능이 기대대로 동작하지 않으면 VS Code 작업 공간 신뢰 안내를 확인하세요. 신뢰 설정은 작업 공간에서 사용할 수 있는 기능에 영향을 줄 수 있습니다. 코드를 검토하지 않고 실행하는 것은 모델이 로컬에서 동작하더라도 별개의 보안 위험입니다.
연결 오류와 자원 부족 구분
터미널에서는 모델 응답이 오는데 VS Code에서만 연결에 실패한다면, 우선 확장 설정을 점검하세요. 제공자가 Ollama로 지정됐는지, API 주소와 모델 태그가 일치하는지, 확장이 해당 구성을 읽고 있는지 확인합니다. VS Code를 다시 열어도 해결되지 않는다면 Ollama가 실제로 응답하는지 먼저 확인하고, 그다음 확장 설정을 한 항목씩 바꿔 봅니다.
터미널에서도 모델 호출이 실패한다면 편집기보다 Ollama 상태와 모델 호환성을 먼저 확인해야 합니다. 모델 태그가 잘못됐거나 현재 환경에서 사용할 수 없을 수 있습니다. 모델 실행 중 다른 개발 도구가 함께 느려지거나 메모리 압박이 커진다면 작업을 줄여 다시 시험하세요. 이 경우 작은 모델로 바꿨을 때 문제가 사라지는지 확인하면 모델 선택과 기기 자원 문제를 가르는 데 도움이 됩니다.
다음 표로 실패 지점을 나눠 보세요.
| 확인 결과 | 먼저 점검할 부분 | 다음 조치 |
|---|---|---|
| 터미널에서 모델 호출 실패 | Ollama 실행 상태, 모델 태그, 현재 시스템과의 호환성 | 공식 모델 목록과 설치 안내를 대조한 뒤 다른 태그로 시험 |
| 터미널은 성공하고 VS Code만 실패 | 확장 제공자, 주소, 모델 이름, 작업 공간 설정 | 확장 공식 설정 문서대로 값을 다시 확인 |
| 모델은 응답하지만 개발 도구가 버거움 | 동시 실행 앱, 모델 크기, 남은 저장 공간과 자원 | 다른 앱을 줄이고 더 작은 모델로 짧은 시험 진행 |
매일 사용할지 판단하는 기준
한 번 응답을 받은 것만으로 개발에 적합하다고 결론 내리기는 어렵습니다. 자주 쓰는 작업에서 코드 설명, 테스트 초안, 간단한 수정 요청을 각각 시험하고, 결과를 검토하는 데 드는 시간도 살펴보세요. 프롬프트가 긴 작업에서만 실패한다면 모델 연결 문제와 기기 자원 문제를 구분해 다시 확인해야 합니다.
| 선택 | 장점 | 부담과 확인할 점 |
|---|---|---|
| 맥에서 로컬 모델 사용 | 외부 서비스 대신 로컬에서 시험할 수 있고 개발 환경을 직접 통제할 수 있음 | 모델 저장 공간과 맥 자원을 사용하며, 모델별 결과와 호환성을 직접 점검해야 함 |
| 온라인 AI 서비스 사용 | 로컬 모델 설치와 실행을 관리하지 않아도 되는 선택지가 될 수 있음 | 네트워크와 서비스 정책에 영향을 받으며, 코드나 입력을 보내기 전 데이터 처리 조건을 확인해야 함 |
| 원격 맥에서 개발 환경 운영 | 현재 기기와 분리된 개발 환경을 검토할 수 있음 | 연결 상태와 원격 환경의 실제 구성에 의존하므로, 로컬 사용과 같은 결과를 보장하지 않음 |
아래 항목을 확인하면 현재 맥으로 계속 진행할지 판단하기 쉽습니다.
- [ ] Ollama가 맥에서 실행되고 터미널 모델 호출에 응답합니다.
- [ ] 선택한 모델 태그가 공식 목록에 있으며 VS Code 설정 이름과 일치합니다.
- [ ] VS Code 확장의 Ollama 제공자 설정을 공식 문서와 대조했습니다.
- [ ] 실제 프로젝트와 비슷한 짧은 코드 작업을 생성하고 결과를 직접 검토했습니다.
- [ ] 편집기와 개발 도구를 함께 실행했을 때도 작업을 이어갈 수 있는지 확인했습니다.
자주 묻는 질문
Ollama 모델을 VS Code에서 쓰려면 연결 주소를 어떻게 확인하나요?
Ollama의 기본 로컬 API 주소는 http://localhost:11434입니다. 다만 확장마다 입력해야 하는 위치와 설정 형식은 다를 수 있습니다. Continue를 사용하는 경우 Ollama 제공자 구성 문서를 확인하고, 편집기에서 선택한 모델 이름이 터미널에서 실행 가능한 태그와 일치하는지 점검하세요.
맥에서 Ollama와 VS Code가 연결되지 않으면 어떻게 하나요?
Ollama 앱과 모델을 먼저 따로 점검한 다음 VS Code 확장 설정을 확인하세요. 터미널 호출도 실패하면 모델 태그나 Ollama 상태를 살펴보고, 터미널에서는 성공하지만 편집기에서만 실패하면 연결 주소, 제공자 선택, 모델 이름을 확인합니다. 작업 공간 신뢰 설정도 확장 기능에 영향을 줄 수 있습니다.
로컬 모델을 고를 때 맥의 어떤 조건을 봐야 하나요?
운영체제 호환성, 사용 가능한 저장 공간, 동시에 실행할 앱과 개발 도구를 함께 고려하세요. 모델 목록의 크기 표기는 선택을 돕지만 특정 기기에서의 속도나 품질을 보장하지 않습니다. 작은 모델로 직접 코드 작업을 시험하고, 실제 개발 흐름에서 자원과 결과가 모두 감당 가능한지 판단하세요.
온라인 AI 서비스 대신 로컬 실행을 선택할 기준은 무엇인가요?
코드가 기기 안에서 처리되는 구성을 우선하고, 모델 파일과 실행 자원을 직접 관리할 의향이 있다면 로컬 실행을 시험할 수 있습니다. 반면 설치와 자원 관리가 부담이거나 원하는 작업을 모델이 처리하지 못한다면 다른 방식을 비교하세요. 온라인 서비스는 입력 데이터 처리 조건을, 원격 맥은 실제 구성과 접속 의존성을 각각 확인해야 합니다.
맥에서 로컬 모델을 쓰면 설치와 모델 관리, 기기 자원 사용을 직접 감당해야 하고, 모델 호환성이나 VS Code 연결이 어긋나면 원인을 찾아야 합니다. 먼저 현재 맥에서 위 검사를 마친 뒤에도 자원이 부족하거나 개발 환경을 분리해야 한다면, 맥 미니 대여 안내에서 공개된 구성과 이용 정보를 확인해 원격 환경이 맞는지 비교해 보세요. 원격 환경을 검토하는 경우에도 맥 지원 안내에서 지원 정보를 확인하고, 필요한 개발 도구와 작업 흐름을 기준으로 판단해야 합니다. 원격 환경은 로컬 실행과 같다고 단정할 수 없습니다.