A 403 verification_required API error now shows a dedicated message to users, with telemetry for when it and its link are shown
What
Claude Code now recognizes a specific kind of 403 error response from the API: one whose body indicates error.type: 'permission_error' with details.error_code: 'verification_required'. Instead of falling through to a generic error message, this is turned into a distinct verification_required error result that shows the server-provided message directly to the user.
Two new telemetry events, tengu_ranch_rc_shown and tengu_ranch_rc_link_shown, were added and fire when this verification-required message (and, separately, its link) are shown. The tengu_ranch_rc_shown event only fires the first time this happens.
Why
This gives users a clear, specific explanation when their account or request needs verification, instead of a generic error, and lets Claude Code track how often users encounter this situation.