๋ณธ๋ฌธ์œผ๋กœ ๊ฑด๋„ˆ๋›ฐ๊ธฐ

Claude Sonnet 5.5 API ํŠœํ† ๋ฆฌ์–ผ: ์กฐ์ •(Reconciliation) ์—์ด์ „ํŠธ ๊ตฌ์ถ•

Python์—์„œ Claude Sonnet 5.5 API๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ํ•™์Šตํ•˜์„ธ์š”. ๋Œ€ํ™” ๋„์ค‘ ์“ฐ๊ธฐ ๊ถŒํ•œ์„ ํš๋“ํ•˜๋Š” ์กฐ์ • ์—์ด์ „ํŠธ๋ฅผ ๊ตฌ์ถ•ํ•˜๊ณ , ๋” ๋†’์€ effort๊ฐ€ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ”๊พธ๋Š”์ง€ ํ…Œ์ŠคํŠธํ•ฉ๋‹ˆ๋‹ค.
ยท 15๋ถ„ ์ฝ๊ธฐ

AI์™€ ํƒํ—˜ํ•ด ๋ณด์„ธ์š”

๋งค๋‹ฌ ์žฌ๋ฌด ํŒ€์€ ์žฅ๋ถ€ ๊ธฐ๋ก์ด ์‹ค์ œ ์€ํ–‰์— ์ž…๊ธˆ๋œ ๊ธˆ์•ก๊ณผ ์ผ์น˜ํ•˜๋Š”์ง€ ํ™•์ธํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๋งค์ถœ์—์„œ ํ™˜๋ถˆ๊ณผ ์นด๋“œ ๊ฒฐ์ œ ๋Œ€ํ–‰ ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ๋บ€ ๊ฐ’์ด ์˜ˆ๊ธˆ์•ก๊ณผ ๊ฐ™์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ด ๊ฒ€์‚ฌ๋ฅผ ์กฐ์ •(reconciliation)์ด๋ผ๊ณ  ํ•˜๋ฉฐ, ์ˆซ์ž๊ฐ€ ๋งž์ง€ ์•Š์œผ๋ฉด ๋ˆ„๊ตฐ๊ฐ€๊ฐ€ ๊ธฐ๋ก์„ ์ƒ…์ƒ…์ด ์‚ดํŽด ์›์ธ์„ ์ฐพ์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ด ํŠœํ† ๋ฆฌ์–ผ์—์„œ๋Š” ๊ทธ ์ผ์„ Claude Sonnet 5.5์—๊ฒŒ ๋งก๊ธฐ๊ณ  Python์œผ๋กœ AI ์—์ด์ „ํŠธ๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ ์—์ด์ „ํŠธ๋Š” ํ™˜๋ถˆ ์กฐํšŒ ํ•จ์ˆ˜ ๊ฐ™์€ ๋„๊ตฌ๋ฅผ Claude๊ฐ€ ํ˜ธ์ถœํ•˜๊ณ , ๊ทธ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ”ํƒ•์œผ๋กœ ๋‹ค์Œ์— ๋ฌด์—‡์„ ํ™•์ธํ• ์ง€ ์Šค์Šค๋กœ ๊ฒฐ์ •ํ•˜๋Š” ํ”„๋กœ๊ทธ๋žจ์„ ๋œปํ•ฉ๋‹ˆ๋‹ค. ํ…Œ์ŠคํŠธ ์‚ฌ๋ก€๋Š” ๊ฐ€์ƒ์˜ ๊ตฌ๋…์‚ฌ Rivermark์ด๋ฉฐ, ์ด ํšŒ์‚ฌ์˜ 9์›” ์ˆ˜์น˜๊ฐ€ ๋งž์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์–ด๋ ค์šด ์ ์€ ์‹ ๋ขฐ์ž…๋‹ˆ๋‹ค. Claude๋Š” ๋ชจ๋“  ๊ธฐ๋ก์„ ๋ณผ ์ˆ˜ ์žˆ์–ด์•ผ ํ•˜์ง€๋งŒ, ์„ค๋ช…์ด ๊ฒ€์ฆ๋˜๊ธฐ ์ „๊นŒ์ง€ ์žฅ๋ถ€๋ฅผ ๋ฐ”๊ฟ”์„œ๋Š” ์•ˆ ๋ฉ๋‹ˆ๋‹ค. ๊ทธ๋ž˜์„œ Claude๋Š” ์ฒ˜์Œ์— ์ฝ๊ธฐ๋งŒ ๊ฐ€๋Šฅํ•œ ๋„๊ตฌ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ์ˆ˜์ •์•ˆ์„ ์ œ์•ˆํ•˜๋ฉด Python์ด ๋จผ์ € ๊ทผ๊ฑฐ๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๊ทธ ๋’ค์—์•ผ Claude๋Š” ์›๋ณธ ๋ฐ์ดํ„ฐ๋Š” ์†๋Œ€์ง€ ์•Š์€ ์ฑ„, ๊ทธ ํ•œ ๊ฑด์˜ ์ˆ˜์ •๋งŒ ๋ณ„๋„ ๋ชฉ๋ก์— ๊ธฐ๋กํ•˜๋Š” ๋„๊ตฌ๋ฅผ ๋ถ€์—ฌ๋ฐ›์Šต๋‹ˆ๋‹ค. ๋งˆ์ง€๋ง‰์œผ๋กœ Python์ด Claude ๋„๊ตฌ ๋ฐ–์— ์žˆ๋Š” ์€ํ–‰ ๊ธฐ๋ก๊ณผ ๊ฒฐ๊ณผ๋ฅผ ๋Œ€์กฐํ•ฉ๋‹ˆ๋‹ค.

์ œ๊ฐ€ ๊ถ๊ธˆํ–ˆ๋˜ ์ ์€ ์ด ๊ตฌ์„ฑ์ด ๊ทธ๋Ÿด๋“ฏํ•ด ๋ณด์ด๋Š” ์‹ค์ˆ˜๋ฅผ ์žก์•„๋‚ผ ์ˆ˜ ์žˆ๋А๋ƒ์˜€์Šต๋‹ˆ๋‹ค. ๋‹ค์Œ ๋‚ด์šฉ์„ ๋‹ค๋ฃน๋‹ˆ๋‹ค:

  • Python์—์„œ ์ฒซ Claude Sonnet 5.5 API ํ˜ธ์ถœ ๋งŒ๋“ค๊ธฐ
  • ๊ธฐ๋ก์€ ์ฝ์„ ์ˆ˜ ์žˆ์ง€๋งŒ ๋ณ€๊ฒฝ์€ ๋ชป ํ•˜๊ฒŒ ํ•˜๋Š” ๋„๊ตฌ ์ œ๊ณตํ•˜๊ธฐ
  • Claude๊ฐ€ ์“ฐ๊ธฐ ์ „์— Python์—์„œ ์ œ์•ˆ๋œ ์ˆ˜์ •์„ ๊ฒ€์ฆํ•˜๊ธฐ
  • ๋Œ€ํ™” ์ค‘๊ฐ„ ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€๋กœ ๋„๊ตฌ๋ฅผ ์ƒˆ๋กœ ๋ถ€์—ฌํ•˜๊ธฐ
  • ํ›„์† ๋‹จ๊ณ„์—์„œ Claude์˜ effort ๋ณ€๊ฒฝํ•˜๊ธฐ
  • ์ตœ์ข… ์ˆ˜์น˜๋ฅผ Python์—์„œ ํ™•์ธํ•˜๊ณ  ๊ฐ API ํ˜ธ์ถœ ๋น„์šฉ ๊ณ„์‚ฐํ•˜๊ธฐ

์š”์•ฝ

์ค‘๊ฐ„ effort์—์„œ Claude Sonnet 5.5๋Š” ์ž˜๋ชป๋œ ๋‹ฌ์— ๋ฐ˜์˜๋œ $149.00 ํ™˜๋ถˆ์„ ์ฐพ์•„๋ƒˆ์ง€๋งŒ, ์นด๋“œ ํ”„๋กœ์„ธ์„œ๊ฐ€ ๊ฐ€์ ธ๊ฐ„ ๋ณ„๋„์˜ $15.00 ์ˆ˜์ˆ˜๋ฃŒ๋Š” ๋†“์ณค์Šต๋‹ˆ๋‹ค. Python์˜ ์ตœ์ข… ๊ฒ€์‚ฌ์—์„œ ํ•ฉ๊ณ„๊ฐ€ ์—ฌ์ „ํžˆ ๋งž์ง€ ์•Š๋Š” ๊ฒƒ์œผ๋กœ ๋‚˜ํƒ€๋‚˜์ž, Claude๋Š” ๊ฐ™์€ ๋Œ€ํ™”์—์„œ ์กฐ์‚ฌ๋ฅผ ์ด์–ด๊ฐ€ ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ์ฐพ์•„ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.

  • Claude๋Š” ๋†“์นœ ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ์ด๋ฏธ ๋ณธ ์ƒํƒœ์˜€์Šต๋‹ˆ๋‹ค. ๋ถ„์Ÿ ๊ฒฐ์ œ ๋‘ ๊ฑด์„ ๋ชจ๋‘ ์—ด์–ด๋ดค์ง€๋งŒ, $15.00 ์ˆ˜์ˆ˜๋ฃŒ๊ฐ€ ์ด๋ฏธ ๋ฐ˜์˜๋๋‹ค๊ณ  ํŒ๋‹จํ–ˆ์Šต๋‹ˆ๋‹ค.

  • Python์ด Claude์˜ ์“ฐ๊ธฐ ์‹œ์ ์„ ๊ฒฐ์ •ํ–ˆ์Šต๋‹ˆ๋‹ค. ์ˆ˜์ • ๊ธฐ๋ก ๋„๊ตฌ๋Š” Claude์˜ ์ œ์•ˆ์ด Python ๊ฒ€์ฆ์„ ํ†ต๊ณผํ•  ๋•Œ๊นŒ์ง€ ์ˆจ๊ฒจ์กŒ๊ณ , 4๊ฑด ์ค‘ 2๊ฑด์˜ ์ œ์•ˆ์ด ๊ฑฐ์ ˆ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

  • ๋„๊ตฌ์™€ effort๋ฅผ ๋ฐ”๊ฟ”๋„ ๋Œ€ํ™”๋Š” ์ดˆ๊ธฐํ™”๋˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. ์ด์ „์— ์ž‘์„ฑ๋œ ๋‚ด์šฉ์ด ๊ทธ๋Œ€๋กœ์—ฌ์„œ, 118,308๊ฐœ ์ž…๋ ฅ ํ† ํฐ ์ค‘ 89.3%๊ฐ€ ํ”„๋กฌํ”„ํŠธ ์บ์‹œ์—์„œ ์ฝํ˜”๊ณ  ๋” ๋‚ฎ์€ ์š”๊ธˆ์ด ์ ์šฉ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

  • ๋Œ€์‘ ์žฌ์‹คํ–‰์—์„œ ๋” ๋†’์€ effort๋Š” ํ•„์š”ํ•˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. ๊ฐ™์€ ์‹คํŒจ ์ง€์ ์—์„œ ์‹œ์ž‘ํ•œ ๋ณ„๋„์˜ ์žฌ์‹คํ–‰๋„ medium์„ ์œ ์ง€ํ–ˆ๊ณ , Python์˜ ๊ฐ™์€ ๋ฉ”์‹œ์ง€ ์ดํ›„ ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ์ฐพ์•„๋ƒˆ์Šต๋‹ˆ๋‹ค.

  • ์ฃผ์š” ์กฐ์ • ๊ณผ์ •์€ medium์—์„œ high๋กœ ์ „ํ™˜ํ–ˆ์Šต๋‹ˆ๋‹ค. ์ด 15ํšŒ API ํ˜ธ์ถœ์— $0.1190๊ฐ€ ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค. ๋Œ€์‘ ์žฌ์‹คํ–‰์€ ๋ณ„๊ฐœ์ž…๋‹ˆ๋‹ค.

