문서

자주 묻는 질문 (FAQ)

LEVEL11을 무료 로컬 모델 코딩 머신으로 쓰는 방법. 계정·요금·PC 준비부터 첫 웹페이지 만들기, 오프라인 사용과 문제 해결까지.

LEVEL11 + Ollama + 내 컴퓨터에 내려받은 로컬 모델로 별도의 모델 API 요금 없이 코딩 환경을 만들 수 있습니다. LEVEL11이 에디터·파일 편집·터미널·에이전트 도구를 제공하고, 내 컴퓨터의 모델이 답변과 도구 호출을 담당합니다.

처음이라면 LEVEL11 다운로드 → 로컬 모델 설치·연결 → 아래의 첫 웹페이지 만들기 순서로 시작하세요.

바로 가기: 무료 사용 범위 · 준비와 연결 · 실제로 코딩하기 · 오프라인과 데이터 · 막혔을 때

무료 사용 범위

1. 정말 무료 로컬 모델 코딩 머신으로 쓸 수 있나요?

네. LEVEL11을 내려받고, Ollama·llama.cpp·MLX 중 하나로 다운로드한 로컬 모델을 실행해 연결하면 됩니다. 이 방식의 모델 요청에는 LEVEL11 유료 플랜이나 모델 제공자의 API 키가 필요하지 않으며, LEVEL11이 토큰별 모델 사용료를 청구하지 않습니다.

무료라는 말은 이 로컬 코딩 환경의 앱 구독·모델 API 사용료를 말합니다. PC·전기·저장 공간은 직접 준비하며, 유료 외부 API·호스팅·배포 서비스 등을 별도로 사용하면 해당 서비스의 비용이 생길 수 있습니다. 사용할 모델의 배포·이용 조건도 확인하세요.

2. 회원가입, API 키, 카드 등록 없이도 되나요?

로컬 모델에는 모두 필요 없습니다. 처음 안내의 로그인 화면에서는 나중에 할게요를 선택할 수 있습니다. 모델 연결 방식을 고르는 화면이 나오면 로컬 모델을 선택하거나, 안내를 마친 뒤 설정 → 로컬 모델에서 연결하세요.

기존 LEVEL11 계정에 로그인한 상태여도 로컬 모델을 선택해 쓸 수 있습니다. 실제 대화에 사용할 모델과 에이전트 프리셋의 모델 재정의를 확인하세요.

3. Free 플랜의 토큰을 다 쓰면 로컬 코딩도 멈추나요?

로컬 모델 요청에는 LEVEL11 클라우드 플랜의 일·월 사용량 한도가 적용되지 않습니다. 클라우드 Free 사용량을 다 썼더라도 모델 서버가 실행 중이고 로컬 모델을 선택했다면 계속 쓸 수 있습니다.

로컬 모델도 PC 메모리·처리 속도·모델의 컨텍스트 길이에는 제한을 받습니다. 클라우드 플랜의 자세한 조건은 계정과 요금을 참고하세요.

4. 모델을 Auto로 두면 알아서 무료 로컬 모델을 쓰나요?

아니요. 모델 선택의 Auto는 LEVEL11 라우터이며 로컬 모델을 자동으로 고르는 기능이 아닙니다. 무료 로컬 실행을 원하면 로컬 모델을 직접 선택하고, 작성기에 Ollama · qwen3.5:4b처럼 백엔드와 모델 이름이 표시되는지 확인하세요.

에이전트 프리셋에 다른 모델이 지정되어 있으면 그 재정의가 우선합니다. 프리셋을 편집해 모델 재정의를 local로 지정하거나 세션 모델을 사용하도록 설정합니다. 규칙과 MCP에서 자세히 설명합니다.

준비와 연결

5. Ollama, llama.cpp, MLX를 전부 설치해야 하나요?

하나만 설치하면 됩니다. 처음 연결하는 분은 설치 앱과 모델 다운로드 명령이 있는 Ollama로 시작할 수 있습니다. 이미 GGUF 파일을 갖고 있다면 llama.cpp, Apple Silicon Mac에서 MLX 형식 모델을 쓰려면 MLX를 선택하세요. LEVEL11의 서버 주소는 실행 중인 백엔드와 맞아야 합니다.

6. 어떤 PC와 모델로 시작하면 되나요?

LEVEL11은 macOS·Windows·Linux용 빌드를 제공합니다. MLX 절차는 Apple Silicon Mac용이며, 다른 PC에서는 운영체제에 맞게 Ollama나 llama.cpp를 준비합니다.

