설정과 도움말13 / 16
에이전트, 모델 및 사용량
이 페이지의 내용
에이전트는 프로젝트를 읽고 작업을 수행하며, 모델은 내용을 해석하고 생성합니다. 이 안내에서는 에이전트 관리, 모델 제공업체 연결, 설정 선택, 사용량 확인을 설명합니다. 사용할 수 있는 모델, 로그인 방법, 기능은 선택한 에이전트에 따라 다릅니다.
로컬 에이전트 관리하기
설정 → 에이전트를 여세요. Noea는 현재 Codex, Claude Code, OpenCode, CodeBuddy Code를 제공하며, 각각 버전, 상태, 주요 동작을 표시합니다.
에이전트 행을 클릭하면 설치, 로그인, 확인, 업데이트, 제거를 할 수 있는 상세 패널이 열립니다. 에이전트는 각각 따로 준비됩니다. 패널을 닫아도 이미 진행 중인 준비는 중단되지 않습니다.
준비됨은 검증을 통과했다는 뜻입니다. 설치됨 상태이거나 자격 증명이 감지되었더라도 검증이 필요합니다. 실패하면 상세 패널의 안내를 따르세요. 초기 설정은 설치와 준비를 참고하세요.
모델 제공업체 연결하기
여러 제공업체를 지원하는 에이전트는 상세 패널에 제공업체 목록을 표시합니다. 제공업체를 선택하고 안내에 따라 계정이나 API 키로 연결하세요.
같은 제공업체라도 에이전트별로 따로 연결하고 관리합니다. 로그인과 자격 증명 저장은 에이전트가 처리하며, Noea가 로그인 키를 별도로 저장하지는 않습니다. 다만 에이전트가 인증 데이터를 로컬에 저장할 수는 있습니다.
OpenCode는 사용자 지정 엔드포인트도 제공합니다. 이름, Base URL, 프로토콜, 하나 이상의 모델을 입력해 저장한 뒤 로그인 창에서 자격 증명을 설정하세요. 서비스 API에 맞춰 Chat Completions 또는 Responses를 선택합니다.
제공업체 목록을 읽지 못한 것은 제공업체가 연결되지 않은 것과 다릅니다. 새로 고침으로 현재 연결 상태와 조회 시각을 확인하세요.
현재 채팅 설정하기
입력창 아래 설정 메뉴에서 에이전트, 모델, 추론 강도를 선택합니다. 추론 강도는 모델이 문제에 얼마나 많은 추론을 할지 조절합니다. 모델은 제공업체별로 묶이며, 추론 강도, 계획 모드, 빠른 모드 등의 옵션은 에이전트 지원에 따라 표시됩니다.
새 채팅은 보통 가장 최근에 성공적으로 연결한 일반 채팅의 에이전트를 사용합니다. 첫 메시지 전에는 바꿀 수 있지만, 연결 후에는 바꿀 수 없습니다. 다른 에이전트를 사용하려면 새 채팅을 시작하세요.
일부 모델 목록은 연결한 뒤에만 사용할 수 있으며 인터페이스에서 이를 안내합니다. 에이전트가 옵션을 받아들이지 않으면 적용되지 않고, 채팅에서 이유를 설명합니다.
권한은 입력창의 별도 컨트롤에서 설정합니다. 작업에 맞게 에이전트가 제공하는 옵션 중에서 선택하세요.
프로젝트 동작 설정하기
설정 → 현재 프로젝트 → 동작에서 구현, 설명, 소스 정리 각각의 에이전트, 모델, 추론 강도를 선택하세요.
이 설정은 해당 프로젝트 동작에만 적용되며 모든 일반 채팅에 적용되지는 않습니다. 채팅에서 구현 후 실행되는 설명은 그 채팅의 에이전트를 사용합니다. 정리안을 수락한 뒤의 설명은 프로젝트의 설명 설정을 사용합니다.
선택한 에이전트를 사용할 수 없으면 Noea가 사용 가능한 대안으로 바꾸고 안내합니다. 동작을 실행하기 전에 여기에서 실제로 사용될 선택을 확인하세요.
현재 채팅의 사용량 읽기
입력창 아래의 작은 고리는 컨텍스트 사용량을 보여 줍니다. 클릭하면 컨텍스트, 계정 한도나 잔액, 현재 채팅의 토큰과 비용 정보를 볼 수 있습니다. 토큰은 모델이 텍스트 등의 내용을 처리하는 단위이며, 단어나 글자 수와 같지 않습니다.
컨텍스트 사용량은 모델이 사용할 수 있는 컨텍스트 공간 중 채팅이 차지하는 양입니다. 계정 한도는 제공업체나 에이전트가 부과하는 사용 제한입니다. 서로 다른 항목을 측정합니다.
전체 사용량과 비용 이해하기
설정 → 사용량을 열거나, 사용량 패널에서 전체 사용량 보기 옵션을 선택하세요. 오늘, 최근 7일, 최근 30일, 전체 기간으로 필터링할 수 있습니다. 에이전트를 펼치면 모델과 토큰의 세부 정보가 표시됩니다.
| 정보 | 범위와 의미 |
|---|---|
| 앱 내 사용량 | Noea 안에서 수행한 작업으로 생성된 기록. |
| 계정 한도 | Noea 밖의 사용량도 포함할 수 있으며 기간 필터에 따라 바뀌지 않음. |
| API 정가 환산액 또는 추정액 | 사용 규모를 이해하기 위한 값이며, 실제 구독 청구액이 아님. |
| 크레딧 | 출처별로 따로 표시하며 미국 달러로 취급하지 않음. |
| 가격 미설정 또는 알 수 없음 | 가격이나 측정값이 없는 것이며, 비용이나 사용량이 0이라는 뜻이 아님. |
측정값에는 갱신 시각이 표시됩니다. 새로 고침에 실패하면 이전 값을 유지합니다. 한도 초기화 시각이 지났다면 새로 고침한 후 판단하세요. 에이전트가 계정 한도를 보고할 수 없으면 인터페이스에서 사용할 수 없다고 알립니다.
연결 문제는 문제 해결을, 확장 기능은 MCP 서버와 스킬 추가하기를 참고하세요.