์ด ์ˆ˜์น˜๋Š” ๊ฐ€์ƒ์˜ ๋ฐ์ดํ„ฐ์…‹ ํ•˜๋‚˜์— ๋Œ€ํ•œ ๊ฒฐ๊ณผ์ž…๋‹ˆ๋‹ค. ๋ฒค์น˜๋งˆํฌ๊ฐ€ ์•„๋‹ˆ๋ผ, ์ž์ฒด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ ๊ฒ€์ฆํ•  ๋™์ž‘์œผ๋กœ ๋ณด์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.

Claude Sonnet 5.5๋ž€?

Claude Sonnet 5.5๋Š” Anthropic์˜ Claude 5.5 ์ œํ’ˆ๊ตฐ์— ์†ํ•ฉ๋‹ˆ๋‹ค. ์ด ํ”„๋กœ์ ํŠธ๋ฅผ ์‹œ์ž‘ํ•  ๋ฌด๋ ต ๋ง‰ ๊ณต๊ฐœ๋˜์—ˆ๊ณ , API ๋ชจ๋ธ ID๋Š” claude-sonnet-5-5์ž…๋‹ˆ๋‹ค. ๋ชจ๋ธ ๊ฐœ์š”(model overview)์— ๋”ฐ๋ฅด๋ฉด, 100๋งŒ ํ† ํฐ ์ปจํ…์ŠคํŠธ ์œˆ๋„์šฐ, ์ตœ๋Œ€ 128K ์ถœ๋ ฅ ํ† ํฐ, ๊ธฐ๋ณธ ํ™œ์„ฑํ™”๋œ ์ ์‘ํ˜• ์‚ฌ๊ณ (adaptive thinking), API ๊ธฐ๋ณธ effort๋Š” high์ž…๋‹ˆ๋‹ค. ํ‘œ์ค€ ์š”๊ธˆ์€ ์ž…๋ ฅ ํ† ํฐ ๋ฐฑ๋งŒ ๊ฐœ๋‹น $2, ์ถœ๋ ฅ ํ† ํฐ ๋ฐฑ๋งŒ ๊ฐœ๋‹น $10์ž…๋‹ˆ๋‹ค.

์ €ํฌ์˜ Claude Sonnet 5.5 ๊ฐœ์š”์—์„œ๋Š” ๋ฒค์น˜๋งˆํฌ, ์š”๊ธˆ ๋น„๊ต, ์ ‘๊ทผ ๋ฐฉ๋ฒ•์„ ๋‹ค๋ฃน๋‹ˆ๋‹ค. ์ด ๋ฆด๋ฆฌ์Šค์—์„œ ์ƒˆ๋กœ ์ถ”๊ฐ€๋œ API ๊ธฐ๋Šฅ์ด ์„ธ ๊ฐ€์ง€ ์žˆ์œผ๋ฉฐ, Rivermark๋Š” ์ด ๋ชจ๋‘๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

Claude Sonnet 5.5 API์˜ ์ƒˆ๋กœ์šด ์ ์€?

Claude Sonnet 5.5๋Š” ๋Œ€ํ™” ๋„์ค‘์—๋„ ํ๋ฆ„์„ ๋ฐ”๊ฟ€ ์ˆ˜ ์žˆ๋Š” ์„ธ ๊ฐ€์ง€ ๋ฐฉ๋ฒ•์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. What's new in Claude Sonnet 5.5์— ๋”ฐ๋ฅด๋ฉด, ์ด ๊ธฐ๋Šฅ์€ Claude Sonnet 5์—์„œ๋Š” ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค:

  • ๋ฉ”์‹œ์ง€๋ณ„ effort: ์ดํ›„ ํ„ด์—์„œ์˜ ์ถ”๋ก  ๊ฐ•๋„๋ฅผ ์กฐ์ ˆํ•ฉ๋‹ˆ๋‹ค.
  • ๋Œ€ํ™” ์ค‘๊ฐ„ ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€: ์ค‘๊ฐ„์— ์‹œ์Šคํ…œ ์ง€์‹œ๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.
  • ๋Œ€ํ™” ์ค‘๊ฐ„ ๋„๊ตฌ ๋ณ€๊ฒฝ: ์„ ์–ธ๋œ ๋„๊ตฌ๋ฅผ ์ค‘๊ฐ„์— ๋ณด์ด๊ฑฐ๋‚˜ ์ˆจ๊น๋‹ˆ๋‹ค.

Claude Sonnet 5.5 API๋กœ ๋ฌด์—‡์„ ๋งŒ๋“ค๊นŒ์š”?

Rivermark ์—์ด์ „ํŠธ๋Š” ๋‘ ๊ฐ€์ง€ ๊ถŒํ•œ ์ˆ˜์ค€์„ ๊ฐ€์ง„ ๋‹จ์ผ Messages API ๋Œ€ํ™”๋ฅผ ์ค‘์‹ฌ์œผ๋กœ ํ•˜๋Š” Python ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค. ์กฐ์‚ฌ ๋‹จ๊ณ„์—์„œ๋Š” Claude๊ฐ€ ์ฃผ๋ฌธ, ํ™˜๋ถˆ, ํ”„๋กœ์„ธ์„œ ๊ฑฐ๋ž˜, ๋งˆ๊ฐ ์ •์ฑ…, Rivermark์˜ ์กฐ์ • ๊ฒ€์‚ฌ๋ฅผ ์ฝ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์Šน์ธ ํ›„์—๋Š” ์Šน์ธ๋œ ์กฐ์ •๋งŒ ๊ธฐ๋กํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Rivermark๋Š” Claude Agent SDK ๋Œ€์‹  ์‚ฌ์šฉ์ž ์ง€์ • Messages API ๋ฃจํ”„๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์Šน์ธ ๊ฒŒ์ดํŠธ๊ฐ€ Claude์˜ ๋„๊ตฌ ํ˜ธ์ถœ๊ณผ ์‹ค์ œ ์‹คํ–‰ ์‚ฌ์ด์— ์œ„์น˜ํ•ด์•ผ ํ•˜๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.

์ „์ฒด ์ฝ”๋“œ์™€ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋Š” Rivermark GitHub ์ €์žฅ์†Œ์— ์žˆ์Šต๋‹ˆ๋‹ค.

ํ•œ์ชฝ์—๋Š” ์ฝ๊ธฐ ๋ฐ ์ง€์—ฐ๋œ ๋„๊ตฌ๊ฐ€ ์žˆ๋Š” Claude Sonnet 5.5, ๋‹ค๋ฅธ ์ชฝ์—๋Š” ๊ณ„ํš ๊ฒ€์ฆ, ์กฐ์ • ๊ธฐ๋ก๊ธฐ, ์ตœ์ข… ๊ฒ€์ฆ์ด ์žˆ๋Š” ์‹ ๋ขฐ ๊ฒฝ๊ณ„ ๋‹ค์ด์–ด๊ทธ๋žจ

์ œ์•ˆ์€ Claude๊ฐ€, ์“ฐ๊ธฐ ๊ถŒํ•œ ๋ถ€์—ฌ๋Š” Python์ด. ์ด๋ฏธ์ง€: ํ•„์ž

Rivermark ์กฐ์ • ๋ฌธ์ œ๋Š” ๋ฌด์—‡์ธ๊ฐ€์š”?

Rivermark์˜ ๊ฒ€์‚ฌ๋Š” ์˜ˆ์ƒ ์ง€๊ธ‰์•ก $3,400.14์™€ ๊ณ„์‚ฐ๋œ ํ”„๋กœ์„ธ์„œ ํ•ฉ๊ณ„ $3,251.14๋ฅผ ๋ณด๊ณ ํ•˜๋ฉฐ, ๋‘˜์˜ ์ฐจ์ด๋Š” $149.00์ž…๋‹ˆ๋‹ค. Claude๋Š” ์ˆจ๊ฒจ์ง„ ๋‘ ๊ฐ€์ง€ ์›์ธ์„ ๋ณด์ง€ ๋ชปํ•œ ์ฑ„ ๊ธฐ๋ก ๊ฐ„ ์ฐจ์ด๋ฅผ ์„ค๋ช…ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

Rivermark๋Š” ์›” ๊ตฌ๋… ์„ธ ๊ฐ€์ง€๋ฅผ ํŒ๋งคํ•ฉ๋‹ˆ๋‹ค: Starter $29, Team $79, Business $149. ์ƒ˜ํ”Œ์—๋Š” 9์›” ์ฃผ๋ฌธ 58๊ฑด, ํ™˜๋ถˆ ๊ธฐ๋ก 7๊ฑด, 9์›” ํ”„๋กœ์„ธ์„œ ๊ฑฐ๋ž˜ 65๊ฑด์ด ๋“ค์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฐ ํ”„๋กœ์„ธ์„œ ๊ธฐ๋ก์—๋Š” ๊ธˆ์•ก, ์ˆ˜์ˆ˜๋ฃŒ, ์ˆœ์•ก(net)์ด ์žˆ์Šต๋‹ˆ๋‹ค.

Python์€ ์„ฑ๊ณต์ ์ธ ์กฐ์ •์„ ์–ด๋–ป๊ฒŒ ์ •์˜ํ•˜๋‚˜์š”?

