본문으로 건너뛰기

FAQ 및 문제 해결

가장 짧은 진단부터:

anyy --version
anyy config
anyy status
anyy doctor
anyy gateway status

비밀 없이 선택 프로필, 홈, 구성 상태, 상주 런타임, 일반 조치를 확인합니다.

일반 질문​

Anyy는 로컬 모델인가요?​

아닙니다. 상주 비서 런타임이며 구성 원격·호환/로컬 모델을 쓸 수 있지만 모델은 공급자 경로이지 제품 자체가 아닙니다.

로컬 전용인가요?​

표준 프로필 데이터는 로컬이지만 공급자, 웹, MCP, 메시징은 실행 작업에 필요한 데이터를 받습니다. 데이터 및 개인정보를 참조하세요.

프로필·역할·세션의 차이는?​

  • 프로필은 데이터·비밀·구성·런타임 격리.
  • 역할은 프로필 안의 지속 정체성.
  • 세션은 대화와 이력.

계정·신뢰가 섞이면 안 되면 별도 프로필을 쓰세요.

모든 것을 기억하나요?​

아닙니다. 세션별 이력과 프로필 메모리의 지속 사실·선호는 별개입니다. 기능이 있으면 과거를 검색하지만 임시 작업을 자동 메모리로 올려서는 안 됩니다.

세션 하나를 삭제할 수 있나요?​

session.delete RPC는 유휴 세션을 삭제하지만 v0.1.107의 CLI·TUI·Dashboard에는 일반 버튼·명령이 없습니다. 프로필 삭제는 전체 데이터라 대체물이 아닙니다. 세션 작업을 참조하세요.

비용은 얼마인가요?​

Anyy가 공급자 요청을 무료로 만들지는 않습니다. 모델, 추론, 컨텍스트, 미디어, 웹, 통합에 따릅니다. 공급자 가격과 지원 /usage·Dashboard 사용량을 보세요.

설치·업데이트 문제​

anyy를 찾을 수 없음​

새 셸에서 홈·PATH를 확인하세요. 표준 네이티브는 홈 bin/ 아래 바이너리와 권한 허용 시 사용자 진입점을 설치합니다.

오류를 읽고 재실행하세요. 체크섬을 검증하고 제한 릴리스 이력을 유지합니다.

공간 부족​

임시 디렉터리와 홈 둘 다 확보하세요. 롤백 이력 감소를 수락할 때만 ANYY_INSTALL_COMPACT=1입니다.

업데이트 후 Dashboard가 옛 버전​

anyy --version, anyy gateway status, About을 비교하세요. 수동 옛 프로세스가 남을 수 있습니다. 직접 릴리스 삭제 대신 업데이트 조치를 따르세요.

모델·공급자 문제​

모델 검증 불가​

엔드포인트, 프로토콜, ID, 비밀, 네트워크, 계정 한도를 보세요. 한 엔드포인트 이름이 다른 곳에서 유효하다고 가정하지 말고 설치 카탈로그를 쓰세요.

Chat 전송 불가​

Models의 기본 경로를 확인하세요. Test connection은 카탈로그·목록 검사이지 생성이 아닙니다. 저장 후 새 대화에서 짧은 답을 요청하고 대체가 있으면 실제 생성 대상을 확인하세요. anyy status로 Gateway 접근도 보세요.

채팅은 되지만 미디어 불가​

이해·생성·전사·TTS는 독립 경로입니다. 해당 것을 구성·테스트하세요. 텍스트가 음성·이미지를 뜻하지 않습니다. Dashboard는 PNG/JPEG만 이미지, 나머지는 파일이라 오디오·동영상 업로드가 자동 이해는 아닙니다. 미디어 이해를 참조하세요.

추론 변경으로 비용 증가​

캐시 재사용이 무효화될 수 있습니다. 예측이 중요하면 큰 강도·모델 변경 후 새 세션을 쓰세요.

Dashboard·프로필 문제​

URL 열기 불가​

실행:

anyy dashboard --status
anyy status

--no-open으로 현재 URL을 출력하세요. 호스트에서는 This machine, LAN에는 접근 리스너·신뢰 경로가 필요합니다.

CLI와 다른 세션​

