문제 해결과 자주 묻는 질문

실패한 동작의 메시지부터 읽고, 프로젝트, 에이전트, 작업 상태를 확인하세요. 아래에서 자주 발생하는 문제의 확인 위치를 안내합니다.

초기 설정에서 작업 공간으로 들어갈 수 없음

초기 설정에서는 에이전트를 하나 이상 설치하고 로그인한 뒤 검증해야 합니다. 설치만 하거나 로그인 창을 닫는 것만으로는 충분하지 않습니다. 목록에 준비됨이 표시되어야 합니다.

해당 에이전트의 상세 정보를 열어 로그인, 네트워크, 검증 문제를 해결한 후 다시 확인하세요. 설치와 준비를 참고하세요.

먼저 네트워크와 시스템 HTTP(S) 프록시를 확인하세요. 프록시 환경 변수가 우선하며, 이 방식은 SOCKS 프록시를 지원하지 않습니다. 다운로드가 데이터 수신을 멈추면 준비 중으로 표시될 수 있습니다. 상태 변화를 확인하고 실패가 보고되면 다시 시도하세요.

실패가 반복되면 에이전트 진단 정보를 복사하고, 런타임 다운로드, 에이전트 설치, 연결 검증 중 어느 단계에서 문제가 발생했는지 기록하세요.

Noea는 검증 결과로 에이전트의 준비 여부를 판단합니다. 계정이나 제공업체, 남은 사용 한도, 모델 설정을 확인하세요. OpenCode는 제공업체 목록을 새로 고치고 연결을 확인한 뒤 다시 검증하세요.

모델 선택에 먼저 연결이 필요하다면 세션을 연결한 후 다시 확인하세요. 한 에이전트가 지원하는 설정을 다른 에이전트도 지원하는 것은 아닙니다.

상황	대처 방법
선택한 폴더가 Noea 프로젝트가 아님.	코드는 구현 폴더 열기를 사용하고, 기존 프로젝트라면 실제 프로젝트 폴더를 선택합니다.
프로젝트 폴더가 이동됨.	기존 Noea 프로젝트 열기로 현재 위치를 선택합니다.
프로젝트 폴더가 삭제됨.	휴지통이나 백업에서 복원한 뒤 다시 엽니다.
설정이 유효하지 않음.	원본 내용을 보존합니다. 설정을 확인하거나 진단 정보를 제출하고, 다시 초기화하여 덮어쓰지 않습니다.
더 최신 앱 버전이 작성한 데이터.	앱을 업데이트한 뒤 다시 엽니다.
데이터 버전이 호환되지 않음.	프로젝트와 앱 데이터의 복사본을 보관한 다음 구체적인 안내를 따릅니다. 호환되지 않는 데이터를 덮어쓰지 않습니다.

설정 → 현재 프로젝트 → 프로젝트에서 구현 폴더를 확인하세요. 연결되지 않았다면 연결하고, 이전 경로에 접근할 수 없다면 원래 코드 폴더의 새 위치를 지정하세요.

에이전트가 준비됨 상태인지도 확인하세요. 의도 파일을 읽을 수 있다고 구현 폴더와 에이전트까지 준비된 것은 아닙니다.

의도를 저장한 다음 관련 단락을 조사하거나 사이드바에서 설명을 실행하세요. 코드 변경이 필요한 요구사항이라면 채팅에서 먼저 구현한 후 조사하세요.

이전 텍스트는 편집 전의 의도를 뜻합니다. 오래되었을 수 있습니다는 근거 파일이 이후에 바뀌었다는 뜻입니다. 둘 다 현재 내용과 비교해 다시 확인하세요. 설명을 최신 상태로 유지하기를 참고하세요.

사이드바의 발견된 변경 사항 없음은 모든 테스트가 통과하거나 부족한 부분이 없다는 뜻이 아닙니다.

설정 → 현재 프로젝트 → 자동화 → 구현 후 자동으로 설명을 확인하세요. 일반 채팅에서 코드만 바꾸거나, 직접 구현을 선택하거나, 구현 실행이 실패 또는 중지되면 자동 실행되지 않습니다.

필요하면 설명을 수동으로 실행하세요. 작업이 끝났지만 실패하거나 미완료된 검사가 남아 있다면 결과를 펼쳐 원인을 해결한 뒤 다시 실행하세요. 전체 자동 실행 조건을 참고하세요.

제안에 문서가 변경되었다고 나오면 현재 버전 기준으로 에이전트에게 다시 제안 요청을 선택하세요. 오래된 정리안에는 다시 정리를 선택합니다.

일반 제안에서는 삽입되거나 대체된 새 텍스트를 편집할 수 있지만, 변경이나 파일을 개별적으로 수락할 수는 없습니다. 정리한 초안은 읽기 전용이며, 삭제 제안 중 유지할 항목을 고른 다음 전체 정리안을 수락할 수 있습니다.

Noea가 메시지를 에이전트에 전달하지 못했다고 알리면 다시 시도할 수 있습니다. 전달되었을 가능성이 있다면 중복 실행을 피하도록 실행 과정과 파일 변경을 먼저 확인하세요.

에이전트가 메시지를 받았지만 작업 중간에 멈췄다면 현재 상태를 확인하고 계속하라는 새 지시를 보내세요. 구현이 끝나지 않음으로 표시된 제안 카드에는 구현 계속하기도 있습니다.

메시지 편집, 채팅 분기, 실행 중지는 파일 변경을 되돌리지 않습니다.

MCP는 연결 테스트를 사용하고 결과에 표시된 명령, URL, 권한 부여, 환경 변수를 확인하세요. 성공한 후에도 채팅에 서버가 선택되어 있는지, 에이전트가 연결 방식을 지원하는지 확인해야 합니다.

MCP 설정 변경에는 에이전트 재연결이 필요합니다. 스킬 추가나 제거에는 새 채팅이 필요합니다. 설명과 정리 작업은 이 확장 기능을 사용하지 않습니다. MCP 서버와 스킬 추가하기를 참고하세요.

저장 충돌은 편집하는 동안 다른 작업이 디스크의 파일을 변경했다는 뜻입니다. 현재 내용을 별도로 저장하거나 디스크 버전을 다시 불러오세요. 다시 불러오면 저장하지 않은 편집은 버려집니다.

참조가 열리지 않으면 파일이나 자료가 여전히 존재하는지, 구현 폴더에 접근할 수 있는지 확인하세요. 오래된 설명이 문서와 맞지 않으면 해당 단락으로 돌아가 최신 설명을 읽고, 필요하면 다시 조사하세요.

사이드바의 피드백에서 목표, 실제 결과, 문제에 이르게 된 단계를 설명하세요. 후속 연락을 받을 이메일을 남기거나 [email protected]으로 문의할 수 있습니다.

진단 정보가 필요하면 설정 → 정보에서 내보내거나 에이전트 상세 패널에서 복사하세요. 로컬 상태와 로그가 포함될 수 있으므로 공유 전에 검토하세요. 피드백은 이 파일을 자동으로 첨부하지 않습니다.