이 가이드는 GEODE를 돌릴 때 자주 만나는 5가지 실패 모드와 1차 진단 위치를 정리합니다.
흔한 실패
| 증상 | 1차 확인 |
|---|---|
| "키가 없어요" 에러 | echo $ANTHROPIC_API_KEY와 ~/.geode/config.toml |
| "context overflow" 종료 | 장기 실행 안전 가이드 |
| "MCP server timeout" | geode /status로 MCP 헬스 확인 |
| 토큰 비용 초과 | 비용 모니터링 + geode /model로 다운그레이드 |
| OAuth 토큰 만료 | OAuth 토큰 회전 |
로그 위치
- Runlog:
~/.geode/runlog/(run 단위 trace) - Hooks: Hook System events
- Serve:
~/.geode/serve.log
지원
해결이 안 되면 GitHub Issues에 runlog 일부와 함께 등록: github.com/mangowhoiscloud/geode/issues