이 가이드는 OAuth 기반 인증을 사용하는 경우의 토큰 갱신 정책을 정리합니다.
중요한 정책
Anthropic Claude Pro/Max OAuth 토큰은 third-party harness에서 사용 불가입니다 (2026-01-09 ToS). GEODE는 해당 토큰을 읽지 않습니다. 대신 Anthropic API 키 (Console)를 사용하세요.
Codex OAuth (gpt-5.5 구독)
# 토큰 등록 (CLI 대화형) codex login # 토큰 위치 ~/.codex/auth.json
자동 갱신
GEODE는 만료 임박을 감지하면 refresh token으로 자동 갱신. 실패 시 OAUTH_REFRESH_FAILED hook 발생.
수동 재인증
codex login # 새 토큰 발급 geode /clean # 캐시 비우기 geode serve & # 재기동
참조: wiki/concepts/geode-oauth-policy.md, Auth and OAuth reference