Claude Code භාවිත සීමා ගැටලුව හඳුනාගෙන නව නිවේදන විසඳුම

Claude Code සඳහා දිගු කාලීන කාර්යයක් ධාවනය කරන විට, එය නිමාවට පත් වන විට, මැදිහත් වීමක් අවශ්‍ය වීම, හෝ දෝෂයක් ඇති වීමේදී ටෙලිග්‍රෑම් මඟින් මට දැනුම්දෙන claude-code-notify නම් කුඩා මෙවලමක් මම පළමුව ලියලා තිබුණා.

කෙසේ වෙතත්, සේවා ගණනාවක් එකවර නවතා දමන භාවිත සීමා (usage limit) සිදු වූ විට, එම මෙවලම සාමාන්‍ය දෝෂ පණිවුඩයක් පමණක් එවයි. එය ‘error’ ලෙස පෙන්වුවත්, සීමාවක් හේතුවෙන් නතර වුණාද, එය කවදා නැවත ක්‍රියාත්මක වෙනවාද යන තොරතුරු කිසිදා නොලැබේ. ඒ නිසා, පරිශීලකයා පසුතැවීමෙන් පසු සීමාව ඉවත් වූ කාලය තේරුම් ගැනීමට නොහැකි වුණා.

මෙම අස්ථිරතාවය සංවර්ධකයින්ගේ කාලය බොහෝමයක් වැය කරනවා. ඔබේ AI වැඩසටහනක් දිගු කාලයක් ධාවනය වෙද්දී, සීමාව ඉක්මවා ගිය පසු එය නැවත ආරම්භ කළ හැකි වේලාව නොදැනීම, වැඩි පරික්ෂණයක්, අහිමි ව්‍යාපාරික අවස්ථා, සහ අධික තණ්හා තැනීමට හේතුවක්.

ගැටලුවේ මූලික හේතුව ‘transcript’ ගොනුවේ ලේඛනය පරීක්ෂා කරන වේලාවේ, Claude Code ඒ ගොනුවට rate‑limit තොරතුරු ලියීමට තව කාලයක් ගතවීමයි. මගේ හුක් (hook) ගොනුව කියවීමට 19.7 මිලි තත්පර පෙර ලැබූ නිසා, එහි rate‑limit envelope එකක් නොතිබුණා. ඒ නිසා, පද්ධතිය සීමාවක් නොවන බව තීරණය කර, සාමාන්‍ය error පණිවුඩයක් පමණක් එවයි.

මෙම race condition විසඳීමට මූලික විසඳුම සරලයි: ගොනුව පළමුව කියවා හිස් වුණා නම්, 200 ms පසු නැවත කියවන්න. _STOP_FAILURE_RETRY_DELAYS = (0.2,) ලෙස සකස් කිරීමෙන්, ලියන ක්‍රියාව සම්පූර්ණ වීමට අවශ්‍ය කාලය ලබා දී, සීමාවට අදාළ නිවේදනය සාර්ථකව එවිය හැකි වුණා. අලුත් සංස්කරණය පසුගිය සතියේ තවත් සීමා දෙකක් හමුවේ පරීක්ෂා කරන විට, නිවැරදි “limit reached” පණිවුඩය සහ reset පණිවුඩය දෙකම ලැබුණු අතර, පුරාතන දෝෂ පණිවුඩය පමණක් නොවීය.

ශ්‍රී ලංකාවට ඇති වැදගත්කම

• සිසුන්ට AI සහ API භාවිතය අධ්‍යයනයේදී, සීමා ගැන තත්කාලික දැනුම්දීමක් ලැබීමෙන් වැඩ කාලය ඉතිරි වේ.
• දෙපාර්ශවික සංවර්ධකයින්ට, සේවා අඩුපාඩු නිසා ව්‍යාපාරික ප්‍රතිලාභ අහිමි නොවීමේ අවස්ථාව ලැබේ.
• ව්‍යාපාරිකයන්ට, ක්ලවුඩ්‑අධාරිත AI සේවා භාවිතයේ පාරිභෝගික සේවාවන් නියමිත වේලාවක ලබා දීමේ විශ්වාසය වැඩිවේ.
• දේශීය තාක්ෂණික ප්‍රජාවට, මෙවැනි open‑source උපකරණයන්ගෙන් ඉගෙන ගැනීමට, තමන්ගේ workflow එකේ නිවැරදි notification පද්ධති නිර්මාණය කිරීමේ හැකියාව ලැබේ.

අවසානයේ, සරල retry logic එකක් පමණක් යොදා ගෙන, Claude Code හි භාවිත සීමා ගැන නිවැරදිව දැනුම් දීමේ ගැටලුව සාර්ථකව විසඳා ඇත. මෙය තාක්ෂණික කාර්යයන්හි “race condition” ගැටලුවලට සැලකිල්ලක් දක්වමින්, පරිශීලක‑මිතුරුවලට වැඩි විශ්වාසයක් ලබා දේ.