내 Mac에 로컬 AI 설치하기 · Ollama + Qwen3.8 + OpenCode

Local AI Guide
자료 최종 수정 2026.09.14

Mac Local AI · 5-step tutorial

Ollama를 한 번 설치하고 Qwen3.8을 내려받은 뒤, 터미널과 앱에서 테스트하고 OpenCode까지 연결하는 실전 가이드입니다.

설치 시작하기 5단계 실습 가이드
Mac Ollama Qwen3.8 App · OpenCode
One install 앱과 CLI는 한 번에 설치됩니다.

macOS 터미널 설치 명령이 Ollama 앱과 ollama 명령을 함께 준비합니다.

One model 터미널·앱·OpenCode가 같은 모델을 씁니다.

Qwen3.8을 한 번 내려받으면 각 도구에서 다시 다운로드할 필요가 없습니다.

Install once

Ollama 설치

공식 설치 명령으로 데스크톱 앱과 터미널 명령어를 한 번에 설치합니다.

Terminal
curl -fsSL https://ollama.com/install.sh | sh
Verify
ollama --version
성공 확인

버전 번호가 표시되고 응용 프로그램 폴더 또는 메뉴 막대에서 Ollama를 확인할 수 있으면 성공입니다.

문제가 생기면

command not found: ollama가 나오면 터미널을 완전히 닫았다 다시 열고, /Applications/Ollama.app을 한 번 실행하세요.

완료 기준버전 번호와 Ollama 앱이 모두 확인됨

Pull the model

Qwen3.8 모델 다운로드

M4 Pro 48GB에 맞는 27B MLX 모델을 내려받습니다. 모델 파일은 약 18GB입니다.

Terminal
ollama pull qwen3.8:27b-mlx
Verify
ollama list
성공 확인

설치된 모델 목록에 qwen3.8:27b-mlx가 표시되면 준비가 끝났습니다.

문제가 생기면

다운로드가 중단되면 인터넷 연결과 저장 공간을 확인한 뒤 같은 명령을 다시 실행하세요.

완료 기준ollama list에서 정확한 MLX 태그가 확인됨

Test in terminal

터미널 프롬프트 테스트

간단한 업무 프롬프트 5개로 한국어 응답·문장 다듬기·요약·아이디어·번역을 빠르게 확인합니다.

Terminal
ollama run qwen3.8:27b-mlx

01 · 오늘 업무 정리

오늘 해야 할 업무를 중요도 순으로 정리해줘: 오전 10시 팀 회의, 거래처 견적 회신, 주간보고서 작성.

02 · 업무 문장 다듬기

다음 문장을 정중한 업무 메일 문장으로 다듬어줘: 자료가 아직 안 왔습니다. 오늘 오후 3시까지 보내주세요.

03 · 두 문장 요약

다음 내용을 두 문장으로 요약해줘: 신제품 출시일은 10월 15일이며, 홍보물 최종본은 10월 5일까지 확정해야 한다. 영업팀 교육은 10월 8일에 진행한다.

04 · 아이디어 제안

회의 시간을 줄일 수 있는 현실적인 방법 5가지를 짧게 알려줘.

05 · 비즈니스 영어 번역

다음 문장을 자연스러운 비즈니스 영어로 번역해줘: 제안서를 검토한 뒤 금요일까지 답변드리겠습니다.

성공 확인

각 요청에 맞는 답변이 정상적으로 생성되면 성공입니다. 대화를 마치려면 /bye를 입력합니다.

알아둘 점

첫 답변은 모델을 통합 메모리에 올리는 과정 때문에 이후 답변보다 늦게 시작될 수 있습니다.

완료 기준간단한 프롬프트 5개를 실행해 정상 응답을 확인함

Use the desktop app

Ollama 앱에서 테스트

역할·목표·상황·출력 형식·조건을 갖춘 체계적인 직장인 실무 프롬프트 10개를 앱에서 테스트합니다.

  1. 응용 프로그램에서 Ollama를 엽니다.
  2. 새 채팅을 시작하고 모델 목록에서 qwen3.8:27b-mlx를 선택합니다.
  3. 프롬프트를 입력하거나 텍스트·PDF·이미지를 끌어다 놓습니다.
  4. 긴 문서나 OpenCode를 사용할 때는 Settings에서 Context Length를 64K로 설정합니다.

Practice files

자료를 내려받아 앱에 첨부하거나 내용을 붙여넣으세요.

구글 문서는 PDF로, 시트는 CSV로 내려받아 Ollama 앱에 첨부할 수 있습니다. 필요한 텍스트나 표를 복사해 붙여넣어도 됩니다. 링크 주소만 입력하면 모델이 내용을 직접 열 수 없습니다.

01 · 비즈니스 이메일 작성