첫 연결 예시는 Qwen3.5 4B를 사용합니다. 작은 모델로 대화와 파일 읽기를 먼저 확인하고, 여유 메모리와 작업 난이도에 맞춰 모델을 바꾸세요. 모델 파일 크기만큼의 메모리로 충분한 것은 아닙니다. 운영체제·다른 앱·대화 컨텍스트도 메모리를 사용하므로 특정 RAM 용량에서의 실행을 일괄 보장할 수는 없습니다.

7. 가장 짧은 설정 순서를 알려 주세요

1. Ollama 설치·실행을 마치고 서버를 켜 둡니다. 이 예시에서는 서버의 컨텍스트 길이를 8192로 맞춥니다.
2. 새 터미널에서 아래 명령으로 모델을 내려받고 이름을 확인합니다.

ollama pull qwen3.5:4b
ollama list

3. LEVEL11 설정 → 로컬 모델에서 백엔드를 Ollama, 서버 주소를 http://127.0.0.1:11434, 모델 이름을 qwen3.5:4b로 설정합니다. 주소에 /v1은 붙이지 않습니다.
4. 도구 호출 방식은 자동, 컨텍스트 길이는 서버와 같은 8192로 설정하고 연결 테스트 → 이 모델 사용 → 저장 순서로 적용합니다.
5. 폴더 열기로 작업할 폴더를 열고, 작성기의 모델 이름을 확인한 뒤 짧은 인사를 보내 봅니다. 다음으로 파일 목록을 읽게 해 도구 호출도 확인합니다.

연결 테스트는 모델 목록만 확인합니다. 설치 방법, 운영체제별 서버 실행 명령과 실제 파일 생성 검사는 로컬 모델 가이드에 있습니다. 다음 실행부터는 같은 모델을 다시 받지 않고 Ollama 서버와 LEVEL11을 켜면 됩니다.

실제로 코딩하기

8. 로컬 모델도 파일을 고치고 터미널 명령을 실행할 수 있나요?

네. 모델이 도구 호출을 올바르게 생성하면 LEVEL11이 파일 읽기·검색·편집·명령 실행 도구를 수행합니다. 연결한 모델과 서버의 도구 지원 여부에 따라 성공률은 달라집니다.

• 채팅: 코드 설명·파일 읽기·검토에 사용합니다. 파일을 수정하거나 명령을 실행하지 않습니다.
• 빌더: 파일을 만들고 수정합니다. 명령은 허용 목록과 승인 규칙에 따라 실행합니다.
• 자동 실행: 도구 실행을 더 넓게 허용하는 모드입니다. 위험 명령의 승인 규칙은 유지됩니다.

처음 코딩할 때는 빌더로 시작하고 변경 파일과 실행할 명령을 확인하세요. 에이전트에 모드·승인·체크포인트·되돌리기 설명이 있습니다.

9. 첫 웹페이지는 어떻게 만들어 보나요?

빈 테스트 폴더를 열고 로컬 모델 + 빌더를 선택한 뒤 다음처럼 요청하세요. 외부 패키지가 필요 없는 작은 페이지로 파일 생성부터 확인할 수 있습니다.

현재 폴더에 index.html과 style.css로 자기소개 페이지를 만들어 줘.
외부 패키지나 CDN은 사용하지 마.
제목, 한 줄 소개, 연락처 영역만 넣어 줘.
완료 후 바뀐 파일과 확인 방법을 알려 줘.

생성된 파일을 확인하고 index.html을 브라우저에서 열어 봅니다. 다음 요청은 배경을 어둡게 바꿔 줘., 휴대폰 화면에서도 읽기 편하게 여백을 조정해 줘.처럼 하나씩 나눠 보세요. 마음에 들지 않는 변경은 해당 턴의 되돌리기로 복원할 수 있습니다.

10. 로컬 모델만 설치하면 Node.js나 Python도 필요 없나요?

만들 프로그램에 필요한 실행 환경은 별도로 있어야 합니다. 모델 서버는 AI를 실행하고, Node.js·Python·컴파일러 등은 생성한 프로그램을 실행합니다. 정적 HTML·CSS 페이지는 브라우저로 열 수 있지만, 개발 서버·테스트·패키지를 사용하는 프로젝트는 해당 도구와 의존성을 준비해야 합니다.

패키지를 처음 내려받거나 외부 API를 쓰는 작업에는 인터넷이 필요할 수 있습니다. 로컬 모델을 골랐다는 이유로 실행 환경이나 의존성이 자동으로 준비되지는 않습니다.

