초에 이전 Codex와 Claude 코드 세션을 찾고, 어떤 세션이 가장 많은 토큰을 소모했는지 확인하세요.
ccost는 로컬 AI 코딩 세션 로그를 검색 가능한 터미널 UI로 변환하며 비용 티어를 제공합니다. 이를 사용하여 과거의 프롬프트를 복원하고 비싼 실행을 검사하며 어떤 세션, 모델, 웹 검색 호출이 비용을 발생시켰는지 이해하세요.
codex-cost-demo.mov
brew install --cask peterxcli/tap/ccost ccost
왜 사용해야 할까요?
- 버그를 수정했거나 API를 탐색했거나 유용한 오류를 만났던 세션을 찾으세요.
- 예상 비용, 토큰, 시간, 모델, 웹 검색, 세션 ID 또는 첫 번째 프롬프트로 세션을 정렬하세요.
- 프롬프트, 경로, 스택 추적 또는 소스 컨텍스트를 업로드하지 않고 Codex와 Claude Code 로그를 브라우즈하세요.
- 변경된 파일만 인덱싱하여 지속적으로 검색 인덱스를 유지하여 시작 속도를 빠르게 유지하세요.
지원 소스
| 소스 | 기본 경로 |
|---|---|
| 코덱 | $CODEX_HOME/sessions또는 ~/.codex/sessions일 때 CODEX_HOME이 설정되지 않은 경우 |
| 클로드 코드 | ~/.claude/projects |
| 커스텀 JSONL 디렉토리 | ccost --sessions /path/to/jsonl/sessions |
설치
brew install --cask peterxcli/tap/ccost
업그레이드:
brew update brew upgrade --cask ccost
기타 설치 경로는 로드맵에 있습니다:
cargo install ccostcargo binstall ccost- 리눅스 릴리스 아티팩트
- 쉘 설치 스크립트
실행
기본 Codex 세션 디렉토리를 엽니다:
ccost
명시적으로 소스를 선택하십시오:
ccost --codex ccost --claude
사용자 지정 세션 디렉토리를 사용하십시오:
ccost --sessions /path/to/jsonl/sessions
...때에 사용하십시오
오래된 수정을 찾으십시오
JWT refresh에 대해 Codex 또는 Claude Code에 물었던 기억이 있지만, 그것이 프로젝트나 세션에 있었던 것은 기억하지 못합니다.
/을 누르고, 입력하십시오:
JWT refresh
비싼 세션 찾기
비용으로 정렬하여 가장 많은 예상 지출을 사용한 세션이 무엇인지 확인
누르세요:
s
정렬이cost될 때까지
웹 검색이 많이 사용된 세션 검토
검색 호출이 예상 지출에 기여한 세션 찾기 위해 웹 검색으로 정렬
개인 정보 보호
ccost는 로컬 우선입니다.
- API 키가 필요 없음
- 텔레메트리 없음
- 네트워크 호출 없음
- 업로드 없음
- 세션 JSONL 파일이 진실의 출처로 남아 있습니다
- 캐시 파일은 폐기 대상이며 로컬에 저장됩니다
캐시 형식의 이탈 또는 손상이 감지되면 TUI에서 표시된 캐시 폴더를 삭제하세요. 원래 세션 로그는 수정되지 않습니다.
기능
- 로컬 세션 로그 전체 검색.
- 접두사 일치, 일치 강조 및 표시된 검색 커서.
- 총 비용, 시간, 토큰, 웹 검색, 모델, 세션 ID 또는 첫 번째 프롬프트에 따른 비용 의식 정렬.
- Codex와 Claude Code 기본값, plus custom JSONL 세션 디렉토리.
- 내장 가격표와 로컬 JSON 재정의 지원.
- 선택 사항
--no-web-cost토큰 전용 추정 모드. - 단일 작성자 캐시 락으로 읽기 전용 및 강제 쓰기 탈출구.
왜 빠른가.
- Rust 터미널 UI.
- 영구 저장된 전체 텍스트 인덱스.
- FST 터미널 인덱스로 압축된 접두사 검색.
- 지속된 Merkle 트리와 파일 모니터, 그래서 변경되지 않은 세션은 재사용되고 변경된 세션 파일은 점진적으로 재색인됩니다.
제어
| 키 | 작업 |
|---|---|
/ |
검색 모드 입력 |
Enter |
브라우징 모드로 돌아가거나, 브라우징 중 상세 정보를 전환 |
Up / Down 또는 j / k |
선택 이동 |
Tab |
스위치 목록/세부 정보 초점 |
s |
다음 정렬 키 |
S |
정렬 방향 반전 |
r |
새로 고침 |
Esc |
검색 지우기 또는 뒤로 가기 |
q |
종료 |
옵션
ccost [--codex | --claude | --sessions PATH] [--pricing PATH] [--no-web-cost] [--read-only-index] [--force-index]
--codex: 기본 Codex 세션 디렉토리 열기.--claude: 기본 Claude Code 프로젝트 트랜스크립트 디렉토리 열기.--sessions PATH: 사용자 정의 Codex 또는 Claude Code 세션 디렉토리를 열어 JSONL 파일을 포함합니다.--pricing PATH: 로컬 가격 설정 JSON 오버라이드를 로드합니다.--no-web-cost: 추정치에서 웹 검색 호출 비용을 비활성화합니다.--read-only-index: 지속된 검색 캐시를 작성하지 않고 열습니다.--force-index: 잠금 없이 작성합니다. 다른 TUI가 실행 중이지 않은 것을 확인한 후에만 사용합니다.
Pricing
비용은 지역 세션 로그에 있는 토큰 사용량과 모델 데이터를 기반으로 한 추정치입니다. 내장 가격에는 GPT-5.5, GPT-5.4, Claude Opus/Sonnet/Haiku 모델 패밀리 및 웹 검색 기본값이 포함됩니다. 로컬 테이블을 --pricing pricing.json로 덮어씁니다.
{
"web_search_per_1k": 10.0,
"models": {
"gpt-5.5": {
"input_per_m": 5.0,
"cache_creation_input_per_m": 0.0,
"cached_input_per_m": 0.5,
"output_per_m": 30.0,
"long_context_threshold": 272000,
"long_context_input_multiplier": 2.0,
"long_context_output_multiplier": 1.5
},
"gpt-5.4": {
"input_per_m": 2.5,
"cache_creation_input_per_m": 0.0,
"cached_input_per_m": 0.25,
"output_per_m": 15.0,
"long_context_threshold": 272000,
"long_context_input_multiplier": 2.0,
"long_context_output_multiplier": 1.5
},
"claude-sonnet-4-5": {
"input_per_m": 3.0,
"cache_creation_input_per_m": 3.75,
"cached_input_per_m": 0.30,
"output_per_m": 15.0
}
}
}구형 가격 덮어쓰기에 대해서는 long_context_multiplier이 여전히 인정되며 입력/출력 특정 필드가 생략될 때 모든 토큰 클래스에 적용됩니다.cache_creation_input_per_m는 선택 사항이며 기본값은 0.0입니다.
Benchmarks
Benchmark 숫자는 증명으로 사용되기 전에 명명된 기계와 재현 가능한 데이터 세트에서 측정되어야 합니다. docs/github-launch.md에 있는 발사 체크리스트에는 해당 숫자가 사용 가능해지면 채워야 할 표가 포함되어 있습니다.
이것은 어떻게 다릅니까?
| Tool | 쏠림 |
|---|---|
ccusage |
많은 에이전트에 대한 토큰 및 비용 사용 보고서 |
| CodeBurn | AI 코딩 도구를 위한 비용 관찰 대시보드 |
ccost |
Codex와 Claude Code 세션을 검색하고 탐색하기 위한 빠른 로컬 TUI, 비용을 고려한 정렬 |
로드맵
- 정적 README 스크린샷, 정제된 데이터
- GitHub 사회적 미리보기 이미지
-
cargo install ccost - Linux 릴리스 아티팩트
- 데모 피치 또는
ccost --demo - JSON/CSVЭкспорт
- 프로젝트 수준 비용 요약
- 커서, OpenCode, Gemini CLI 및 Goose 로그 지원
- 설정 가능한 테마
- CI에서의 벤치마크
기여
기여는 환영합니다, 특히 새로운 로그 소스와Экспорт 형식에 대한 것입니다. CONTRIBUTING.md를 참조하세요.
만약 ccost가 과거 세션을 복구하거나 토큰이 어디로 갔는지 이해하는 데 도움이 되었다면, 별표를 표시하여 유지보수가 가치 있다는 것을 알릴 수 있습니다.