์กฐ์ • ์™„๋ฃŒ ์—ฌ๋ถ€๋Š” Claude๊ฐ€ ์•„๋‹ˆ๋ผ Python์ด ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค:

  • ํ•ด๋‹น ์›”์€ ํ”„๋กœ์„ธ์„œ ์ •์‚ฐ์ผ ๊ธฐ์ค€ 2026๋…„ 9์›”์ž…๋‹ˆ๋‹ค.

  • 9์›” ์€ํ–‰ ์˜ˆ๊ธˆ ์ด์•ก์€ ์‹คํ—˜์˜ ๋…๋ฆฝ์ ์ธ ์ •์‚ฐ ๋ชฉํ‘œ์ž…๋‹ˆ๋‹ค.

  • ๊ท ํ˜•(Balanced)์ด๋ž€ ์˜ˆ์ƒ ์ง€๊ธ‰์•ก์— ์กฐ์ •์„ ๋”ํ•œ ๊ฐ’์ด ์˜ˆ๊ธˆ์•ก๊ณผ 1์„ผํŠธ ๋‹จ์œ„๊นŒ์ง€ ์ผ์น˜ํ•จ์„ ๋œปํ•ฉ๋‹ˆ๋‹ค.

  • ๋ชจ๋“  ์กฐ์ •์€ Claude๊ฐ€ ์กฐํšŒํ•œ ํ”„๋กœ์„ธ์„œ txn_ids๋ฅผ ์ธ์šฉํ•˜๊ณ , ๊ทธ ๊ธˆ์•ก์€ ํ•ด๋‹น ํ•ญ๋ชฉ๋“ค์˜ ์ˆœ์•ก๊ณผ ๊ฐ™์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค.

  • Claude๋Š” ์Šน์ธ๋œ ์กฐ์ • ์ถ”๊ฐ€์™€ ์ตœ์ข… ๋ณด๊ณ ์„œ ์ œ์ถœ๋งŒ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  • ์›์‹œ ๋‚ด๋ณด๋‚ด๊ธฐ ํŒŒ์ผ์€ ์ฒ˜๋ฆฌ ์ „ ํ•ด์‹œํ•˜๊ณ , ์ฒ˜๋ฆฌ ํ›„์—๋„ ์ผ์น˜ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ดˆ๊ธฐ ์กฐ์‚ฌ ๋™์•ˆ Claude๋Š” ์€ํ–‰ ๊ธฐ๋ก์ด๋‚˜ ๋ชฉํ‘œ ํ•ฉ๊ณ„๋ฅผ ๋“ค์—ฌ๋‹ค๋ณผ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ๊ฒ€์ฆ์ด ์‹คํŒจํ•˜๋ฉด, Python์€ ์€ํ–‰ ๊ธฐ๋ก ์ž์ฒด๊ฐ€ ์•„๋‹ˆ๋ผ ์˜ˆ์ƒ ์ง€๊ธ‰์•ก, ์ด ์˜ˆ๊ธˆ ํ•ฉ๊ณ„, ๋‚จ์€ ์ฐจ์•ก๋งŒ ๊ณต๊ฐœํ•ฉ๋‹ˆ๋‹ค.

Python์—์„œ Claude Sonnet 5.5 API ์„ค์ • ๋ฐฉ๋ฒ•

Python 3.10 ์ด์ƒ์ด ํ•„์š”ํ•˜๋ฉฐ, Python SDK์—์„œ ์š”๊ตฌํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ Anthropic API ํ‚ค์™€ anthropic 1.9.0์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ์•„๋ž˜ PowerShell ๋ช…๋ น์€ ํ”„๋กœ์ ํŠธ๋ฅผ ํด๋ก ํ•˜๊ณ  ํ™˜๊ฒฝ์„ ๋งŒ๋“ค๋ฉฐ ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ๋ฅผ ๋นŒ๋“œํ•ฉ๋‹ˆ๋‹ค:

git clone https://github.com/KhalidAbdelaty/sonnet-5-5.git
cd sonnet-5-5
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
python build_data.py

macOS ๋˜๋Š” Linux์—์„œ๋Š” source .venv/bin/activate ๋ฐ cp .env.example .env๋ฅผ ์‚ฌ์šฉํ•œ ๋’ค, .env์— ํ‚ค๋ฅผ ๋„ฃ์œผ์„ธ์š”. ์ €ํฌ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ๊ฐ€์ด๋“œ๊ฐ€ ํŒจํ„ด์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.

streamlit run app_streamlit.py๋Š” ์กฐ์ • ๊ณผ์ •์˜ ๊ฐ ๋‹จ๊ณ„๋ฅผ ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋ณด์—ฌ์ฃผ๋Š” ์›น ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์—ฝ๋‹ˆ๋‹ค. ์ €ํฌ Streamlit ํŠœํ† ๋ฆฌ์–ผ์ด ์„ค์ • ๋ฐฉ๋ฒ•์„ ๋‹ค๋ฃน๋‹ˆ๋‹ค.

API ํ‚ค๊ฐ€ ์ด๋ฏธ ๋™์ž‘ํ•œ๋‹ค๋ฉด, ๋‹ค์Œ ์š”์ฒญ์€ ๊ฑด๋„ˆ๋›ฐ๊ณ  adaptive thinking์œผ๋กœ ๋„˜์–ด๊ฐ€์„ธ์š”.

์ฒซ Claude Sonnet 5.5 API ํ˜ธ์ถœ ๋งŒ๋“ค๊ธฐ

API ์š”์ฒญ๊ณผ ์‘๋‹ต ๊ฐ์ฒด๊ฐ€ ์ฒ˜์Œ์ด๋ผ๋ฉด ์ €ํฌ Python API ๊ฐ€์ด๋“œ์—์„œ ๊ธฐ๋ณธ์„ ํ™•์ธํ•˜์„ธ์š”. ํ‚ค๋ฅผ ํ™•์ธํ•˜๊ณ  ๋ฐ˜ํ™˜๋œ ์ฝ˜ํ…์ธ  ๋ธ”๋ก์„ ์‚ดํŽด๋ณด๋Š” ๋ฐ์—๋Š” ํ™˜๋ถˆ ๊ด€๋ จ ์งˆ๋ฌธ ํ•˜๋‚˜๋ฉด ์ถฉ๋ถ„ํ•ฉ๋‹ˆ๋‹ค:

import anthropic
from dotenv import load_dotenv

load_dotenv()
client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "A refund was requested on August 31 and settled on "
                                          "September 2. Which month's payout should it reduce, and why?"}],
)
print([block.type for block in response.content])
print("".join(block.text for block in response.content if block.type == "text"))
print(response.usage)

์ œ ์‹คํ–‰์—์„œ๋Š” ์‘๋‹ต์ด thinking ๋ธ”๋ก์œผ๋กœ ์‹œ์ž‘ํ–ˆ์Šต๋‹ˆ๋‹ค. response.content[0]์„ ์ฝ๊ธฐ๋ณด๋‹ค type์œผ๋กœ ๋ธ”๋ก์„ ์„ ํƒํ•˜์„ธ์š”. thinking ํ† ํฐ์€ ์ถœ๋ ฅ์œผ๋กœ ๊ณผ๊ธˆ๋ฉ๋‹ˆ๋‹ค.

PowerShell ํ„ฐ๋ฏธ๋„์— thinking๊ณผ text ์ฝ˜ํ…์ธ  ๋ธ”๋ก์ด ํ‘œ์‹œ๋˜๊ณ  ์ด์–ด์„œ Claude Sonnet 5.5 ํ† ํฐ ์‚ฌ์šฉ๋Ÿ‰์ด ์ถœ๋ ฅ๋จ

์ฒซ ์‘๋‹ต์€ thinking๊ณผ text๋ฅผ ๋ถ„๋ฆฌํ•ฉ๋‹ˆ๋‹ค. ์ด๋ฏธ์ง€: ํ•„์ž

Adaptive thinking๊ณผ effort ๊ตฌ์„ฑ ๋ฐฉ๋ฒ•

๋ชจ๋“  ์š”์ฒญ์€ ๋™์ผํ•œ ์ƒ์œ„ ์„ค์ •์„ ๋ณด๋‚ด๋ฉฐ, messages๋งŒ ์ฆ๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

response = client.beta.messages.create(
    model=MODEL, max_tokens=MAX_TOKENS, system=SYSTEM_PROMPT, tools=TOOLS,
    cache_control={"type": "ephemeral"},               # automatic caching, breakpoint moves forward
    thinking={"type": "adaptive", "display": "updates"},
    output_config={"effort": START_EFFORT},             # never changes: per-message changes do that
    messages=messages, betas=BETAS,
)

API์˜ ๊ธฐ๋ณธ๊ฐ’์ด high์ž„์—๋„, ์ด ์›Œํฌํ”Œ๋กœ๋Š” medium์—์„œ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. Anthropic์˜ effort ๊ฐ€์ด๋“œ๋Š” ์ด๋ ‡๊ฒŒ ๋งํ•ฉ๋‹ˆ๋‹ค. "์—์ด์ „ํŠธ์‹ ์ฝ”๋”ฉ๊ณผ ๋‹ค๋‹จ๊ณ„ ๋„๊ตฌ ์‚ฌ์šฉ์—๋Š”, ์ž‘์—…์ด ๋ช…ํ™•ํžˆ ์ •์˜๋˜์—ˆ์œผ๋ฉด medium์—์„œ ์‹œ์ž‘ํ•˜๊ณ  ๋” ์–ด๋ ต๊ฑฐ๋‚˜ ๊ธธ๋ฉด high๋กœ ์ด๋™ํ•˜์„ธ์š”."

์ถ”ํ›„ effort ๋ณ€๊ฒฝ์— ์˜์กดํ•˜๋ฏ€๋กœ thinking์€ ๊ณ„์† adaptive๋กœ ๋‘ก๋‹ˆ๋‹ค. display: "updates"(๋ฒ ํƒ€, thinking-display-updates-2026-08-18)๋Š” Claude๊ฐ€ ๋„๊ตฌ ํ˜ธ์ถœ ์‚ฌ์ด์— ๋‚จ๊ธฐ๋Š” ๋ฉ”๋ชจ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค. ์ด ์„ค์ •์ด ์—†์œผ๋ฉด thinking ๋ธ”๋ก์€ ๋น„์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

์ƒ์œ„ ์ˆ˜์ค€์˜ cache_control์€ ์ž๋™ ํ”„๋กฌํ”„ํŠธ ์บ์‹ฑ์„ ์ผœ๋ฉฐ, ๋Œ€ํ™”๊ฐ€ ๊ธธ์–ด์งˆ์ˆ˜๋ก ์บ์‹œ ๋ถ„๊ธฐ์ ์ด ์•ž์œผ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค. ์ฒซ ์š”์ฒญ์€ 2,080 ํ† ํฐ์„ ์บ์‹œ์— ๊ธฐ๋กํ–ˆ๋Š”๋ฐ, ์ด๋Š” Claude Sonnet 5.5์˜ ์ตœ์†Œ์น˜์ธ 512 ํ† ํฐ์„ ํ›จ์”ฌ ์›ƒ๋•๋‹ˆ๋‹ค.

์ฝ๊ธฐ ์ „์šฉ ์กฐ์ • ์—์ด์ „ํŠธ ๊ตฌ์ถ• ๋ฐฉ๋ฒ•

์ฝ๊ธฐ ์ „์šฉ ์กฐ์‚ฌ ์—์ด์ „ํŠธ๋Š” Claude๊ฐ€ ๊ทผ๊ฑฐ๋ฅผ ์š”์ฒญํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•˜๋˜, ์“ฐ๊ธฐ ๋„๊ตฌ๋Š” ๋…ธ์ถœํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. Rivermark๋Š” ์Šน์ธ๋˜์ง€ ์•Š์€ ์“ฐ๊ธฐ ํ˜ธ์ถœ์„ Python์—์„œ ๊ฑฐ๋ถ€ํ•ฉ๋‹ˆ๋‹ค.

Claude๋Š” ์–ด๋–ค ์ฝ๊ธฐ ์ „์šฉ ๋„๊ตฌ๋ฅผ ์‚ฌ์šฉํ•˜๋‚˜์š”?