11. 클라우드의 큰 코딩 모델과 같은 수준으로 쓸 수 있나요?

같은 결과를 보장하지는 않습니다. 사용하는 모델·양자화·메모리·컨텍스트 길이에 따라 코드 품질과 도구 호출 안정성, 속도가 달라집니다. 작은 모델에는 파일 하나, 변경 하나, 확인 방법 하나를 분명하게 요청하는 편이 좋습니다.

프로젝트 전체를 한 번에 고치게 하기보다 관련 파일을 읽게 한 뒤 작은 변경부터 맡기세요. 필요하면 메모리 여유를 확인해 다른 모델을 시험하고, 에이전트 프리셋에서 쓰지 않는 도구·MCP·긴 지침을 줄여 요청을 단순하게 할 수 있습니다.

오프라인과 데이터

12. 인터넷을 끊어도 계속 코딩할 수 있나요?

LEVEL11·모델 서버·모델 파일과 프로젝트 의존성을 미리 준비했다면, 로컬 대화와 파일 작업은 오프라인으로 할 수 있습니다. 모델·패키지 다운로드, 웹 도구, 외부 MCP, 외부 API, 원격 배포 등에는 네트워크가 필요합니다.

Ollama에서도 다운로드한 로컬 모델을 사용해야 합니다. 클라우드 모델을 선택한 경우에는 내 PC에 Ollama가 설치되어 있어도 오프라인 실행이 아닙니다. Ollama 공식 안내에서도 로컬 모델과 클라우드 모델을 구분합니다.

13. 내 코드가 LEVEL11의 모델 서버로 전송되나요?

로컬 모델의 추론 요청은 설정한 서버 주소로 직접 가며 LEVEL11 모델 게이트웨이를 거치지 않습니다. 내 PC에서 모델을 실행하고 127.0.0.1에 연결하면 그 PC에서 처리합니다. 다른 컴퓨터나 외부 서버의 주소를 넣으면 요청도 그곳으로 갑니다.

웹 도구·MCP·연동은 각 서비스와 별도로 통신합니다. 로컬 모델 선택이 모든 기능의 네트워크 접속을 차단하는 설정은 아닙니다.

막혔을 때

14. 대화는 되는데 파일을 읽거나 수정하지 않아요

먼저 폴더를 열었는지, 파일 수정에는 빌더 모드를 쓰는지 확인합니다. 해당 에이전트 프리셋에서 파일 도구를 꺼 두지 않았는지도 봅니다. 도구 사용이 계속 실패하면 설정 → 로컬 모델 → 도구 호출 방식을 텍스트로 바꿔 저장하고 작은 작업 하나로 시험하세요.

llama.cpp는 네이티브 도구 호출에 --jinja와 도구를 지원하는 채팅 템플릿이 필요합니다. 모델이 호출 형식을 따르지 못하면 다른 모델을 시험해야 할 수 있습니다. 도구 호출 설정을 참고하세요.

15. 너무 느리거나 대화가 잘리면 어떻게 하나요?

첫 답변은 모델을 메모리에 올리느라 오래 걸릴 수 있습니다. 계속 느리면 다른 프로그램의 메모리 사용을 줄이거나 더 작은 양자화 모델·짧은 요청으로 시험합니다. 컨텍스트는 길수록 메모리를 더 사용합니다.

답이 잘리거나 컨텍스트 초과 오류가 나면 서버와 LEVEL11의 컨텍스트 길이가 맞는지, 최대 출력 토큰은 충분한지 확인합니다. 앱의 숫자만 키워서는 서버의 컨텍스트가 늘지 않습니다. 컨텍스트 설정과 문제 해결 표를 보세요.

16. 서버를 끄면 유료 클라우드 모델로 자동 전환되나요?

로컬 모델 요청 실패 때문에 유료 클라우드 모델로 자동 전환되지는 않습니다. 서버를 껐다면 다시 켜고, 주소·포트·모델 이름을 확인한 뒤 요청을 다시 보내세요. 터미널에서 실행한 서버는 창을 닫거나 Ctrl+C를 누르면 멈춥니다.

계속 클라우드 모델이 표시된다면 이 모델 사용 → 저장을 마쳤는지, 대화의 모델 선택과 프리셋의 모델 재정의가 무엇인지 확인하세요. 해결되지 않으면 지원 페이지에 운영체제·메모리·모델 이름·백엔드 버전과 오류 메시지를 남겨 주세요.