바로 사용

[역할]
회사 내부·외부 이메일을 작성하는 비즈니스 커뮤니케이션 담당자

[목표]
세미나 일정 변경을 알리는 이메일을 작성해줘.

[상황]
- 받는 사람: 리테일영업본부 김지훈 팀장
- 기존 일정: 7월 3일
- 변경 일정: 7월 10일
- 장소: 본사 대강당으로 동일
- 회신 요청: 참석 여부를 7월 4일까지 회신

[출력 형식]
1. 이메일 제목 후보 2개
2. 인사말
3. 일정 변경 안내
4. 회신 요청
5. 맺음말

[조건]
정중한 존댓말을 사용하고, 본문은 350자 이내로 작성해줘.

02 · 회의록 정리

자료 활용

[역할]
회의 내용을 실행 계획으로 바꾸는 10년차 프로젝트 매니저

[목표]
첨부한 회의록을 읽고 핵심 결정과 후속 업무를 정리해줘.

[출력 형식]
1. 회의 핵심 요약 3줄
2. 결정 사항 표: 안건 | 결정 내용
3. 액션 아이템 표: 할 일 | 담당자 | 기한 | 상태
4. 미결 이슈 목록
5. 다음 회의에서 확인할 질문

[조건]
자료에 없는 담당자나 기한을 추측하지 말고 ‘확인 필요’라고 표시해줘.

03 · 보고서 초안

바로 사용

[역할]
경영진 보고서를 작성하는 기획 담당자

[목표]
‘하반기 사내 디지털 협업 강화 방안’ 보고서 초안을 작성해줘.

[현재 상황]
- 회의 시간이 지나치게 길다.
- 부서마다 문서 양식이 다르다.
- 생성형 AI 활용 기준이 없다.
- 추가 예산은 제한적이다.

[출력 형식]
1. 보고서 제목
2. 핵심 요약 3줄
3. 배경 및 문제점
4. 개선 방안
5. 실행 순서
6. 기대 효과

[조건]
사실과 제안을 구분하고, 핵심 내용은 글머리표로 정리해줘.

04 · 긴 문서 핵심 요약

자료 활용

[역할]
경영진용 브리핑 자료를 작성하는 분석가

[목표]
첨부한 AI 트렌드 문서에서 우리 회사가 알아야 할 내용만 추려줘.

[출력 형식]
1. 한 문장 결론
2. 핵심 내용 5개
3. 기회와 위험 비교표
4. 우리 회사가 바로 검토할 일 3개
5. 추가 확인이 필요한 내용

[조건]
첨부 자료에 있는 내용만 사용해줘. 각 핵심 내용에는 근거가 있는 페이지나 소제목을 표시하고, 확인할 수 없으면 ‘위치 확인 필요’라고 적어줘.

05 · 업무 데이터 분석

자료 활용

[역할]
실무 의사결정을 돕는 데이터 분석가

[목표]
첨부한 CSV 파일 또는 붙여넣은 표를 분석해 성과 변화와 이상 징후를 찾아줘.

[분석 순서]
1. 빈칸, 중복, 단위 오류 확인
2. 주요 지표 비교
3. 가장 큰 증가와 감소 항목 확인
4. 눈에 띄는 변화 3개 설명
5. 실행 가능한 개선안 3개 제안

[출력 형식]
데이터 품질 점검 → 핵심 지표 표 → 주요 변화 → 개선안 순서

[조건]
계산식과 단위를 함께 표시하고, 누락값을 0으로 간주하지 마. 원인을 확정할 수 없으면 ‘가설’이라고 표시해줘.

06 · 발표 슬라이드 구성

바로 사용

[역할]
직장인 교육 발표를 설계하는 프레젠테이션 기획자

[목표]
‘직장인을 위한 생성형 AI 업무 활용법’ 20분 발표안을 만들어줘.

[청중]
생성형 AI를 처음 사용하는 직장인 30명

[출력 형식]
10장 내외의 표로 작성해줘.
열 구성: 번호 | 슬라이드 제목 | 핵심 메시지 | 추천 시각자료 | 발표자 설명

[조건]
슬라이드 한 장에는 하나의 핵심 메시지만 넣고, 근거 없는 통계는 만들지 마. 마지막 장에는 바로 실천할 수 있는 행동 3개를 넣어줘.

07 · 비즈니스 영어 이메일

바로 사용

[역할]
한국어와 영어를 모두 사용하는 비즈니스 이메일 편집자

[목표]
아래 한국어 이메일을 자연스럽고 정중한 비즈니스 영어로 바꿔줘.

[원문]
안녕하세요, 보내주신 제안서 잘 받았습니다.
내부 검토 후 다음 주 중 회신드리겠습니다.
일정이 촉박한 점 양해 부탁드리며, 추가 자료가 있으면 공유해 주세요.