Claude๋Š” strict: true๊ฐ€ ์„ค์ •๋œ ๋‹ค์„ฏ ๊ฐœ์˜ ์ฝ๊ธฐ ๋„๊ตฌ์™€ ํ•˜๋‚˜์˜ ์ œ์•ˆ ๋„๊ตฌ๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค. ์„ค๋ช…์—๋Š” ๊ฐ ๋„๊ตฌ๊ฐ€ ๋ฐ˜ํ™˜ํ•˜๋Š” ๋‚ด์šฉ๋งŒ ์ ๊ณ , ์–ด๋””์„œ ์ฐพ์•„์•ผ ํ•˜๋Š”์ง€๋Š” ์–ธ๊ธ‰ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค:

  • list_sources๋Š” ์†Œ์Šค, ์ปฌ๋Ÿผ, ํ–‰ ์ˆ˜๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

  • query_records๋Š” ํ•œ ์†Œ์Šค์—์„œ ์ตœ๋Œ€ 40๊ฐœ์˜ ํ–‰์„ ์„ ํƒ์ ์œผ๋กœ ํ•„ํ„ฐ์™€ ๋‚ ์งœ ๋ฒ”์œ„๋ฅผ ์ ์šฉํ•ด ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

  • aggregate_records๋Š” ์ž„์˜์˜ ์ปฌ๋Ÿผ ๊ธฐ์ค€์œผ๋กœ ํ–‰ ์ˆ˜์™€ amount_cents ํ•ฉ๊ณ„๋ฅผ ๊ณ„์‚ฐํ•ฉ๋‹ˆ๋‹ค.

  • read_policy๋Š” ๋งˆ๊ฐ ์ •์ฑ…์„ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

  • run_reconciliation_check๋Š” ๋ฒ„๊ทธ๋ฅผ ํฌํ•จํ•œ Rivermark์˜ ๊ธฐ์กด ๋‚ด๋ถ€ ๋กœ์ง์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  • submit_plan์€ ์ง„๋‹จ๊ณผ ์ œ์•ˆ๋œ ์กฐ์ •์„ Python์œผ๋กœ ๋ณด๋‚ด ๊ฒ€์ฆ๋งŒ ํ•˜๊ณ , ์•„๋ฌด๊ฒƒ๋„ ์“ฐ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋‘ ๊ฐœ ๋„๊ตฌ๊ฐ€ ๊ฐ™์€ tools ๋ฐฐ์—ด์— ์žˆ์ง€๋งŒ, defer_loading: true๋กœ ์ธํ•ด ์ง€๊ธˆ์€ Claude์—๊ฒŒ ๋ณด์ด์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ด๋“ค์ด ๋‚˜์ค‘์— ์–ด๋–ป๊ฒŒ ๋“ฑ์žฅํ•˜๋Š”์ง€ ์‚ดํŽด๋ด…๋‹ˆ๋‹ค:

{"name": "run_reconciliation_check", "strict": True,
 "description": "Run Rivermark's current internal reconciliation logic for September 2026, "
                "including adjustments recorded so far.",
 "input_schema": _schema({}, [])},
{"name": "create_adjustment", "strict": True, "defer_loading": True,
 "description": "Record one approved adjustment in the close adjustments ledger. Never edits source files.",
 "input_schema": _schema({...}, ["evidence_txn_ids", "rule", "amount_cents", "memo"])},

์“ฐ๊ธฐ ๋„๊ตฌ์˜ ์Šคํ‚ค๋งˆ๋Š” ์ฒซ ์š”์ฒญ ์‹œ์ ์— ์ด๋ฏธ ์•Œ๋ ค์ ธ ์žˆ์œผ๋ฏ€๋กœ, ๋„๊ตฌ๋Š” ๋ฏธ๋ฆฌ ์„ ์–ธํ•ฉ๋‹ˆ๋‹ค. ์ง€์ • ๋„๊ตฌ๋‚˜ any ๋„๊ตฌ ์„ ํƒ์€ 400 ์˜ค๋ฅ˜๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋ฏ€๋กœ, ํ”„๋กฌํ”„ํŠธ์— submit_plan์˜ ์ ์šฉ ์‹œ์ ์„ ๋ช…์‹œํ•ฉ๋‹ˆ๋‹ค.

Claude ๋„๊ตฌ ์‚ฌ์šฉ ๋ฃจํ”„๋Š” ์–ด๋–ป๊ฒŒ ๋™์ž‘ํ•˜๋‚˜์š”?

์ €ํฌ ์—์ด์ „ํŠธ ํ•˜๋‹ˆ์Šค ์—”์ง€๋‹ˆ์–ด๋ง ๊ฐ€์ด๋“œ๋Š” Python์ด ๋” ๊ธด ์—์ด์ „ํŠธ ๋ฃจํ”„๋ฅผ ๊ด€๋ฆฌํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. Rivermark์˜ ๋ฃจํ”„๋Š” ๋Œ€ํ™”๋ฅผ ์ „์†กํ•˜๊ณ , Python์—์„œ tool_use ๋ธ”๋ก์„ ์‹คํ–‰ํ•œ ๋’ค, ๊ฒฐ๊ณผ๋ฅผ ์ด์–ด๋ถ™์ž…๋‹ˆ๋‹ค. ์ฝ๊ธฐ ๋„๊ตฌ๊ฐ€ ๋ฐ˜ํ™˜ํ•˜๋Š” ๋ชจ๋“  ๋ ˆ์ฝ”๋“œ ID๋Š” ๋‚˜์ค‘์— ๊ณ„ํš ๊ฒŒ์ดํŠธ๊ฐ€ ํ™•์ธํ•˜๋Š” observed ์ง‘ํ•ฉ์— ๋“ค์–ด๊ฐ‘๋‹ˆ๋‹ค:

messages.append({"role": "assistant", "content": response.content})  # thinking blocks go back unchanged
if response.stop_reason == "tool_use":
    results = []
    for block in response.content:
        if block.type != "tool_use":
            continue
        if block.name in READ_TOOLS:
            out = reads.run(block.name, block.input)  # adds returned IDs to gate.observed
            results.append({"type": "tool_result", "tool_use_id": block.id, "content": dumps(out)})
        ...  # submit_plan goes to the gate; create_adjustment to the executor
    messages.append({"role": "user", "content": results})

์–ด์‹œ์Šคํ„ดํŠธ ํ„ด์€ ๋ฐ›์€ ๊ทธ๋Œ€๋กœ, ๋น„์–ด ์žˆ๋Š” thinking ๋ธ”๋ก๊นŒ์ง€ ํฌํ•จํ•ด ๋˜๋Œ๋ ค ๋ณด๋ƒ…๋‹ˆ๋‹ค. ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ฐ€์ด๋“œ์— ๋”ฐ๋ฅด๋ฉด Claude Sonnet 5.5๋Š” thinking ๋ธ”๋ก์„ ์ด์ „ ๋ฉ”์‹œ์ง€์— ๊ฒฐํ•ฉํ•˜๋ฏ€๋กœ, ๊ทธ ์ด๋ ฅ์„ ํŽธ์ง‘ํ•˜๋ฉด 400 ์˜ค๋ฅ˜๊ฐ€ ๋‚  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

medium effort์—์„œ Claude๋Š” ๋ฌด์—‡์„ ์ฐพ์•˜๋‚˜์š”?

medium์—์„œ ์กฐ์‚ฌ๋Š” 6ํšŒ API ํ˜ธ์ถœ๊ณผ 9ํšŒ ์ฝ๊ธฐ ๋„๊ตฌ ํ˜ธ์ถœ๋กœ ์ง„ํ–‰๋์Šต๋‹ˆ๋‹ค. Claude๋Š” ํ™˜๋ถˆ์„ ๊ฐ€์ ธ์˜ค๊ณ  ํ”„๋กœ์„ธ์„œ ๋ผ์ธ์„ reporting_category๋กœ ๊ทธ๋ฃนํ™”ํ–ˆ์Šต๋‹ˆ๋‹ค. ์ด์–ด RF-1043, 8์›” 31์ผ ์ฃผ๋ฌธ์— ๋Œ€ํ•œ $149.00 ํ™˜๋ถˆ์ด 9์›” 2์ผ์— ์ •์‚ฐ๋œ ๊ฒƒ์„ ์ฐพ์•˜์Šต๋‹ˆ๋‹ค. ์ •์ฑ… ๊ทœ์ • POL-3์— ๋”ฐ๋ผ 9์›”์— ๋ฐ˜์˜๋ฉ๋‹ˆ๋‹ค.

๊ทธ๋‹ค์Œ ๋ถ„์Ÿ ๋ผ์ธ ๋‘ ๊ฑด์„ ๋ชจ๋‘ ์—ด์–ด๋ดค์Šต๋‹ˆ๋‹ค. TXN-50036์—๋Š” -$149.00 ์›๊ธˆ, $15.00 ์ˆ˜์ˆ˜๋ฃŒ, -$164.00 ์ˆœํ˜„๊ธˆ ํšจ๊ณผ๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค. TXN-50052๋Š” ์ˆ˜์ˆ˜๋ฃŒ ์—†์ด $149.00 ์›๊ธˆ์„ ๋˜๋Œ๋ ค์ค๋‹ˆ๋‹ค. Claude๋Š” ์ด๋ ‡๊ฒŒ ์ผ์Šต๋‹ˆ๋‹ค. "DSP-0077์˜ ํ•ฉ๊ณ„๋Š” 0์ด๊ณ  $15 ์ˆ˜์ˆ˜๋ฃŒ๋Š” ์ด๋ฏธ ์˜ฌ๋ฐ”๋ฅด๊ฒŒ ์žฅ๋ถ€์— ๋ฐ˜์˜๋˜์–ด ์žˆ์œผ๋ฏ€๋กœ, RF-1043๋งŒ์œผ๋กœ ๋ณ€๋™์„ ์™„์ „ํžˆ ์„ค๋ช…ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค."ย 

Claude๋Š” ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ๋บ€ ์›๊ธˆ ๋ฐ˜ํ™˜๊ณผ ์‹ค์ œ ํ˜„๊ธˆ ํšจ๊ณผ๋ฅผ ํ˜ผ๋™ํ–ˆ์Šต๋‹ˆ๋‹ค:

  • ์›๊ธˆ์€ ํ•ฉ๊ณ„๊ฐ€ 0์ด ๋ฉ๋‹ˆ๋‹ค: -$149.00 + $149.00 = $0.00.ย 
  • ๊ฑฐ๋ž˜ ์ˆœ์•ก์€ 0์ด ์•„๋‹™๋‹ˆ๋‹ค: -$164.00 + $149.00 = -$15.00.ย 

๊ฒŒ์ดํŠธ๋Š” Claude์˜ ์ฒซ ๊ณ„ํš์„, ์กฐํšŒํ•˜์ง€ ์•Š์€ ์ฃผ๋ฌธ ORD-20813์„ ์ธ์šฉํ–ˆ๋‹ค๋Š” ์ด์œ ๋กœ ๊ฑฐ์ ˆํ–ˆ์Šต๋‹ˆ๋‹ค. Claude๋Š” ํ•ด๋‹น ์ฃผ๋ฌธ์„ ๊ฐ€์ ธ์˜จ ๋’ค ๋‹ค์‹œ ์ œ์ถœํ–ˆ๊ณ , PLAN-1์€ ํ•˜๋‚˜์˜ ์กฐ์ •์œผ๋กœ ํ†ต๊ณผํ–ˆ์Šต๋‹ˆ๋‹ค.

