도움말
eyefeetai는 자체 서버에서 직접 돌리는 LLM 서비스입니다. Eyefeet 통합 계정으로 로그인하면 웹 채팅, 터미널(eye), API, MCP로 같은 모델을 쓸 수 있습니다.
바로가기: 시작하기 · 웹 채팅 · 터미널 (eye) · API · MCP · 사용량과 한도 · 문제 해결
시작하기
| 쓰는 방법 | 로그인 방식 | 이럴 때 |
|---|---|---|
| 웹 채팅 | 통합 계정 로그인 | 브라우저에서 바로 대화할 때 |
터미널 eye | eye login (통합 계정 로그인) | 개발 중인 폴더에서 파일을 같이 보며 대화할 때 |
| API | 개인 API 키 | 내가 만든 프로그램이나 서비스에서 호출할 때 |
| MCP | 개인 API 키 | Claude Code 같은 MCP 클라이언트에서 도구로 쓸 때 |
웹 채팅
- 위쪽 드롭다운에서 모델을 고릅니다. 대화는 왼쪽 목록에 저장되고, 이름을 바꾸거나 지울 수 있습니다.
- 답변이 나오는 중에는 ■ 중지로 멈출 수 있고, 답변 중에도 다음 메시지를 미리 써 두면 대기열에 쌓여 순서대로 보내집니다(지금 보내기로 바로 보낼 수도 있음).
- 모델의 생각 과정이 있으면 접어서 보여 줍니다. 답변의 마크다운(제목, 표, 코드 등)은 서식으로 표시됩니다.
- 왼쪽 아래에 최근 사용량이 표시됩니다. 웹 채팅과
eye가 같은 한도를 함께 씁니다. - 이 서버는 한 번에 처리할 수 있는 대화 수가 제한적이라, 사용자가 몰리면 응답이 늦어질 수 있습니다.
- 작업 폴더: 위쪽 작업 폴더 버튼으로 패널을 열고 내 컴퓨터의 폴더를 연결하면, AI가 그 폴더의 파일을 읽고 새로 만들거나 고칠 수 있습니다. 파일을 쓰기 전에는 변경 내용을 미리 보고 모두 적용을 눌러야 하며, 거절할 수도 있습니다. 내 GitSalt 저장소는 패널에서 받기(clone), Pull, 커밋, Push를 할 수 있습니다(Eyefeet Cloud에 GitSalt가 연결되어 있어야 하고, 인증은 서버가 대신 처리합니다). Chrome·Edge에서만 되고, 폴더는 이 브라우저 안에서만 읽고 씁니다(AI가 읽은 파일 내용은 대화로 서버에 전달됩니다).
터미널에서 쓰기 (eye)
설치하면 터미널에서 eye만 입력해 바로 대화할 수 있습니다. 어떤 리눅스든 python3(3.8 이상)가 있으면 한 줄로 설치됩니다.
Ubuntu/Debian이라면 apt로도 설치할 수 있습니다(업데이트 자동 반영). 특정 버전을 설치하려면 EYE_VERSION=버전을 앞에 붙입니다.
apt를 쓰지 않으면 스크립트를 직접 받아서 /usr/local/bin에 넣어도 됩니다.
| 명령 | 설명 |
|---|---|
eye login | 브라우저에서 통합 계정 로그인. API 키를 직접 넣을 필요가 없습니다 (구독형) |
eye | 대화 시작. 여러 줄은 줄 끝에 \, 종료는 /exit 또는 Ctrl-D |
eye "질문" | 한 번만 묻고 답을 출력 |
cat 파일 | eye "요약해줘" | 파이프로 받은 내용을 함께 전달 (이때 출력은 원문 마크다운) |
eye -c / eye -r | 이 폴더의 마지막 대화 이어가기 / 목록에서 골라 이어가기 |
eye -m nemotron-3.5, eye models | 모델 지정 / 채팅용 모델 목록 (--all은 전부) |
eye usage, eye --version | 최근 사용량과 한도 / 설치된 eye 버전 |
!명령 (대화 중) | 이 폴더에서 터미널 명령을 직접 실행합니다 (예: !git status). 출력이 바로 보이고, 결과는 다음 질문에 함께 전달되어 "방금 결과 보고 알려줘"처럼 물을 수 있습니다. 이것과 별개로, 모델이 스스로 명령을 실행하는 기능은 아래 행을 보세요. |
모델의 명령 실행 (run_command) | 모델이 git status, git diff, git log 같은 읽기 명령은 바로 실행하고, 파일을 바꾸거나 그 밖의 명령(git add/commit/push, 설치, 스크립트 실행 등)은 명령 전체를 보여 주고 y를 눌러야 실행됩니다. 확인 창에서 a를 누르면 자동 승인 모드가 켜져, 이번 실행 동안 파일 수정·거부 목록 외의 모든 명령·Eyefeet Cloud 변경 작업(생성·배포 등)을 다음 대화에서도 묻지 않고 진행합니다(실행되는 내용은 매번 화면에 표시되고, 대화 중 /commands ask로 다시 매번 확인으로 되돌릴 수 있습니다. 저장되지 않아 다음 실행에서는 다시 묻습니다). Eyefeet Cloud의 삭제·초기화·중지 같은 작업은 자동 승인 모드에서도 계속 확인합니다. sudo, 광범위한 삭제, 디스크 포맷 같은 명령은 승인으로도 실행하지 않습니다. 터미널이 아닐 때(스크립트)는 읽기 명령만 실행됩니다. 명령은 작업 폴더에서 60초 안에 끝나야 하고 입력은 받지 않으며, eye의 로그인 정보는 전달되지 않습니다. 끄려면 --no-commands 또는 EYE_NO_COMMANDS=1. |
| 작업 중 입력 (대기열) | eye가 일하는 동안에도 입력할 수 있습니다. 그냥 입력하면 대기열에 쌓였다가 지금 작업이 끝나면 한꺼번에 하나의 메시지로 전달됩니다(여러 개면 번호를 붙여서). /queue로 대기열을 보고 /queue clear로 지웁니다. Ctrl-C로 작업을 멈추면 대기열은 자동으로 보내지 않고 남겨 두며, 엔터(빈 입력)를 치면 그때 보냅니다. |
| 전체 화면 모드 (기본) | 대화 모드는 기본으로 위쪽은 스크롤되는 대화, 아래쪽은 고정된 입력창과 상태줄인 전체 화면으로 열립니다(쓸 수 없는 터미널이면 자동으로 기존 줄 단위 방식으로 열립니다). 기존 방식으로 쓰려면 eye --cli, 항상 그렇게 쓰려면 환경변수 EYE_TUI=0을 설정하세요. 작업 중 쌓인 대기열이 패널로 보이고 각 메시지의 [지금 보내기] [삭제] 버튼을 마우스로 클릭할 수 있으며, 도구/명령 승인도 [y 실행] [a 모두 자동 승인] [n 거절] 버튼으로 누를 수 있습니다(키보드 y/a/n도 됩니다). 마우스 휠과 PgUp/PgDn으로 대화를 스크롤하고, F2(또는 /mouse on|off)로 마우스 모드를 끌 수 있습니다. 마우스 모드가 켜져 있으면 글자를 드래그해 복사하려면 Shift를 누른 채로 드래그하거나 마우스 모드를 끄세요. 엔터=보내기, Alt-엔터 또는 Ctrl-J=줄바꿈, ↑/↓=입력 기록, Tab=/명령 완성, Ctrl-C=중단(입력 중이면 입력 지우기), Ctrl-D=종료. 종료하면 화면이 사라지지만 대화는 저장되어 eye -c로 이어갈 수 있습니다. |
/now 메시지 (지금 보내기) | 작업 중에 /now 메시지를 입력하면 하던 응답이나 도구 실행(실행 중인 명령 포함)을 멈추고 그 메시지에 먼저 답한 뒤, 중단했던 원래 작업을 이어서 계속합니다. 중단된 동안의 대화는 모델에게 그대로 전달되므로 "아까 그 파일 말고 다른 걸로"처럼 방향을 바꾸는 메시지도 반영됩니다. 이미 대기열에 쌓인 메시지를 지금 보내려면 /now만 입력하세요. 작업 중이 아닐 때의 /now 메시지는 그냥 보내기와 같습니다. 작업 중에는 일반 메시지, /now, /queue만 쓸 수 있고 다른 명령은 작업이 끝난 뒤에 입력하세요. 터미널 종류에 따라 입력한 글자가 출력 사이에 섞여 보일 수 있지만 입력 내용 자체는 정상적으로 전달됩니다. |
/compact, /reset, /files, /usage | 대화 중 명령: 대화 요약해 줄이기 / 새 대화 / 파일 접근 켜기·끄기 / 사용량 |
--no-files, --raw, --no-save | 파일 접근 끄기 / 마크다운 변환 없이 원문 출력 / 대화 저장 안 함 |
작업 폴더: eye를 실행한 폴더가 작업 폴더가 되어, 모델이 그 안의 파일을 읽고 검색할 수 있습니다. 파일을 만들거나 고칠 때는 변경 내용을 보여 주고 승인을 받습니다. 폴더 밖, .git, .env 같은 민감한 파일은 접근할 수 없고, 홈/루트에서는 기본으로 꺼집니다. 이미지, PDF, 압축 파일, docx/xlsx 같은 바이너리 파일은 내용을 해석하지는 못하지만, 모델이 파일 형식과 크기를 확인하고 16진수 덤프나 안에 든 문자열(한글, UTF-16 포함)을 볼 수 있습니다. docx/xlsx/zip은 안에 든 파일 목록도 보여 줍니다.
대화 이어가기: 대화는 그 PC에 저장됩니다. 대화가 길어지면 오래된 내용을 자동으로 요약해 줄입니다.
출력 모양: 터미널에서는 마크다운을 읽기 좋은 서식으로 바꿔 보여 줍니다. 색을 끄려면 NO_COLOR=1, 원문을 보려면 --raw를 쓰세요.
API로 사용하기
OpenAI 호환 API라서, OpenAI 라이브러리나 도구에 주소와 키만 바꿔 넣으면 됩니다. 키는 로그인한 뒤 왼쪽 API 키 메뉴에서 직접 발급합니다(키는 발급 직후 한 번만 보이니 바로 복사해 두세요).
| Base URL | |
|---|---|
| 인증 | Authorization: Bearer <발급받은 키> |
| 채팅 모델 | |
| 임베딩 모델 | bge-m3 (/embeddings용, 채팅에는 쓰지 않음) |
| 엔드포인트 | POST /chat/completions · POST /embeddings · GET /models |
curl
스트리밍 (글자가 나오는 대로 받기)
Python (openai 라이브러리)
JavaScript (Node 18+, fetch)
임베딩
응답의 message에는 답과 함께 reasoning_content(생각 과정)가 올 수 있습니다. 필요 없으면 content만 사용하세요. 쓸 수 있는 요청 필드는 model, messages, stream, temperature, top_p, max_tokens, tools 등 일반적인 것들입니다.
MCP로 사용하기
MCP를 지원하는 앱(Claude Code 등)에 이 서버를 등록하면, 앱이 ask_local_llm 도구로 이 서비스의 모델을 호출합니다. 인증에는 개인 API 키를 씁니다(eye login으로 받은 로그인 토큰은 쓸 수 없음).
| 주소 | (streamable-http) |
|---|---|
| 헤더 | Authorization: Bearer <발급받은 키> |
| 도구 | ask_local_llm(prompt, model) — 프롬프트를 모델에 보내고 답을 돌려줍니다. model은 생략하면 기본 모델입니다. |
Claude Code에 등록
설정 파일(JSON)로 등록
앱에서 "도구 목록"에 ask_local_llm이 보이면 연결된 것입니다. 호출한 내용은 API와 같은 키별 한도에 포함됩니다.
사용량과 한도
구독형 (웹 채팅, eye login) | API형 (API 키, MCP) | |
|---|---|---|
| 인증 | 통합 계정 로그인 | 개인 API 키 |
| 한도 기준 | 계정 하나당, 최근 몇 시간 동안 쓴 토큰 합계 (웹과 eye가 공유) | 키마다 분당 요청 수와 토큰 수 |
| 한도 초과 | 잠시 뒤 다시 사용 가능하다는 안내와 함께 거절 | HTTP 429 (Retry-After 헤더 확인) |
| 관리 | "API 키" 화면의 "로그인된 기기"에서 로그아웃 | "API 키" 화면에서 키 폐기 (만들 수 있는 개수에 제한이 있음) |
구체적인 한도 값은 운영 상황에 따라 바뀔 수 있습니다. 현재 사용량은 웹 왼쪽 아래나 eye usage에서 확인하세요.
문제 해결
| 증상 | 원인과 해결 |
|---|---|
| "Loading model" 또는 503 | 서버가 모델을 올리는 중입니다(재시작 후 약 5분). 잠시 뒤 다시 시도하세요. |
| 401 (로그인/키 오류) | 키가 없거나 폐기되었습니다. API는 키를 다시 발급하고, eye는 eye login을 다시 하세요. |
| 429 (한도 초과) | 안내된 시간 뒤에 다시 사용하세요. 프로그램에서는 Retry-After만큼 기다렸다가 재시도하면 됩니다. |
| 답이 안 나오고 계속 도구만 부르는 것 같음 | 도구 호출 횟수에는 기본적으로 제한이 없습니다. 오래 걸리면 Ctrl-C로 언제든 멈출 수 있습니다(실행 중인 명령도 함께 종료). 모델이 같은 호출만 3번 넘게 반복하면 더 실행하지 않고, 계속되면 지금까지 확인한 내용으로 답하게 합니다. 횟수를 제한하고 싶으면 EYE_MAX_STEPS=50처럼 설정하세요(그 횟수마다 "계속할까요?"라고 묻고, 멈추면 지금까지의 내용으로 답합니다). 사용량 한도는 도구를 많이 쓸수록 빨리 소진되니 eye usage로 확인하세요. |
| 400 + "context" | 대화나 입력이 모델이 한 번에 읽을 수 있는 길이를 넘었습니다. 입력을 줄이거나 새 대화를 시작하세요(eye는 자동으로 요약해 줄입니다). |
eye: command not found | 설치 직후라면 새 터미널을 열거나 hash -r을 실행하세요. which -a eye로 설치 위치도 확인해 보세요. |
eye login에서 브라우저가 안 열림 | 터미널에 표시된 주소를 직접 열어 통합 계정 로그인 후 승인하세요(표시된 확인 코드와 같은지 확인). |
| 로그인된 기기 수 초과 | "API 키" 화면의 "로그인된 기기"에서 안 쓰는 기기를 로그아웃하세요. |
터미널 로그인
터미널에 표시된 코드와 같은지 확인하고 승인하세요. 승인하면 eye-cli 이름의 개인 키가 만들어져 터미널에 저장됩니다.
다른 프로그램에서 OpenAI 호환 API로 사용할 수 있는 개인 키입니다. 키는 발급 직후 한 번만 표시됩니다.
| 이름 | 키 | 발급일 |
|---|
사용 예시
로그인된 기기 (eye)
터미널에서 eye login으로 로그인한 기기입니다. API 키와 달리 계정 사용량 한도(웹 채팅과 공유)가 적용됩니다.
| 기기 | 로그인 | 마지막 사용 |
|---|
Eyefeet Cloud 연동
보통은 채팅에서 "Eyefeet Cloud에 배포하고 싶어"라고 말하면 이미 발급된 키를 자동으로 연결하고, 없으면 발급할지 물어봅니다. 직접 등록하려면 Eyefeet Cloud의 MCP 키를 넣으세요. 등록하면 채팅에서 테넌트 조회·생성·배포를 바로 처리할 수 있습니다. 키는 Eyefeet Cloud 우측 상단 계정 메뉴의 MCP에서 발급하며, 본인 테넌트에만 접근할 수 있습니다. 생성·수정·삭제 같은 변경 작업은 실행 전에 확인 창이 뜹니다.