[출력 형식]
1. 영어 제목
2. 영어 이메일
3. 한국어 역번역
4. 핵심 영어 표현 3개와 사용 이유

[조건]
직역하지 말고, 해외 거래처에 보내기 적합한 간결하고 전문적인 표현을 사용해줘.

08 · 업무 우선순위와 일정

바로 사용

[역할]
업무 일정과 우선순위를 관리하는 비서실 담당자

[목표]
아래 업무를 긴급도와 중요도에 따라 정리하고 실행 순서를 제안해줘.

[업무 목록]
- 오늘 안에 시황 브리핑 발송
- 김 팀장 보고서 피드백 내일까지 반영
- 세미나 장소 예약 확인
- 다음 주 고객 미팅 자료 준비
- 경비 정산 영수증 금요일까지 제출

[출력 형식]
1. 긴급도·중요도 분류표
2. 오늘 처리할 업무 순서
3. 이번 주 체크리스트
4. 놓치기 쉬운 위험 요소

[조건]
제공된 마감일을 우선 반영하고, 소요시간이 없으면 임의로 만들지 말고 ‘확인 필요’라고 표시해줘.

09 · 아이디어와 실행안

바로 사용

[역할]
조직문화 개선 프로젝트를 돕는 컨설턴트

[목표]
신입사원 온보딩 만족도를 높일 수 있는 아이디어 10개를 제안해줘.

[조건]
- 준비 기간: 4주
- 대상: 신입사원 50명
- 추가 예산: 300만 원 이내
- 온라인과 오프라인 아이디어를 섞어 제안

[출력 형식]
아이디어 | 기대 효과 | 예상 비용 | 준비 기간 | 실행 난이도 | 주의점

[마무리]
10개 중 효과와 실행 가능성이 높은 3개를 선정하고, 선정 이유와 첫 주 실행 계획을 작성해줘.

10 · 엑셀·구글시트 수식

바로 사용

[역할]
초보자에게 쉽게 설명하는 엑셀·구글시트 전문가

[목표]
B열의 상태가 ‘완료’인 행만 골라 C열의 금액을 합산하는 수식을 만들어줘.

[데이터 조건]
- 데이터는 2행부터 100행까지 있다.
- B열: 상태
- C열: 금액

[출력 형식]
1. 엑셀 수식
2. 구글시트 수식
3. 수식의 작동 원리
4. 4행짜리 예시 표와 계산 결과
5. 자주 발생하는 오류 2개

[조건]
엑셀과 구글시트에서 같은 수식을 사용한다면 동일하다고 명확히 알려줘.

성공 확인

역할·목표·상황·출력 형식·조건이 답변에 반영되면 정상입니다. 자료 기반 프롬프트는 내려받은 파일을 먼저 첨부한 뒤 실행하세요.

문제가 생기면

모델 목록에 보이지 않으면 ollama list로 설치 여부를 확인한 뒤 Ollama 앱을 다시 실행하세요.

완료 기준체계적인 프롬프트 10개 중 내 업무에 맞는 3개 이상을 테스트함

Connect OpenCode

OpenCode 연결

OpenCode Desktop을 설치한 뒤, 앱의 ‘사용자 지정 공급자’에서 같은 Mac의 Ollama 로컬 모델을 연결하고 첫 응답을 확인합니다.

Official download

Mac용 OpenCode Desktop을 다운로드하세요.

M4 Pro는 Apple Silicon 칩입니다. 공식 사이트의 Download 페이지에서 OpenCode Desktop → macOS (Apple Silicon)을 선택합니다.

  1. 다운로드 폴더에서 받은 OpenCode Desktop.dmg 파일을 엽니다.
  2. 설치 창의 OpenCode 아이콘을 Applications 폴더로 드래그합니다.
  3. Finder의 응용 프로그램에서 OpenCode를 실행합니다.
  4. 처음 실행 확인 창이 나오면 열기를 선택합니다. macOS가 차단하면 시스템 설정 → 개인정보 보호 및 보안에서 열기를 허용합니다.

1. 연결할 로컬 모델 확인

OpenCode와 Ollama가 같은 Mac에 설치된 경우의 설정입니다. Ollama 앱을 켜 둔 상태에서 터미널에 아래 명령을 입력하세요. 긴 문서를 다루려면 앞 단계에서 안내한 Context Length 설정도 확인합니다.

설치된 모델 확인
ollama ls

목록의 NAME 열에 있는 qwen3.8:27b-mlx를 확인합니다. OpenCode의 모델 ID에는 이 이름을 넣습니다. 옆의 ID 열에 있는 긴 숫자·문자 값은 넣지 않습니다. 다른 모델을 설치했다면 아래 예시 대신 실제 NAME 값을 사용하세요.