์Šน์ธ๋œ ์กฐ์ • ๊ณ„ํš ๋’ค์— ์“ฐ๊ธฐ ๊ถŒํ•œ์„ ์ž ๊ทธ๊ธฐ

์“ฐ๊ธฐ ๋„๊ตฌ๋ฅผ ๋…ธ์ถœํ•˜๊ธฐ ์ „์—, ๊ฒŒ์ดํŠธ๋Š” ๊ทผ๊ฑฐ์˜ ์ถœ์ฒ˜์™€ ๊ณ„ํš์ด ๋ฐ”๊พธ๋ ค๋Š” ๋‚ด์šฉ์„ ๊ฒ€์‚ฌํ•ฉ๋‹ˆ๋‹ค.

๊ณ„ํš ๊ฒŒ์ดํŠธ๋Š” ๊ทผ๊ฑฐ๋ฅผ ์–ด๋–ป๊ฒŒ ํ™•์ธํ•˜๋‚˜์š”?

๊ณ„ํš์˜ ๊ฐ ์กฐ์ •์€ ํ”„๋กœ์„ธ์„œ txn_id๋ฅผ ์ธ์šฉํ•ฉ๋‹ˆ๋‹ค. ๊ฒŒ์ดํŠธ๋Š” ํ•ด๋‹น ๋ผ์ธ์ด ๋ชจ๋‘ ์ด ๋Œ€ํ™”์˜ ์ฝ๊ธฐ ๋„๊ตฌ์—์„œ ๋˜๋Œ์•„์˜จ ๊ฒƒ์ด๊ณ , ๊ทธ ํ•ฉ๊ณ„๊ฐ€ ์ œ์•ˆ ๊ธˆ์•ก๊ณผ ์ผ์น˜ํ•  ๋•Œ๋งŒ ์Šน์ธํ•ฉ๋‹ˆ๋‹ค:

def evidence_problems(self, item: dict) -> list[str]:
    """Provenance: every cited line was retrieved, and the lines net to the adjustment."""
    ids = item["evidence_txn_ids"]
    problems = [f"{t} was never returned by a read tool in this conversation."
                for t in ids if t not in self.observed]
    unknown = [t for t in ids if t not in self.lines]
    if unknown or not ids:
        problems.append(f"Evidence must be processor txn_ids; not found: {', '.join(unknown) or 'none given'}.")
    elif sum(self.lines[t]["net_cents"] for t in ids) != item["amount_cents"]:
        problems.append(f"amount_cents {item['amount_cents']} is not the net_cents total of {', '.join(ids)}.")
    return problems

๋ถ„์Ÿ ์ฐจ๊ฐ ๋ผ์ธ๋งŒ ์ธ์šฉํ•œ $15.00 ์กฐ์ •์€ ํ•ด๋‹น ๋ผ์ธ์˜ ์ˆœ์•ก์ด -$164.00์ด๋ฏ€๋กœ ์‹คํŒจํ•ฉ๋‹ˆ๋‹ค. ๋ฐ˜๋Œ€ ์ฒ˜๋ฆฌ(๋ฆฌ๋ฒ„์„ค)๋„ ํ•จ๊ป˜ ์ธ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

๊ฒŒ์ดํŠธ๋Š” ์–ธ์ œ ์ˆ˜์ •์„ ๊ฑฐ์ ˆํ•˜๋‚˜์š”?

๊ฒŒ์ดํŠธ๋Š” ์ •์ฑ… ๊ทœ์ •๊ณผ ์ค‘๋ณต ๊ฑฐ๋ž˜๋„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ ํ•ญ๋ชฉ ์ค‘ ํ•˜๋‚˜๋ผ๋„ ํ•ด๋‹น๋˜๋ฉด ๊ณ„ํš์€ ๊ฑฐ์ ˆ๋˜๋ฉฐ, ์“ฐ๊ธฐ ๊ถŒํ•œ์€ ๊ณ„์† ์ž ๊ฒจ ์žˆ์Šต๋‹ˆ๋‹ค:

  • Claude๊ฐ€ ์กฐํšŒํ•˜์ง€ ์•Š์€ ์ฃผ๋ฌธ ๋˜๋Š” ํ™˜๋ถˆ์„ ์ธ์šฉ
  • POL-2, POL-3, POL-4๊ฐ€ ์•„๋‹Œ ์ •์ฑ… ๊ทœ์ • ์‚ฌ์šฉ
  • ์ด๋ฏธ ๋‹ค๋ฅธ ์กฐ์ •์ด ๋‹ค๋ฃจ๋Š” ๊ฑฐ๋ž˜๋ฅผ ๋‹ค์‹œ ํฌํ•จ

๊ฑฐ์ ˆ์€ submit_plan ๋„๊ตฌ ๊ฒฐ๊ณผ๋กœ ๋Œ์•„๊ฐ€๋ฏ€๋กœ, Claude๋Š” ์ถ”๊ฐ€๋กœ ์กฐ์‚ฌํ•˜๊ณ  ๋‹ค์‹œ ์ œ์ถœํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฒŒ์ดํŠธ๋Š” 4๊ฑด ์ค‘ 2๊ฑด์„ ๊ฑฐ์ ˆํ–ˆ์œผ๋ฉฐ, Claude๋Š” ๊ฐ ๊ฑด์„ ๋‹ค์Œ ํ˜ธ์ถœ์—์„œ ์ˆ˜์ •ํ–ˆ์Šต๋‹ˆ๋‹ค. ์Šน์ธ ํ›„์—๋„ create_adjustment๋Š” ์Šน์ธ ํ•ญ๋ชฉ๊ณผ ์ •ํ™•ํžˆ ์ผ์น˜ํ•˜๋Š” ์ž…๋ ฅ๋งŒ ๋ฐ›์Šต๋‹ˆ๋‹ค.

๋Œ€ํ™” ์ค‘๊ฐ„์— ์“ฐ๊ธฐ ๋„๊ตฌ ์ถ”๊ฐ€

๊ณ„ํš์ด ์Šน์ธ๋˜๋ฉด, Python์€ role: "system" ๋ฉ”์‹œ์ง€๋ฅผ tool_addition ๋ธ”๋ก๊ณผ ํ•จ๊ป˜ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. ์ด ๋ณ€๊ฒฝ์—๋Š” inline-tools-2026-09-15 ๋ฒ ํƒ€ ํ—ค๋”๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. tools ๋ฐฐ์—ด๊ณผ ๊ทธ ์ด์ „ ๋ฉ”์‹œ์ง€๋Š” ๋ณ€๊ฒฝ๋˜์ง€ ์•Š์œผ๋ฏ€๋กœ ์บ์‹œ๋œ ์ ‘๋‘๋ถ€๋Š” ๊ทธ๋Œ€๋กœ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค. ์ง€์‹œ ํ…์ŠคํŠธ๋Š” Claude๊ฐ€ ์•„๋‹ˆ๋ผ Python์—์„œ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค:

text = UNLOCK_TEXT.format(plan_id=approved_plan)
append_system([{"type": "text", "text": text},
               {"type": "tool_addition", "tool": {"type": "tool_reference",
                                                  "name": "create_adjustment"}}])
gate.write_unlocked = True

๋‚ด์šฉ์ด ์žˆ๋Š” ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€๋Š” user ํ„ด ๋‹ค์Œ์— ์™€์•ผ ํ•ฉ๋‹ˆ๋‹ค(tool_result ๋ธ”๋ก์ด ์žˆ๋Š” ๊ฒฝ์šฐ ํฌํ•จ). tool_use ๋ธ”๋ก๊ณผ ๊ทธ ๊ฒฐ๊ณผ ์‚ฌ์ด์—๋Š” ๋‘˜ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€๋Š” ์šฐ์„ ์ˆœ์œ„๊ฐ€ ๋” ๋†’์œผ๋ฏ€๋กœ, Claude์˜ ๊ณ„ํš ํ…์ŠคํŠธ๋‚˜ ๋„๊ตฌ ์ถœ๋ ฅ, ๋ฐ์ดํ„ฐ๋ฅผ ์ ˆ๋Œ€ ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€์— ๋„ฃ์ง€ ๋งˆ์„ธ์š”. tool_addition ๋ธ”๋ก์€ create_adjustment๋ฅผ ์ฐธ์กฐ๋กœ ์ง€์ •ํ•˜๋ฉฐ, ์ด ๋„๊ตฌ๋Š” ๊ณ„ํš ํ†ต๊ณผ ํ›„์—๋งŒ ๋ณด์ž…๋‹ˆ๋‹ค.

๋„๊ตฌ ๋ณ€๊ฒฝ ํ›„์—๋„ ์บ์‹ฑ์€ ๊ณ„์†๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ํ•ด๋‹น ์š”์ฒญ์€ ์บ์‹œ ๋ฐ– ์ž…๋ ฅ ํ† ํฐ 231๊ฐœ๋ฅผ ์ฒ˜๋ฆฌํ•˜๊ณ , ์บ์‹œ์—์„œ 6,883๊ฐœ๋ฅผ ์ฝ์—ˆ์Šต๋‹ˆ๋‹ค.

์ฒซ ๋ฒˆ์งธ ์กฐ์ •์ด ๋ถˆ์™„์ „ํ–ˆ๋˜ ์ด์œ 

์ฒซ ์กฐ์ •์€ ์˜ณ์•˜์ง€๋งŒ, ๊ทธ๋Ÿผ์—๋„ ์ž‘์—…์€ ๋๋‚˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. Claude๋Š” POL-3์— ๋”ฐ๋ฅธ -$149.00์˜ ADJ-001์„ ๊ธฐ๋กํ•˜๊ณ  ์™„๋ฃŒ๋กœ ๋ณด๊ณ ํ–ˆ์Šต๋‹ˆ๋‹ค. Rivermark ๋‚ด๋ถ€ ๊ฒ€์‚ฌ๋Š” $0.00 ๋ณ€๋™์œผ๋กœ ๋™์˜ํ–ˆ์„ ๊ฒƒ์ž…๋‹ˆ๋‹ค. ๊ทธ๋Ÿด๋“ฏํ•ด ๋ณด์ด์ง€๋งŒ, ์•„์ง ๋๋‚œ ๊ฒŒ ์•„๋‹™๋‹ˆ๋‹ค.

๋…๋ฆฝ์ ์ธ Python ๊ฒ€์‚ฌ๋Š” ์€ํ–‰ ์˜ˆ๊ธˆ๊ณผ ๋น„๊ตํ•ฉ๋‹ˆ๋‹ค. ์กฐ์ • ํ›„ ์˜ˆ์ƒ ์ง€๊ธ‰์•ก์€ $3,251.14, ์˜ˆ๊ธˆ์€ $3,236.14๋กœ $15.00์ด ๋‚จ์•˜์Šต๋‹ˆ๋‹ค.

์ด ๊ฒฉ์ฐจ ๋•Œ๋ฌธ์—, ์™„๋ฃŒ ๊ฒ€์‚ฌ๋Š” Claude์˜ ์ตœ์ข… ๋ฉ”์‹œ์ง€๊ฐ€ ์•„๋‹ˆ๋ผ Python์— ์œ„์น˜ํ•ฉ๋‹ˆ๋‹ค.

