---
slug: faq
title: "자주 겪는 문제 (FAQ)"
description: "기대한 기억이 안 보일 때, 저장이 안 될 때, 검색이 엉뚱할 때: 순서대로 확인하는 법."
lang: ko
---


# 10. 자주 겪는 문제 (FAQ)

## 저장했는데 기억이 안 보여요

데이터 소실을 가정하기 전에, 순서대로 확인한다.

1. **저장 대상이 맞나?** 저장 대상 확인 도구로 지금 계정·팀·프로젝트를 확인한다.
   다른 브라우저 세션으로 **다른 계정**에 붙었거나, **다른 프로젝트**로 전환돼
   있을 수 있다. 저장할 때와 검색할 때의 대상이 같아야 한다.
2. **검색 범위 안인가?** 검색 범위는 서버가 정한다("내 팀에서 읽을 수 있는 것"이
   상한). 응답의 `searched_scope`를 본다. → [검색하기](searching).
3. **정말 저장됐나?** `ak` 명령 없이 말했다면 저장이 **안 된** 것이다. →
   [저장하기](saving).

대부분은 소실이 아니라 **대상 불일치**다. → [팀과 프로젝트](teams-and-projects).

## "일시적으로 사용 불가 / 연결이 리셋됨" 오류가 나요

서버리스 DB의 **콜드 스타트**일 수 있다(유휴 상태에서 처음 붙을 때). 몇 초 뒤
다시 호출하면 자동 재연결된다. 반복되면 잠시 후 재시도.

## ChatGPT에서 커넥터를 지웠다 다시 넣었더니 도구가 안 보여요

**예전 연결 상태가 캐시로 남아** 새로 추가한 커넥터가 안 붙는 경우가 있다. 순서대로
확인한다.

1. **ChatGPT를 완전히 재시작한다.** 창만 닫지 말고 앱을 종료했다 다시 켠다. 인증
   실패 상태가 캐시돼 새 값을 재시도하지 않는 사례가 실제로 있었다. 재시작이나
   커넥터 제거 후 재추가로 풀린다.
2. **새 대화에서 커넥터를 켰는지 본다.** ChatGPT는 커넥터를 **대화마다** 켜야 한다.
   입력창의 **+** 를 눌러 AiAkiv를 고르거나, 플러그인 창의 **‘채팅에서 사용해 보기’**
   로 시작한다. 설정에 저장돼 있어도 새 대화는 꺼진 채로 시작한다.
3. **그래도 안 되면 `.codex/config.toml`을 확인한다.** **ChatGPT 앱**은
   **계정 커넥터를 그대로 상속**받는데(`codex_apps`), 지웠다 다시 넣는 과정에서 로컬
   설정에 **꺼짐 상태가 남아 있을 수 있다.**

   - 먼저 **ChatGPT에게 앱 ID를 물어본다**: "이 앱의 app id를 알려줘".
   - **사용자 폴더의 `.codex/config.toml`** 을 연다(예: `~/.codex/config.toml`,
     Windows는 `C:\Users\<이름>\.codex\config.toml`).
   - 받은 **앱 ID 항목이 `enabled = false`로 꺼져 있지 않은지** 확인한다.
     꺼져 있으면 **`true`로 바꾸거나 그 줄을 지우고** 다시 시작한다.

> **관련 주의.** 폴더에 로컬 MCP 설정(`[mcp_servers]`)을 함께 두는 것 자체는
> 괜찮다. 다만 **이름을 계정 커넥터와 다르게** 등록해야 한다. 전역 `AiAkiv`,
> 폴더 `AiAkiv-proj` 처럼. 이름이 같으면 어느 쪽이 쓰였는지 알 수 없다 →
> [ChatGPT 연결](chatgpt).

## 저장이 안 돼요

AiAkiv는 **`ak` 명시 명령이 있을 때만** 저장한다. 그냥 "저장해줘" / "기억해둬" 로는
저장되지 않는다(실수 저장 방지). "ak 저장해줘: ..."로 다시 시도. →
[저장하기](saving).

## 저장 대상을 바꾸고 싶어요

**콘솔에서 사람이 직접** 바꾼다. 어떤 도구도 대상(Main)을 바꾸지 못한다(하이재킹
방지). 저장 대상 확인 도구나 프로젝트 목록 도구가 주는 `switch_url`을 클릭한다.
→ [팀과 프로젝트](teams-and-projects).

## 검색 결과가 엉뚱하거나 오래된 것 같아요

- **요약을 그대로 믿지 마라.** 요약은 LLM 생성물이라 드물게 부정확하다. 정확한
  내용은 **원문 조회**로 확인한다.
- **연결을 따라가라.** hit의 reason과 연결 지도(hint)를 읽으면, 이름이 바뀐
  동의어나 이어지는 조각을 찾을 수 있다. → [검색하기](searching).
- 충돌하는 정보는 **최신순**으로 판단한다.

## 같은 대상인데 검색에서 두 개로 갈라져 나와요

엔티티 이름이 흔들렸을 가능성이 크다("세이브 포맷" vs "저장 형식"). **엔티티 한
이름 원칙**을 지켜 저장하면 하나로 엮인다. → [저장하기](saving).

## 저장한 걸 고치고 싶어요

**다시 저장하지 마라. 같은 내용이 두 벌이 된다.** 방법은 둘이다.

- **엔티티·태그·이어붙임이 틀렸다** → "ak 아까 저장한 거 태그 고쳐줘". **원문은 못
  고친다**: 원문을 바꿔야 하면 폐기하고 다시 저장한다.
- **그 기억이 아예 안 나왔으면 좋겠다** → "ak 방금 저장한 거 폐기해줘".

자세한 것은 [저장하기](saving)의 *저장한 뒤 고치기*.

## 개인정보·비밀을 저장해버렸어요

애초에 안 넣는 게 최선이다([무엇을 저장하나](what-to-store)의
저장 금지 목록).

이미 저장했다면 **폐기**해서 회수에서 뺀다("ak 방금 저장한 거 폐기해줘"). 다만
**정확히 알고 있어야 할 것이 있다.**

> **폐기는 삭제가 아니다.** 검색·회수에서 빠질 뿐 **데이터는 남는다.** 그리고 기억
> 하나를 물리적으로 지우는 길은 사용자에게 없다. 원본까지 사라지는 것은 **팀 삭제**와
> **회원 탈퇴**뿐이다(콘솔 → 위험 구역).

그래서 유출이 걱정되는 값이라면 폐기로 끝내지 말고, **그 값 자체를 무효화**해야 한다.
API 키·토큰이면 발급처에서 **재발급**하고, 비밀번호면 **바꾼다**. 기억에서 안 보이게
하는 것과 그 비밀이 여전히 유효한 것은 별개의 문제다.

## 더 알아보기

- 체험으로 → [tour](https://www.aiakiv.com/tour)
- 클라이언트 연결 레시피 → [playbook](https://www.aiakiv.com/playbook?lang=ko)
- 용어가 헷갈릴 때 → 콘솔 **참고 → 도움말**. 단어를 넣으면 바로 걸러 보여준다
  ([콘솔 안내](console))