Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# AgentsView로 코딩 에이전트 세션 하나를 점검하기

> AgentsView에서 알고 있는 로컬 코딩 에이전트 대화 기록을 찾고, 기록된 토큰과 비용의 출처를 확인한 뒤 추정치를 청구서로 취급하지 않으면서 범위를 한정한 일별 보고서를 읽는다.

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

AgentsView는 여러 도구의 코딩 에이전트 세션 로그를 검색 가능한 하나의 로컬 아카이브에 모을 수 있다. 이 안내서는 알고 있는 작업 하나를 찾고, 에이전트가 실제로 기록한 사용량 필드를 살펴보며, 비용 수치의 출처를 확인해야 하는 엔지니어링 책임자를 위한 것이다.

이 절차는 2026년 10월 9일 AgentsView v0.45.0 릴리스와 현재의 빠른 시작 및 토큰 사용량 안내서를 바탕으로 하며, 문서는 10월 17일 확인했다. BIG CHANGE는 AgentsView를 설치하거나 대화 기록을 가져오거나 이 단계를 시험하지 않았다. 문서와 릴리스 목록은 달라질 수 있으므로 설치한 버전을 확인하자.

## 시작하기 전에

읽을 권한이 있는 완료된 코딩 에이전트 세션, 해당 작업의 특징적인 문구 또는 세션 ID, 로컬 로그 디렉터리를 읽을 권한이 필요하다. [Quick Start](https://www.agentsview.io/docs/quickstart/)에는 macOS, Windows, Linux용 데스크톱 다운로드와 Linux x86\_64 및 aarch64, macOS x86\_64 및 arm64, Windows x86\_64 및 arm64용 CLI wheel이 나열되어 있다. 데스크톱 앱은 번들로 제공되지만 소스 빌드는 Go, Node, CGO의 별도 요구사항이 있다. 빠른 시작 문서상 기본적인 로컬 아카이빙에는 호스팅 계정이나 API 키가 필요하지 않다.

세션 로그에는 프롬프트, 소스 코드, 도구 입력, 비밀 정보가 들어 있을 수 있다. 팀이 검토를 허용한 디렉터리만 선택하자. 아카이브가 수집할 공급자와 루트 디렉터리를 **최초 실행 전에** 결정하자. 옵션 없이 `agentsview serve`를 실행하면 지원하는 기본 소스를 즉시 발견하고 동기화한다. 이 실습에서는 웹 UI를 문서에 명시된 루프백 주소로 유지하자. 이 질문에 답하기 위해 호스팅 원시 데이터 동기화, PostgreSQL 또는 ClickHouse로 보내기, Gist 게시, 생성된 인사이트, 호스팅 임베딩 엔드포인트를 켜지 말자. 의미 기반 검색은 선택 사항이며 일반적인 전문 검색은 로컬 인덱스로 작동한다.

## 1. 설치하고 실행 파일 확인하기

다음 [설치 안내서](https://www.agentsview.io/docs/quickstart/)에서 방법 하나를 고르자. 독립형 CLI의 영구 Python 설치 방법은 문서상 다음과 같다.

```sh
pip install agentsview
agentsview --version
```

안내서는 또한 `uvx agentsview`를 통한 영구 설치 없는 실행, 플랫폼별 설치 도구, 데스크톱 패키지를 제공한다. macOS의 Homebrew cask는 앱에 포함된 CLI를 연결한다. DMG로 설치한 앱은 CLI 디렉터리를 `PATH`에 추가해야 할 수 있다. 버전을 신뢰하기 전에 셸이 어떤 실행 파일을 찾는지 확인하자. GitHub는 [v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0)을 10월 9일 릴리스로 표시하지만, 화면과 보고서 스키마를 해석할 때는 직접 확인한 `--version` 결과를 사용하자.

## 2. 첫 동기화 전에 소스 제한하기

호스트 CLI 또는 데스크톱 설치에서는 새 데이터 디렉터리와 그 안의 `config.toml` **파일을 먼저** 준비한 다음 AgentsView를 시작하자. [설정 안내서](https://www.agentsview.io/docs/configuration/#disabling-session-providers)는 `disabled_agents`로 로컬 파일시스템 공급자를 제외하고 `[agents.<id>].dirs`로 공급자 하나의 기본 루트를 바꾸는 방법을 설명한다. 해당 안내서의 **다른 모든 공급자 ID**를 [Session Discovery 표](https://www.agentsview.io/docs/configuration/#session-discovery)에서 확인해 `disabled_agents`에 나열하고, 승인된 단 하나의 공급자의 `dirs`를 허용된 루트로 설정하자. 예를 들어 `[agents.codex]`에 `dirs = ["/approved/codex/sessions"]`를 설정하면 Codex의 기본 디렉터리를 교체한다. 경로는 자신의 시스템에 맞추자. 전체 제외 목록을 갖추지 못했다면 아직 호스트 데몬을 시작하지 말자. `CODEX_SESSIONS_DIR` 또는 `CLAUDE_PROJECTS_DIR` 하나를 재정의하면 그 공급자의 루트만 바뀌며 다른 공급자의 기본 자동 발견은 여전히 가능하다.

기존 아카이브에 관련 없는 세션이 이미 있을 수 있다면 이 점검에는 새로운 `AGENTSVIEW_DATA_DIR`를 사용하자. 설정 안내서에 따르면 비활성화한 공급자의 이전 보관 세션도 계속 이용할 수 있으므로 설정 변경이 옛 아카이브를 비우지는 않는다. 또한 `disabled_agents`는 로컬 발견과 감시에만 적용되고 원격 가져오기나 내보내기에는 적용되지 않는다. 이 로컬 작업에서는 원격 호스트와 내보내기 대상을 설정하지 말자.

다른 모든 공급자의 제외 목록을 유지하기 어렵다면 격리된 컨테이너가 대안이다. [Quick Start의 Docker 예제](https://www.agentsview.io/docs/quickstart/#docker)는 UI를 `127.0.0.1`에만 공개하고, 에이전트 소스를 읽기 전용으로 마운트하며 별도 데이터 볼륨을 사용한다. **승인된 소스 루트만** 마운트하고 새 컨테이너 안에 그에 맞는 디렉터리 변수를 설정하자. [프로젝트의 Compose 예제](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml)에 있는 다른 마운트는 제외하자. 컨테이너에서는 명시적으로 마운트한 호스트 세션 디렉터리만 보인다. 공개 Docker 이미지는 Linux amd64와 arm64를 지원하며 이 방법에는 작동하는 Docker 설치가 필요하다.

## 3. 로컬 아카이브 만들기

범위를 제한한 호스트 CLI에서는 문서의 포그라운드 서버를 시작하자.

```sh
agentsview serve
```

2단계에서 소스 범위를 적용하고 확인한 뒤 이 명령은 `~/.agentsview/sessions.db` 또는 선택한 데이터 디렉터리를 초기화하고, 활성화한 에이전트 로그를 발견·동기화하고 변경을 감시하며 `http://127.0.0.1:8080`을 연다. 해당 터미널을 열어 두자. 백그라운드 프로세스를 원하면 `agentsview daemon start`와 `agentsview daemon status`를 사용하자. 데스크톱 앱은 자체 백엔드를 관리한다. 호환되는 서버가 이미 실행 중이면 URL만 알려줄 수도 있으므로, 새 설정이 수집을 통제했다고 가정하기 전에 실행 중인 데몬이 있는지 확인하자.

격리된 컨테이너를 선택했다면 읽기 전용 소스 마운트 하나와 새 데이터 볼륨을 확인한 후 문서의 Docker 명령으로 시작하자. 컨테이너의 루프백 UI를 쓰고 이후 `agentsview` CLI 보고서도 그 컨테이너 안에서 실행해 같은 아카이브를 읽도록 하자. 소스 범위를 제한하지 않은 호스트 `serve`를 동시에 실행하지 말자.

알고 있는 작업의 소스가 나타나고 의도하지 않은 공급자는 나타나지 않는지 확인하자. 세션이 없다면 세션이 존재하지 않는다고 결론짓기 전에 승인된 경로, 공급자 설정, 동기화 상태를 살펴보자. 보고서 작성 전에 새로 바뀐 파일을 반영해야 한다면 `agentsview sync`를 실행하자. 서버도 변경을 감시한다. 전체 재동기화 전에는 설정한 범위를 다시 확인하자.

## 4. 작업을 찾고 대화 기록 검증하기

웹 UI에서 `Ctrl/Cmd+K`로 알고 있는 작업의 특징적인 문구를 그대로 검색하자. 프로젝트, 에이전트, 날짜로 목록을 좁히고 후보를 열어 메시지와 도구 호출을 확인하자. 전체 세션 ID나 UUID를 알고 있다면 `Ctrl/Cmd+G`로 바로 열 수 있다. 이 조작 방법은 [Quick Start](https://www.agentsview.io/docs/quickstart/)에 설명되어 있다. 사용량 결과를 올바른 대화와 연결할 수 있도록 에이전트, 세션 ID, 날짜를 기록하자.

문구 검색으로 작업을 찾지 못하면 더 짧은 문구를 시도하고, 원래 에이전트가 AgentsView에서 읽을 수 있는 디렉터리에 로컬 대화 기록을 썼는지 확인하자. 원격 서비스, 지원하지 않는 형식, 설정한 루트 밖의 디렉터리에만 있는 작업은 검색을 더 한다고 복구되지 않는다. 로컬 소스가 없을 때의 일상적인 해결책으로 의미 기반 인덱싱이나 대화 기록 업로드를 켜지 말자.

## 5. 세션의 사용량 필드 살펴보기

찾은 세션의 사용량 보기를 열어 기록된 모델, 입력, 출력, 캐시 생성, 캐시 읽기 필드 중 존재하는 항목을 확인하자. [토큰 사용량 안내서](https://www.agentsview.io/docs/token-usage/)는 비용 보고를 **실험적이며 아직 발전 중**이라고 설명한다. AgentsView는 원본 로그에서 모델과 토큰 메타데이터를 가져오고 메시지 행에 원시 토큰 사용량을 보관한다. 소스가 명시한 비용이 있으면 이를 사용하고, 없으면 사용 가능한 토큰과 모델 요금으로 비용을 계산한다. JSON의 출처 표시는 이를 `reported`, `computed` 또는 `mixed`로 구분한다.

해당 세션 하나의 기계 판독 가능한 기록을 저장하려면 [프로젝트의 CLI 예제](https://www.agentsview.io/)에 나오는 `agentsview session usage SESSION_ID --format json`을 사용하자. `SESSION_ID`를 대화 기록에서 검증한 ID로 바꾸고 JSON을 작업 메모와 함께 보관하자. 총액을 인용하기 전에 출력에 표시된 모델, 토큰 분류, 비용 출처를 확인하자.

빈 필드나 누락된 모델은 알 수 없음으로 취급하자. AgentsView는 에이전트가 기록하지 않은 사용량을 재구성할 수 없다. 릴리스 노트에 따르면 Junie CLI 수집은 IDE에만 있는 대화와 도구 호출을 제외하며, Antigravity 일반 텍스트 대체 경로에는 대화 내용만 있고 토큰 사용량이나 비용은 없다. 검색 가능한 세션이라도 완전한 지출 수치가 없을 수 있는 구체적인 사례다. 소스가 보고한 금액이 세션 총액을 나타내더라도 모델별 배분은 여전히 추정치일 수 있다.

## 6. 일별 보고서 범위 한정하기

Usage 페이지의 날짜, 프로젝트, 에이전트 필터로 세션이 속한 날을 확인하자. 이 페이지에는 개별 대화 기록으로 연결되는 Top Sessions by Cost 표도 있다. 감사 가능한 터미널 보고서를 위해 다음 명령에서 세션의 현지 날짜와 에이전트 이름을 바꾸자.

```sh
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown
```

일별 표는 캐시되지 않은 입력, 출력, 캐시 생성, 캐시 읽기를 구분하며 `--breakdown`을 설정하면 모델별 행을 표시한다. 날짜는 `--timezone`을 지정하지 않으면 시스템 시간대에 따라 묶인다. 하루 총액에는 같은 에이전트의 다른 세션도 포함될 수 있다. 이는 범위와 규모를 확인하는 수치이며 한 작업의 비용은 아니다. 일별 보고서에 세션 ID를 함께 남기고 실제로 해당하는 행을 확인하자.

가격 카탈로그를 가져오지 않고 보고하려면 `--offline`을 추가하자. AgentsView에 따르면 이 옵션은 소스 동기화나 데몬 시작 없이 기존 아카이브를 읽고 내장된 대체 가격을 사용한다. 최근 세션 변경이 중요하면 먼저 아카이브를 갱신하자. 오프라인 보고서는 새 로그를 발견할 수 없다. 일반 사용량 명령은 LiteLLM과 OpenRouter 가격을 가져올 수 있지만 내장 카탈로그는 설치한 릴리스와 함께 오래되어 간다.

## 7. 수치를 해석하고 서비스 중지하기

각 수치에 출처에 맞는 표시를 하자. `Computed`는 AgentsView가 기록된 토큰에 선택한 요금을 곱했다는 뜻이다. `Reported`는 소스가 명시적인 비용을 제공했다는 뜻이다. `Mixed`는 여러 종류가 섞인 보고서라는 뜻이다. 소스가 보고한 수치도 제공자의 계정 전체 청구서가 대조·정산되었다는 증거는 아니다. 특히 서비스 등급, 할인, 구독 할당량이 중요할 때는 해당 제공자의 실제 청구 또는 요금제 기록을 별도로 비교하자. AgentsView 문서에 따르면 저장된 사용량에 등급이 없으면 Batch, Flex, Priority, 지역별 요금, 한 시간 캐시 요금을 추론할 수 없다. 일부 도구 측 토큰은 로컬 대화 기록에 없다.

성공 확인 기준은 에이전트, ID, 날짜가 선택한 사용량 보기와 일치하는 대화 기록을 찾고, 있는 모델·토큰 필드는 기록하며 없는 필드는 알 수 없음으로 표시하는 것이다. 결과물은 검색 가능한 로컬 아카이브와 범위를 한정한 작업·일별 사용량 메모이며 청구서가 아니다. 포그라운드 `agentsview serve`는 `Ctrl+C`로 중지하고, 백그라운드 서버는 `agentsview daemon stop`으로 중지하자. [Quick Start](https://www.agentsview.io/docs/quickstart/)에 따르면 데몬을 중지하면 웹 UI와 세션 감시도 함께 중지된다.

## 큰 변화

로컬 대화 기록은 비용 논의에 추적 가능한 출발점을 제공한다. 엔지니어링 책임자는 수치를 특정 기록 작업까지 거슬러 확인하고 그것이 에이전트에서 왔는지 가격 카탈로그에서 왔는지 볼 수 있다. 로그가 불완전하다면 보고서도 그 공백을 그대로 남겨야 한다.

## 출처 및 더 읽을거리

- [AgentsView v0.45.0 릴리스 노트](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0): 에이전트 지원 범위, Usage 카드, 동기화, 가격 동작에 관한 날짜가 명시된 변경 사항이다. 릴리스 노트는 공급업체의 기록이며 BIG CHANGE의 시험 결과가 아니다.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/): 지원 설치 방법, 서버·데몬 명령, 소스 설정, 로컬 검색 조작 방법.
- [AgentsView 설정](https://www.agentsview.io/docs/configuration/): 소스 발견, 공급자 제외, 아카이브 위치, 해당 설정의 한계.
- [AgentsView 토큰 사용량 및 비용](https://www.agentsview.io/docs/token-usage/): 소스 지원 범위, 사용량 보고서, 가격 출처, 오프라인 모드, 알려진 보고 한계.
- [AgentsView 저장소](https://github.com/kenn-io/agentsview): 소스 코드와 MIT 라이선스. 저장소는 기본 아카이브를 로컬로 설명한다.

## Sources

- [AgentsView v0.45.0 릴리스 노트](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — 날짜가 명시된 릴리스 및 기능·지원 범위 변경.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — 설치, 실행, 소스 선택, 검색 조작 방법.
- [AgentsView 설정](https://www.agentsview.io/docs/configuration/) — 소스 발견, 공급자 제외, 데이터 디렉터리, 설정의 한계.
- [AgentsView 토큰 사용량 및 비용](https://www.agentsview.io/docs/token-usage/) — 실험적 사용량 보고, 가격 출처, 한계.
- [AgentsView 소스 저장소](https://github.com/kenn-io/agentsview) — 소스, 프로젝트 설명, MIT 라이선스.