์ฃผ์š” ์กฐ์ • ๊ฒฝ๋กœ๋Š” effort๋ฅผ medium์—์„œ high๋กœ ์˜ฌ๋ฆฌ๊ณ , ๋ณ„๋„์˜ ๋Œ€์‘ ์žฌ์‹คํ–‰์€ medium์— ๋จธ๋ฌด๋Š” ์‹œํ€€์Šค ๋‹ค์ด์–ด๊ทธ๋žจ

๊ฒ€์ฆ ์‹คํŒจ ์ง€์ ์—์„œ ๋ถ„๊ธฐํ•œ ๋Œ€์‘ ์žฌ์‹คํ–‰. ์ด๋ฏธ์ง€: ํ•„์ž

๊ฒ€์ฆ ์‹คํŒจ ํ›„ effort ์ƒํ–ฅ

Claude Sonnet 5.5์—์„œ ๋Œ€ํ™” ์ค‘๊ฐ„ effort ๋ณ€๊ฒฝ์€ ๋นˆ content์˜ ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€์™€ ์ƒˆ output_config.effort๋ฅผ ์ถ”๊ฐ€ํ•˜๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ์ƒˆ ์ˆ˜์ค€์€ ๋‹ค์Œ user ํ„ด๋ถ€ํ„ฐ ์ ์šฉ๋˜๋ฉฐ, ๊ทธ์ „์˜ ๋‚ด์šฉ์€ ๊ณ„์† ์บ์‹œ์— ๋‚จ์Šต๋‹ˆ๋‹ค.

๋Œ€ํ™”๋ฅผ ์žฌ์‹œ์ž‘ํ•˜์ง€ ์•Š๊ณ  effort ๋ฐ”๊พธ๊ธฐ

๋ฉ”์‹œ์ง€๋ณ„ effort๋Š” ๋ฒ ํƒ€์ด๋ฉฐ mid-conversation-output-config-2026-07-01 ํ—ค๋”๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ๋˜ํ•œ adaptive thinking์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. between_tools ์„ค์ •์—์„œ๋Š” ๊ฐ™์€ ๋ณ€๊ฒฝ์ด 400 ์˜ค๋ฅ˜๋ฅผ ๋ƒ…๋‹ˆ๋‹ค. ๋…๋ฆฝ ๊ฒ€์‚ฌ์— ์‹คํŒจํ•˜๋ฉด, Python์€ ๋‹ค์Œ ์‚ฌ์šฉ์ž ๋ฉ”์‹œ์ง€ ์ „์— ์ƒˆ effort ์„ค์ •์„ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

if escalate:
    append_system([], output_config={"effort": ESCALATED_EFFORT})  # effort-only: accepted anywhere
messages.append({"role": "user", "content": (
    f"The harness's independent check failed. Expected payout after adjustments: "
    f"{_cents(result['expected_after_adjustments_cents'])}. Processor deposits for September (bank "
    f"record): {_cents(result['processor_deposits_cents'])}. Residual: {_cents(result['residual_cents'])}. "
    f"Recorded adjustments ({ids}) stay in the ledger. Investigate what the residual is, using the same "
    f"tools, and submit an amended plan that contains only new adjustments.")})

์ƒ์œ„ ์ˆ˜์ค€ effort ๋ณ€๊ฒฝ์€ ์š”์ฒญ์˜ ํ”„๋กฌํ”„ํŠธ ์ ‘๋‘๋ถ€๋ฅผ ๋ฐ”๊พธ๋ฏ€๋กœ ์บ์‹œ๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ๋ฉ”์‹œ์ง€๋ณ„ ํ˜•ํƒœ๋Š” ๊ทธ๋ ‡์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ฒซ high-effort ์š”์ฒญ์€ ์บ์‹œ์—์„œ 8,012 ํ† ํฐ์„ ์ฝ๊ณ , ์บ์‹œ ๋ฐ– 4 ํ† ํฐ์„ ์ฒ˜๋ฆฌํ–ˆ์Šต๋‹ˆ๋‹ค.

$15.00์˜ ์ฐจ์•ก์€ Claude์—๊ฒŒ ๋ชฉํ‘œ๋ฅผ ์ œ๊ณตํ•˜์ง€๋งŒ, ์ˆ˜์ •์˜ ๊ทผ๊ฑฐ๋Š” ์•„๋‹™๋‹ˆ๋‹ค. ๊ฒŒ์ดํŠธ๋Š” ์—ฌ์ „ํžˆ Claude๊ฐ€ ์กฐํšŒํ•œ ๊ฑฐ๋ž˜ ID๋ฅผ ์š”๊ตฌํ•˜๋ฉฐ, ํ•ด๋‹น net_cents ํ•ฉ๊ณ„๊ฐ€ -$15.00์ด์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. TXN-50036๋งŒ ์ธ์šฉํ•œ -$15.00 ์กฐ์ • ์ œ์•ˆ์€ ํ•ด๋‹น ๋ผ์ธ์˜ ์ˆœ์•ก์ด -$164.00์ด๋ฏ€๋กœ ์—ฌ์ „ํžˆ ์‹คํŒจํ•ฉ๋‹ˆ๋‹ค.

high effort์—์„œ Claude๋Š” ๋ฌด์—‡์„ ์ฐพ์•˜๋‚˜์š”?

high์—์„œ๋Š” ํ”„๋กœ์„ธ์„œ ๋ผ์ธ์„ ์ง€๊ธ‰(payout)๋ณ„, fee_cents๋ณ„๋กœ ๊ทธ๋ฃนํ™”ํ•˜๊ณ  ๋‚ด๋ถ€ ๊ฒ€์‚ฌ๋ฅผ ์žฌ์‹คํ–‰ํ–ˆ์Šต๋‹ˆ๋‹ค. ๋‹ค์Œ ๋ฉ”๋ชจ์—์„œ ์ˆ˜์ˆ˜๋ฃŒ ๋ผ์ธ์˜ ํ•ฉ์„ 12,586์„ผํŠธ๋กœ ์ง‘๊ณ„ํ–ˆ๊ณ , ๋ถ„์Ÿ ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ๋”ํ•ด 14,086์„ผํŠธ๊ฐ€ ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. Rivermark์˜ ๊ฒ€์‚ฌ๋Š” ์ด๋ฅผ ๋ˆ„๋ฝํ–ˆ์Šต๋‹ˆ๋‹ค.

์ฒซ ๋ฒˆ์งธ ์ˆ˜์ • ๊ณ„ํš์€ ์ฐจ๊ฐ ๋ผ์ธ๋งŒ ์ธ์šฉํ•ด ๊ทœ์ •์— ๊ฑธ๋ ธ์Šต๋‹ˆ๋‹ค. ๋‹ค์Œ์—๋Š” ๋ถ„์Ÿ ๋ผ์ธ ๋‘ ๊ฑด์„ ๋ชจ๋‘ ์ธ์šฉํ–ˆ๊ณ , PLAN-2๊ฐ€ ํ†ต๊ณผ๋˜์–ด ADJ-002๋กœ POL-4์— ๋”ฐ๋ฅธ -$15.00์ด ๊ธฐ๋ก๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

๋Œ€์‘ ์žฌ์‹คํ–‰์— high effort๊ฐ€ ํ•„์š”ํ–ˆ๋‚˜์š”?

์ด ์‹คํ—˜์€ high๊ฐ€ ํ•„์ˆ˜์˜€์Œ์„ ๋ณด์—ฌ์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋™์ผํ•œ ์‹คํŒจ ์ง€์ ์—์„œ ๊ฐ™์€ ๋Œ€ํ™” ์ด๋ ฅ๊ณผ Python ๋ฉ”์‹œ์ง€๋กœ ๊ณ„์†ํ•œ ๋ณ„๋„ ์žฌ์‹คํ–‰์€ medium์— ๋จธ๋ฌผ๋ €๊ณ , ๋™์ผํ•œ ๊ฒŒ์ดํŠธ ๊ฑฐ์ ˆ์„ ํฌํ•จํ•ด ์ˆ˜์ˆ˜๋ฃŒ๋ฅผ ์ฐพ์•„๋ƒˆ์Šต๋‹ˆ๋‹ค.

์ฃผ ๊ฒฝ๋กœ์˜ high-effort 6ํšŒ ํ˜ธ์ถœ์€ 2,763 ์ถœ๋ ฅ ํ† ํฐ(๊ทธ์ค‘ thinking 607)์„ ์ƒ์„ฑํ–ˆ๊ณ  ๋น„์šฉ์€ $0.0484์˜€์Šต๋‹ˆ๋‹ค. ๋ณ„๋„ ๋Œ€์กฐ(control)์˜ medium-effort ์กฐ์‚ฌ 6ํšŒ ํ˜ธ์ถœ์€ 2,713 ์ถœ๋ ฅ ํ† ํฐ(๊ทธ์ค‘ thinking 628)์„ ์ƒ์„ฑํ–ˆ๊ณ  ๋น„์šฉ์€ $0.0464์˜€์Šต๋‹ˆ๋‹ค.

์ตœ์ข… ๋ณด๊ณ ์„œ ํ˜ธ์ถœ 1ํšŒ๋ฅผ ๋”ํ•ด ๋Œ€์กฐ๋Š” ์ด 7ํšŒ ํ˜ธ์ถœ, $0.0615๊ฐ€ ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ์ด ํ˜ธ์ถœ๊ณผ ๋น„์šฉ์€ ์ฃผ ๊ฒฝ๋กœ์˜ 15ํšŒ ํ˜ธ์ถœ, $0.1190์— ํฌํ•จ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋‘ ๊ฒฝ๋กœ๋Š” ๋™์ผํ•œ ์‹คํŒจ-ํ†ต์ง€ ๋ฉ”์‹œ์ง€๋ฅผ ๋ฐ›์•˜๊ณ , effort๋งŒ ๋‹ฌ๋ž์Šต๋‹ˆ๋‹ค. ์žฌ์‹คํ–‰ ํ•œ ๋ฒˆ์œผ๋กœ effort ํšจ๊ณผ์˜ ํฌ๊ธฐ๋ฅผ ์ธก์ •ํ•  ์ˆ˜๋Š” ์—†์ง€๋งŒ, ์ด ์‚ฌ๋ก€์—์„œ๋Š” high๊ฐ€ ํ•„์ˆ˜๋Š” ์•„๋‹ˆ์—ˆ์Œ์„ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค. ๊ฐ™์€ ๊ฐ€์ด๋“œ๋Š” xhigh์™€ max๋ฅผ "ํ‰๊ฐ€์—์„œ ํ’ˆ์งˆ ๊ฐœ์„ ์ด ์ž…์ฆ๋œ" ๊ฒฝ์šฐ๋กœ ์ œํ•œํ•ฉ๋‹ˆ๋‹ค. high๋ฅผ ์„ ํƒํ•˜๊ธฐ ์ „์— ๋™์ผํ•œ ๋ฐฉ์‹์œผ๋กœ ํ…Œ์ŠคํŠธํ•˜์„ธ์š”.

Python์—์„œ ์ตœ์ข… ์กฐ์ • ๊ฒ€์ฆํ•˜๊ธฐ