About과 anyy config를 비교하고 --profile, --profile-root, --home, ANYY_HOME, ANYY_DEFAULT_HOME, 활성 선택을 확인하세요.

프로필 삭제 불가​

기본·현재·지속 선택이 아니며 중지되어야 합니다. CLI는 --force, 비밀이 있으면 명시 --purge-secrets도 필요합니다.

전환 후 세션 누락​

전환은 데이터 이동이 아닙니다. 원본으로 돌아가 About/config 홈을 확인하세요.

도구·스킬·MCP 문제​

구성됐지만 도구 없음​

Tools, 세션 모음, 백엔드, 새 세션 필요 여부를 보세요. 비밀·상태·범위가 가용성을 결정합니다.

간접 도구는 Codemode, 검색도 보세요. 저장 기본값은 기존 세션을 자동 바꾸지 않습니다.

파일·명령 실패​

결과, 경로·명령, 운영체제 권한·제한을 보세요. 활성 도구는 직접 실행합니다. 확인 질문은 답하거나 중단하세요.

스킬 없음​

현재 프로필·인터페이스 활성 후:

anyy skills reload

다음 프롬프트로 재시도하고 경고를 보세요. 시스템은 사용자처럼 제거·토글 불가입니다. 관리 설치는 로컬 ZIP만입니다. 스킬을 참조하세요.

MCP 연결됐지만 도구 없음​

활성, 현재 제공, 노출, 세션 선택을 보세요. direct는 선언, codemode·deferred는 활성 검색, hidden은 불가입니다. 점검으로 확인하세요. MCP 노출을 참조하세요.

@ 참조 차단​

보호 경로, 바이너리, 비공개 URL, 이탈, 초과, 민감 Git은 거부됩니다. 안전 줄 범위·허용 공개 소스를 쓰세요.

웹 문제​

검색 실패​

Tools·anyy tools websearch에서 공급자·비밀·테스트를 확인하세요. URL도 비공개 네트워크를 막습니다.

메시징 문제​

채널 수신 없음​

doctor, 활성·연결, DM/그룹·페어링을 보세요. 플랫폼에 따라 웹훅·이벤트 구독도 필요합니다.

발신 실패​

바인딩, 계정, 기능, 영수증을 확인하세요. 호출 성공이어도 확인 영수증 없으면 플랫폼 조사가 필요할 수 있습니다.

모르는 사용자가 접근​

계정을 끄거나 정책을 좁히고 권한 취소·노출 비밀 교체·최근 활동 검토를 하세요.

자동화·백그라운드​

Cron 실행 안 됨​

활성, 시간대 일정 해석, 상주 Gateway, 역할·모음을 확인하세요. 생성 대화에서 지금 실행 요청 후 완료 이력·전달을 보세요. 자동화를 참조하세요.

예약 실행 대기​

백그라운드 대화에서 실행·도구·확인 질문을 보고 비밀·전달·상태를 확인하세요.

백그라운드가 사라짐​

Background와 원본 프로필을 보세요. 해당 세션 제어를 쓰며 프로필 변경은 보이는 작업 범위를 바꿉니다.

백업·복구​

대상이 존재함​

새로 생성할, 아직 없는 디렉터리가 필수입니다. 다른 경로를 고르고 실행 프로필에 덮지 마세요.

복원 공급자 인증 불가​

일반은 관리 secrets/·지원 mcp/oauth/가 없습니다. 누락 비밀을 연결하거나 이를 포함한 보호 백업을 쓰세요. 인라인 구성·워크스페이스 비밀은 일반에도 있을 수 있어 모두 비공개로 다룹니다. 백업을 참조하세요.

Doctor 문제가 남음​

실패 점검 조치와 기능별 상태를 따르세요. 로그·번들은 민감 여부 검토 뒤 보관하세요.

여전히 해결되지 않나요?​

최소 재현 증거:

  • About의 버전·커밋.
  • 비공개 홈 부분을 가린 프로필 ID.
  • 정확한 명령·안전 오류 텍스트.
  • 관련 status/doctor 이름.
  • 실패 직전 변경.

토큰 URL, API 키, OAuth 코드, 채널 비밀, 전체 환경, 비공개 메시지, 미검토 백업을 절대 게시하지 마세요.