2. 사용자 지정 공급자 화면 열기

OpenCode 설정 → 공급자 → 사용자 지정 공급자 → 연결

이번 실습에서는 Ollama Cloud가 아니라 사용자 지정 공급자를 선택합니다. 앱 버전에 따라 메뉴 이름이나 위치는 조금 다를 수 있습니다.

3. 화면에 아래 값 입력하기

같은 Mac의 Ollama 로컬 모델을 연결하는 OpenCode 입력값
공급자 ID
ollama-local
공급자를 구분하는 이름입니다. 같은 ID가 이미 등록되어 있다면 기존 설정을 확인하거나 다른 ID를 사용합니다.
표시 이름
Ollama Local
공급자 목록에서 알아보기 위한 이름입니다.
기본 URL
http://127.0.0.1:11434/v1
같은 Mac의 Ollama 주소입니다. 끝의 /v1까지 입력하세요.
API 키
선택 사항
ollama
이 실습에서는 ollama로 통일합니다. 별도로 발급받는 키나 비밀번호가 아니며, Ollama 로컬 연결에서는 인증에 사용하지 않습니다.
모델 ID
model-id
qwen3.8:27b-mlx
ollama ls의 NAME 값과 정확히 일치해야 합니다.
모델 표시 이름
Qwen3.8 27B MLX (로컬)
모델 선택 메뉴에 표시될 이름입니다.
헤더 비워 두기이번 연결에는 추가 헤더가 필요하지 않습니다.

기본으로 보이는 모델 한 줄에 입력하면 됩니다. ‘모델 추가’와 ‘헤더 추가’는 누르지 않고, 입력값을 확인한 뒤 하단의 ‘제출’을 누르세요.

입력값 참고: OpenCode의 Ollama 설정 · Ollama 로컬 연결값 안내

4. 모델을 선택하고 첫 응답 확인

  1. 대화 화면으로 돌아갑니다. 작업 폴더를 요청하면 실습용 폴더를 선택하고 새 대화를 시작합니다.
  2. 모델 선택 메뉴에서 Ollama Local 공급자의 Qwen3.8 27B MLX (로컬)을 선택합니다.
  3. 아래 인사 프롬프트를 보내 실제 답변이 나오는지 확인합니다. 다른 표시 이름을 입력했다면 그 이름으로 찾으세요.

첫 연결 테스트 · 인사만 요청

파일을 수정하거나 명령을 실행하지 말고,
한국어로 짧게 인사만 해줘.

다음 테스트 · 폴더 읽기 (선택)

현재 열린 폴더의 파일 구조를 먼저 확인해줘. 파일은 수정하지 말고, 이 프로젝트가 무엇을 하는지 한국어로 요약해줘.

성공 확인

등록한 로컬 모델을 선택한 상태에서 인사 요청에 답변이 나오면 기본 연결에 성공한 것입니다. 모델이 목록에 보이는 것만으로는 부족합니다. 폴더 읽기나 파일 수정 등 도구를 사용하는 작업은 별도로 확인합니다.

문제가 생기면
  • 연결되지 않음: Ollama 앱이 같은 Mac에서 실행 중인지, 기본 URL 끝에 /v1이 있는지 확인합니다.
  • 모델을 찾을 수 없음: 모델 ID가 ollama ls의 NAME과 같은지 확인합니다.
  • 저장했는데 목록에 없음: 모델 선택 메뉴에서 등록한 표시 이름을 다시 검색하고, 필요하면 OpenCode 앱을 완전히 종료했다가 다시 엽니다.
  • 모델은 보이지만 응답 실패: 오류 메시지를 확인하고 Ollama 앱에서 같은 모델로 짧은 대화를 먼저 테스트합니다.
참고 · 기존 터미널 연결 명령

터미널용 OpenCode 연동 설정에는 아래 명령도 사용할 수 있습니다. 데스크톱 앱은 위의 사용자 지정 공급자 등록 절차로 연결하세요.

Configure OpenCode
ollama launch opencode --config
완료 기준사용자 지정 공급자 등록, 로컬 모델 선택, 인사 응답 확인을 마침

Local stack complete

이제 AI가 내 Mac 안에서 실행됩니다.

터미널, Ollama 앱, OpenCode가 하나의 Qwen3.8 모델을 함께 사용합니다.

01Ollama 앱과 CLI를 한 번에 설치
02qwen3.8:27b-mlx 다운로드
03터미널에서 간단한 프롬프트 5개 테스트
04Ollama 앱에서 체계적인 업무 프롬프트 10개 테스트
05OpenCode Desktop에서 사용자 지정 공급자 등록 후 로컬 모델 응답 확인

공식 자료