์ตœ์ข… ๊ฒ€์ฆ์€ ์˜๋„์ ์œผ๋กœ ๊ฒŒ์ดํŠธ์˜ ๋‘ ๊ฐ€์ง€ ๊ฒ€์‚ฌ๋ฅผ ๋ฐ˜๋ณตํ•ฉ๋‹ˆ๋‹ค: ๊ทผ๊ฑฐ์™€ ์“ฐ๊ธฐ ๋ฒ”์œ„. ๊ฒŒ์ดํŠธ๋Š” ์“ฐ๊ธฐ ์ „์— ์ œ์•ˆ์„ ๊ฒ€ํ† ํ•˜๊ณ , ์ตœ์ข… ๊ฒ€์ฆ์€ Python์ด ์‹ค์ œ๋กœ ์“ด ๋‚ด์šฉ์„ ์ ๊ฒ€ํ•œ ๋’ค ์ˆซ์ž์™€ ์›์‹œ ํŒŒ์ผ ๊ฒ€์‚ฌ๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค.ย 

ADJ-002 ์ดํ›„ Python์€ ์›์‹œ ๊ธฐ๋ก, ์Šน์ธ๋œ ์กฐ์ •, ์€ํ–‰ ์ด์•ก์—์„œ ๋ชจ๋“  ๊ฐ’์„ ๋‹ค์‹œ ๊ณ„์‚ฐํ–ˆ์Šต๋‹ˆ๋‹ค:

checks = {
    "numbers": adjusted == deposits,
    "provenance": not provenance,
    "raw_unchanged": hash_dir(self.raw) == self.hashes_before,
    "write_scope": set(created) <= ALLOWED_OUTPUTS,
}

๋„ค ํ•ญ๋ชฉ ๋ชจ๋‘ ํ†ต๊ณผํ–ˆ์Šต๋‹ˆ๋‹ค. ์กฐ์ • ํ›„ ์˜ˆ์ƒ ์ง€๊ธ‰์•ก $3,236.14๊ฐ€ ์˜ˆ๊ธˆ๊ณผ ์ผ์น˜ํ–ˆ์Šต๋‹ˆ๋‹ค. ๋‘ ์กฐ์ • ๋ชจ๋‘ ์กฐํšŒ๋œ ๋ผ์ธ์œผ๋กœ ์ถ”์  ๊ฐ€๋Šฅํ–ˆ๊ณ , ์›๋ณธ ์†Œ์Šค ๋ฐ์ดํ„ฐ๋Š” ๋ณ€๊ฒฝ๋˜์ง€ ์•Š์•˜์œผ๋ฉฐ, Python์€ ์Šน์ธ๋œ ํ•ญ๋ชฉ๋งŒ ๊ธฐ๋กํ–ˆ์Šต๋‹ˆ๋‹ค.

๊ทธ์ œ์•ผ ๋ณด๊ณ  ๋‹จ๊ณ„๊ฐ€ ์‹œ์ž‘๋ฉ๋‹ˆ๋‹ค. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์€ effort๋ฅผ ๋‹ค์‹œ medium์œผ๋กœ ๋˜๋Œ๋ฆฌ๋Š” ๋ฉ”์‹œ์ง€, ๊ฐ„๋‹จํ•œ ์‚ฌ์šฉ์ž ํ„ด, ๊ทธ๋ฆฌ๊ณ  ๋„๊ตฌ๋ฅผ ๊ต์ฒดํ•˜๋Š” ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€๋ฅผ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

append_system([{"type": "text", "text": REPORT_TEXT},
               {"type": "tool_removal", "tool": {"type": "tool_reference", "name": "create_adjustment"}},
               {"type": "tool_addition", "tool": {"type": "tool_reference", "name": "submit_report"}}])

๋ณด๊ณ ์„œ๋Š” ์ตœ์ข… ์‚ฐ์ถœ๋ฌผ์ผ ๋ฟ, ์ฆ๊ฑฐ๋Š” ์•„๋‹™๋‹ˆ๋‹ค. ํ›„์† ์ œ์•ˆ์€ ์—ฌ์ „ํžˆ ์‚ฌ๋žŒ์˜ ๊ฒ€ํ† ๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ์•„๋ž˜ ๊ธฐ๋ก์€ ํ•˜๋‚˜์˜ Streamlit ์„ธ์…˜์—์„œ ๊ถŒํ•œ, effort, ๊ฒ€์‚ฌ, ๋น„์šฉ์˜ ํ๋ฆ„์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.

Streamlit์€ ์‹œ์ž‘๋ถ€ํ„ฐ ์กฐ์ • ๊ณผ์ •์„ ๋”ฐ๋ผ๊ฐ‘๋‹ˆ๋‹ค. ์˜์ƒ: ํ•„์ž

Claude Sonnet 5.5 ์—์ด์ „ํŠธ ๋น„์šฉ์€ ์–ผ๋งˆ์˜€๋‚˜์š”?

์ฃผ์š” ์กฐ์ •์€ medium์—์„œ high๋กœ ์ „ํ™˜ํ–ˆ๊ณ , 15ํšŒ API ํ˜ธ์ถœ์— $0.1190, ์ด 70.0์ดˆ(์ด ์ค‘ API ๋Œ€๊ธฐ 69.0์ดˆ)๊ฐ€ ์†Œ์š”๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ๋ณ„๋„์˜ ๋Œ€์‘ ์žฌ์‹คํ–‰์€ ํฌํ•จํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋ชจ๋“  ์ˆ˜์น˜๋Š” ์‘๋‹ต usage์™€ Claude Sonnet 5.5 ์š”์œจ์—์„œ ์‚ฐ์ถœํ–ˆ์Šต๋‹ˆ๋‹ค.

๋” ํญ๋„“์€ ๋น„์šฉ ๋ถ„ํ•ด๋Š” ์ €ํฌ Claude API ๊ฐ€์ด๋“œ์—์„œ ํ”„๋กฌํ”„ํŠธ ์บ์‹ฑ๊ณผ ๋ฐฐ์น˜ ์ฒ˜๋ฆฌ๋ฅผ ๋‹ค๋ฃน๋‹ˆ๋‹ค.

Claude Sonnet 5.5 ์บ์‹œ ๋น„์šฉ์€ ์–ด๋–ป๊ฒŒ ๊ณ„์‚ฐํ•˜๋‚˜์š”?

input_tokens๋Š” ์บ์‹œ ๋ถ„๊ธฐ์  ์ดํ›„๋งŒ ๊ณ„์‚ฐํ•˜๋ฏ€๋กœ, ์ด ์ž…๋ ฅ์€ ์•ž์„œ ๋งํฌํ•œ ํ”„๋กฌํ”„ํŠธ ์บ์‹ฑ ๋ฌธ์„œ์—์„œ ์„ค๋ช…ํ•˜๋“ฏ ์„ธ ํ•„๋“œ์˜ ํ•ฉ์ž…๋‹ˆ๋‹ค. ์บ์‹œ ์“ฐ๊ธฐ์™€ ์ฝ๊ธฐ๋Š” ๊ฐ์ž ์š”์œจ์ด ์žˆ์œผ๋ฉฐ, thinking ํ† ํฐ์€ ์ด๋ฏธ output_tokens์— ํฌํ•จ๋ฉ๋‹ˆ๋‹ค:

cost = (
    usage.input_tokens * 2.00                   # uncached input only
    + cache_creation.ephemeral_5m_input_tokens * 2.50
    + cache_creation.ephemeral_1h_input_tokens * 4.00
    + usage.cache_read_input_tokens * 0.20
    + usage.output_tokens * 10.00               # includes thinking
) / 1_000_000

์กฐ์ • ์ „์ฒด์—์„œ Claude๋Š” 118,308๊ฐœ ์ž…๋ ฅ ํ† ํฐ ์ค‘ 105,614๊ฐœ(์•ฝ 89%)๋ฅผ ์บ์‹œ์—์„œ ์ฝ์—ˆ๊ณ , ์บ์‹œ ๋ฐ–์œผ๋กœ ๊ณผ๊ธˆ๋œ ์ž…๋ ฅ์€ 636๊ฐœ๋ฟ์ด์—ˆ์Šต๋‹ˆ๋‹ค. ์•„๋ž˜ ์ฐจํŠธ๋Š” ์ธก์ •๋œ ์‚ฌ์šฉ๋Ÿ‰์— ๋„ค ๊ฐ€์ง€ ํ† ํฐ ์š”์œจ์„ ์ ์šฉํ•œ ๊ฒƒ์ž…๋‹ˆ๋‹ค.

Rivermark API ๋น„์šฉ์„ ๋น„์บ์‹œ ์ž…๋ ฅ, ์บ์‹œ ์ฝ๊ธฐ, ์บ์‹œ ์“ฐ๊ธฐ, ์ถœ๋ ฅ ํ† ํฐ์œผ๋กœ ๋‚˜๋ˆˆ ์„ธ๋กœ ๋ง‰๋Œ€ ์ฐจํŠธ

์ถœ๋ ฅ ํ† ํฐ์ด ๋น„์šฉ์˜ ๋Œ€๋ถ€๋ถ„์„ ์ฐจ์ง€ํ–ˆ์Šต๋‹ˆ๋‹ค. ์ด๋ฏธ์ง€: ํ•„์ž

API ํ•œ๊ณ„์™€ ์šด์˜ ๊ณ ๋ ค์‚ฌํ•ญ

Rivermark๋Š” ๋กœ์ปฌ ์กฐ์ • ๊ธฐ๋ก์„ ์”๋‹ˆ๋‹ค. ์šด์˜ ํ™˜๊ฒฝ์˜ ์žฌ๋ฌด ์‹œ์Šคํ…œ์—๋Š” ๋‹ค์Œ์ด ์—ฌ์ „ํžˆ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค:

  • ๋กœ์ปฌ, ๊ฐ€์ƒ ๋ฐ์ดํ„ฐ. ์‹ค์ œ ๋งˆ๊ฐ์—๋Š” ์ธ์ฆ, ๊ฐ์‚ฌ ๋กœ๊ทธ, ๋ถ„๊ฐœ ์Šน์ธ, ๋ฐ์ดํ„ฐ ๋ณด์กด ๊ฒ€ํ† ๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

  • ๋ฒ ํƒ€ ๊ธฐ๋Šฅ. ๋ฉ”์‹œ์ง€๋ณ„ effort, ๋„๊ตฌ ๋ณ€๊ฒฝ, thinking ์—…๋ฐ์ดํŠธ์— ์“ฐ๋Š” ํ—ค๋”๋Š” ๋ณ€๊ฒฝ๋  ์ˆ˜ ์žˆ์œผ๋‹ˆ, ๋ฐฐํฌ ์ „ ๋‹ค์‹œ ํ…Œ์ŠคํŠธํ•˜์„ธ์š”.

  • ๋ณ€๋™ ๊ฐ€๋Šฅํ•œ ๊ฒฐ๊ณผ. Claude Sonnet 5.5๋Š” ๊ธฐ๋ณธ์ด ์•„๋‹Œ temperature๋ฅผ ๊ฑฐ๋ถ€ํ•˜๋ฏ€๋กœ, ๋ฐ˜๋ณต ์‹œ๋„ ๊ฒฐ๊ณผ๊ฐ€ ๋‹ฌ๋ผ์งˆ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์˜์กดํ•˜๊ธฐ ์ „์— ์ž์ฒด ๋ฐ์ดํ„ฐ๋กœ ํŒจํ„ด์„ ๊ฒ€์ฆํ•˜์„ธ์š”.

๋งˆ๋ฌด๋ฆฌ

์ฝ๊ธฐ ์ „์šฉ ๋„๊ตฌ๋กœ ์กฐ์‚ฌํ•˜๊ณ , Python์ด ๊ณ„ํš์„ ์Šน์ธํ•œ ๋’ค์—๋งŒ ์“ฐ๊ธฐ ๋„๊ตฌ ํ•˜๋‚˜๋ฅผ ๋ถ€์—ฌํ•˜๋ฉฐ, ์€ํ–‰ ์˜ˆ๊ธˆ๊ณผ์˜ ๋…๋ฆฝ ๊ฒ€์‚ฌ๋ฅผ ํ†ต๊ณผํ•ด์•ผ๋งŒ ๋๋‚˜๋Š” ์กฐ์ • ์—์ด์ „ํŠธ๋ฅผ ๋งŒ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค. Claude Sonnet 5.5๋Š” ์ž˜๋ชป ๋ฐ˜์˜๋œ ํ™˜๋ถˆ์„ ์Šค์Šค๋กœ ์ฐพ์•˜์ง€๋งŒ, ์ด๋ฏธ ์ฝ์—ˆ๋˜ $15.00 ์ˆ˜์ˆ˜๋ฃŒ๋กœ ๋‹ค์‹œ ๋ณด๋‚ด์ค€ ๊ฒƒ์€ ์‹คํŒจํ•œ ๊ฒ€์ฆ์ด์—ˆ์Šต๋‹ˆ๋‹ค.

๊ฐ€์ƒ์˜ ํ•œ ๋‹ฌ์„ ๋ชจ๋“  ๋งˆ๊ฐ์— ์ผ๋ฐ˜ํ™”ํ•˜์ง„ ์•Š๊ฒ ์Šต๋‹ˆ๋‹ค. ์ด์–ด์ง€๋Š” ๊ฒƒ์€ ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ๊ณ„ํš์ด ํ†ต๊ณผํ•  ๋•Œ๊นŒ์ง€ ์“ฐ๊ธฐ ๋„๊ตฌ๋ฅผ ์ˆจ๊ธฐ๊ณ , ์€ํ–‰ ๊ธฐ๋ก์€ ๋ชจ๋ธ ๋ฐ–์— ๋‘๋ฉฐ, ๋ชจ๋“  ์ˆ˜์ •์— ๊ฑฐ๋ž˜ ๊ทผ๊ฑฐ๋ฅผ ์š”๊ตฌํ•˜๊ณ , ๋„๊ตฌ๋‚˜ effort ๋ณ€๊ฒฝ์€ ์บ์‹œ๊ฐ€ ์œ ์ง€๋˜๋„๋ก ์ถ”๊ฐ€ํ•˜์„ธ์š”.ย 

๋…๋ฆฝ ๊ฒ€์‚ฌ๋Š” ์ด ํ”„๋กœ์ ํŠธ์˜ ์ถ•์†ŒํŒ์—์„œ๋„ ๋ฐ˜๋“œ์‹œ ์œ ์ง€ํ•˜๊ฒ ์Šต๋‹ˆ๋‹ค. effort ๋ณ€๊ฒฝ์€ effort ์„น์…˜์—์„œ ๋‹ค๋ฃฌ ์ด์œ ๋กœ ์‹ ๋ขฐ ์ „์— ์‹œํ—˜ํ•ด๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค.

์ฝ๊ธฐ ๋„๊ตฌ์™€ ์ตœ์ข… ๊ฒ€์‚ฌ๋ฅผ ๋ฐ”๊ฟ” ๋ผ์šฐ๋ฉด ๊ฐ™์€ ํŒจํ„ด์œผ๋กœ ๋ฐ์ดํ„ฐ ์ •๋ฆฌ ๋ณด์ •, ๊ณ ๊ฐ ์ง€์› ํ™˜๋ถˆ, ํ†ต์ œ๋œ ๋ฌธ์„œ ์—…๋ฐ์ดํŠธ๋„ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ œ๊ฐ€ ์ฒซ ํ™•์žฅ์œผ๋กœ ๊ณ ๋ คํ•  ๊ฒƒ์€ ๊ฐ ์กฐ์ • ๊ธฐ๋ก ์ „์— ์‚ฌ๋žŒ ์Šน์ธ ๋‹จ๊ณ„๋ฅผ ๋„ฃ๋Š” ๊ฒƒ์ž…๋‹ˆ๋‹ค. ์‹ค์ œ ๋งˆ๊ฐ์—๋Š” ํ•„์š”ํ•˜๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.

์ด ๋นŒ๋“œ๊ฐ€ ์˜์กดํ•˜๋Š” Anthropic API์˜ ๊ธฐ๋ณธ๊ธฐ๋ฅผ ์—ฐ์Šตํ•˜๋ ค๋ฉด, ์ €ํฌ Introduction to Claude Models ์ฝ”์Šค๋ฅผ ์ถ”์ฒœํ•ฉ๋‹ˆ๋‹ค.

FAQs

์ด ์›Œํฌํ”Œ๋กœ๋Š” Amazon Bedrock์ด๋‚˜ Google Cloud์—์„œ๋„ ๋™์ž‘ํ•˜๋‚˜์š”?

์™„์ „ํžˆ ๋™์ผํ•˜์ง„ ์•Š์Šต๋‹ˆ๋‹ค. Claude Sonnet 5.5์™€ ๋Œ€ํ™” ์ค‘๊ฐ„ ์‹œ์Šคํ…œ ๋ฉ”์‹œ์ง€๋Š” Claude API, Amazon Bedrock, Google Cloud์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ๋นŒ๋“œ๋Š” ๋ฉ”์‹œ์ง€๋ณ„ effort๋„ ์‚ฌ์šฉํ•˜๋ฉฐ, ํ˜„์žฌ Anthropic ๋ฌธ์„œ๋Š” Claude API์™€ Google Cloud์— ์ด๋ฅผ ๋‹ค๋ฃจ๊ณ  Bedrock์—๋Š” ์—†์Šต๋‹ˆ๋‹ค. ๋˜ํ•œ Claude API์˜ inline-tools-2026-09-15 ํ—ค๋”๋ฅผ ๋ณด๋ƒ…๋‹ˆ๋‹ค. Bedrock๊ณผ Google Cloud์—์„œ์˜ ์ฐธ์กฐ ๊ธฐ๋ฐ˜ ๋„๊ตฌ ๋ณ€๊ฒฝ์€ mid-conversation-tool-changes-2026-07-01๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

tool_addition์€ ์–ธ์ œ ๋„๊ตฌ๋ฅผ ์ธ๋ผ์ธ์œผ๋กœ ์ •์˜ํ•ด์•ผ ํ•˜๋‚˜์š”?

์ฒซ ์š”์ฒญ ์‹œ์ ์— ์•Œ ์ˆ˜ ์—†๋˜ ๋„๊ตฌ์ด๊ฑฐ๋‚˜, ์ดํ›„ ์Šคํ‚ค๋งˆ๊ฐ€ ๋ฐ”๋€Œ๋Š” ๋„๊ตฌ๋Š” ์ธ๋ผ์ธ์œผ๋กœ ์ •์˜ํ•˜์„ธ์š”. ์‹œ์ž‘๋ถ€ํ„ฐ ์ตœ์†Œ ํ•œ ๊ฐœ ์ด์ƒ์˜ ๋„๊ตฌ๋Š” ๋ณด์ด๋„๋ก ์œ ์ง€ํ•˜์„ธ์š”. ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด ์ฒซ ์ธ๋ผ์ธ ์ •์˜๊ฐ€ ์ „์ฒด ์บ์‹œ ๋ฏธ์Šค๋ฅผ ์œ ๋ฐœํ•ฉ๋‹ˆ๋‹ค.

Claude Sonnet 5.5์˜ effort๋ฅผ ๋ฐ”๊พธ๋ฉด ํ”„๋กฌํ”„ํŠธ ์บ์‹œ๊ฐ€ ์ดˆ๊ธฐํ™”๋˜๋‚˜์š”?

์ƒ์œ„ ์ˆ˜์ค€ effort ๋ณ€๊ฒฝ์€ ์š”์ฒญ์˜ ํ”„๋กฌํ”„ํŠธ ์ ‘๋‘๋ถ€๋ฅผ ๋ฐ”๊พธ๋ฏ€๋กœ ์บ์‹œ๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ์—ฌ๊ธฐ์„œ ์‚ฌ์šฉํ•œ ๋ฉ”์‹œ์ง€๋ณ„ output_config๋Š” ์ด์ „ ๋ฉ”์‹œ์ง€๋ฅผ ๋ณ€๊ฒฝํ•˜์ง€ ์•Š์œผ๋ฏ€๋กœ, ์บ์‹œ๋œ ์ ‘๋‘๋ถ€๊ฐ€ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค.

๋…๋ฆฝ ๊ฒ€์‚ฌ๊ฐ€ ๋‘ ๋ฒˆ ์‹คํŒจํ•˜๋ฉด ์–ด๋–ป๊ฒŒ ๋˜๋‚˜์š”?

์ฒซ ์‹คํŒจ ์‹œ Claude์—๊ฒŒ ๋‚จ์€ ์ฐจ์•ก์„ ์ „๋‹ฌํ•˜๊ณ  ์กฐ์‚ฌ ๋‹จ๊ณ„ ํ•œ ๋ฒˆ์„ ๋” ์—ฝ๋‹ˆ๋‹ค. ๋‘ ๋ฒˆ์งธ ์‹คํŒจ ์‹œ์—๋Š” ๋” ์ด์ƒ์˜ ์“ฐ๊ธฐ๋ฅผ ํ—ˆ์šฉํ•˜๊ฑฐ๋‚˜ ์ตœ์ข… ๋ณด๊ณ ๋ฅผ ๋ฐ›๋Š” ๋Œ€์‹  ํ”„๋กœ์„ธ์Šค๋ฅผ ์ค‘์ง€ํ•ฉ๋‹ˆ๋‹ค.

๋ชจ๋“  Claude Sonnet 5.5 ์—์ด์ „ํŠธ๊ฐ€ medium effort๋กœ ์‹œ์ž‘ํ•ด์•ผ ํ•˜๋‚˜์š”?

์•„๋‹™๋‹ˆ๋‹ค. Anthropic์€ ๋ช…ํ™•ํžˆ ์ •์˜๋œ ๋„๊ตฌ ์ž‘์—…์—๋Š” medium, ๋น ๋ฅธ ์‘๋‹ต์ด ํ•„์š”ํ•œ ์ฑ„ํŒ…์—๋Š” medium ๋˜๋Š” low, ๊ทธ ์™ธ์—๋Š” high๋ฅผ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. ์ˆ˜์ค€์€ Claude Sonnet 5์—์„œ ๋ณ€๊ฒฝ๋˜์—ˆ์œผ๋‹ˆ, ์ž‘์—… ๋ถ€ํ•˜์— ๋งž์ถฐ ๋‹ค์‹œ ํ‰๊ฐ€ํ•˜์„ธ์š”.

์ฃผ์ œ