SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

เปรียบเทียบเครื่องมือติดตามค่าใช้จ่าย Claude Code

เปรียบเทียบการทำงานของเครื่องมือติดตามค่าใช้จ่าย Claude Code ทั้ง 3 รูปแบบ ตั้งแต่การอ่าน log ในเครื่อง การดู dashboard ของ Anthropic ไปจนถึงการใช้ OpenTelemetry

สิ่งที่ตัวติดตามค่าใช้จ่ายของ Claude Code อ่านจริง ๆ

ตัวติดตามค่าใช้จ่ายของ Claude Code ทุกตัวจะอ่านข้อมูลจากแหล่งข้อมูลหนึ่งในสามแหล่ง และแหล่งข้อมูลนั้นจะเป็นตัวกำหนดว่าเครื่องมือจะตอบคำถามใดได้บ้าง ตัวแยกวิเคราะห์ log (log parser) จะอ่านไฟล์บันทึกเซสชันที่อยู่ในดิสก์ของคุณเอง ตัว dashboard จะอ่านบันทึกการใช้งานที่ Anthropic เก็บไว้สำหรับบัญชีหรือองค์กรของคุณ ส่วน metrics backend จะอ่านกระแสข้อมูล OpenTelemetry (OTel) ที่ Claude Code ส่งออกมาเมื่อคุณเปิดใช้งาน ทั้งสามแหล่งอาจถูกต้องพร้อมกันแต่ให้ตัวเลขไม่ตรงกันได้ เนื่องจากเป็นการนับข้อมูลคนละส่วนกัน

คู่มือนี้จะไม่กล่าวถึงเรื่อง token ซ้ำ วิธีที่ Claude Code นับการใช้งาน token ได้ครอบคลุมเรื่อง input, output, การเขียน cache และการอ่าน cache ไว้แล้ว และ dashboard จะไม่มีความหมายหากยังไม่เข้าใจส่วนนั้น คำถามในที่นี้จะแคบกว่า คือสำหรับเครื่องมือแต่ละรูปแบบ มันสามารถมองเห็นอะไรได้บ้าง และมีอะไรที่มันไม่มีทางมองเห็นได้เลย

เหตุใดตัวติดตามค่าใช้จ่ายของ Claude Code ถึงปรากฏขึ้นพร้อมกัน 3 รายการในวันเดียว

มีการเผยแพร่ตัวติดตามค่าใช้จ่ายของ Claude Code 3 รายการที่แยกจากกันในวันเดียวกัน เครื่องมือเหล่านี้ไม่ใช่เวอร์ชันของโปรแกรมเดียวกัน ซึ่งนั่นคือจุดที่เป็นประโยชน์ รายการแรกใช้วิธีแยกวิเคราะห์ไฟล์เซสชันในเครื่อง รายการที่สองใช้วิธีครอบหน้าจอการใช้งานบัญชี และรายการที่สามเป็นระบบติดตามแบบโฮสต์เองที่คุณต้องรันด้วยตนเอง

เครื่องมือเหล่านี้ปรากฏขึ้นพร้อมกันเนื่องจากค่าใช้จ่ายของเซสชันแบบเอเจนต์ไม่ได้เป็นสิ่งที่เห็นได้ชัดเจนอีกต่อไป การแชทปกติจะมีค่าใช้จ่ายใกล้เคียงกับสิ่งที่คุณเห็นบนหน้าจอ แต่เอเจนต์จะอ่านไฟล์ 20 ไฟล์ รันชุดทดสอบ และส่งบทสนทนาทั้งหมดซ้ำในทุกรอบการทำงาน ดังนั้นค่าใช้จ่ายจึงถูกขับเคลื่อนด้วยบริบทที่คุณไม่ได้พิมพ์เอง สำหรับการสมัครสมาชิก ตัวเลขดอลลาร์ของเซสชันที่ Claude Code แสดงเป็นเพียงการประมาณการซึ่ง Anthropic ระบุว่าไม่เกี่ยวข้องกับการเรียกเก็บเงินจริง ตัวเลขที่สำคัญคือแถบการใช้งานที่เต็มเร็วขึ้นในบางวันมากกว่าวันอื่น ตัวติดตามทั้ง 3 รูปแบบจึงเข้ามาเติมเต็มช่องว่างในส่วนที่ต่างกันออกไป

รูปแบบที่ 1: ตัวแยกวิเคราะห์ log ในเครื่องช่วยบอกค่าใช้จ่ายรายวัน

Claude Code จัดเก็บแต่ละบทสนทนาในรูปแบบ JSON Lines (JSONL) ไว้ที่ ~/.claude/projects/<project>/<session-id>.jsonl โดยที่ <project> คือ path ของไดเรกทอรีทำงานของคุณซึ่งอักขระที่ไม่ใช่ตัวอักษรหรือตัวเลขจะถูกแทนที่ด้วย - ทุกการโต้ตอบของผู้ช่วยในไฟล์นั้นจะมีจำนวน token ของคำขอระบุอยู่ ตัวแยกวิเคราะห์ log จะรวมจำนวนเหล่านั้นและคำนวณเป็นราคา

ccusage เป็นวิธีที่คนส่วนใหญ่เลือกใช้ ไม่จำเป็นต้องติดตั้ง:

npx ccusage@latest daily
npx ccusage@latest daily --breakdown
npx ccusage@latest blocks
npx ccusage@latest session --json

daily ใช้รวมยอดตามวันที่ --breakdown ใช้แยกแต่ละแถวตามโมเดล ซึ่งเป็นวิธีที่คุณจะพบว่าการใช้งาน Opus ในช่วงบ่ายเพียงครั้งเดียวอาจเป็นค่าใช้จ่ายส่วนใหญ่ของสัปดาห์ blocks ใช้จัดกลุ่มตามช่วงเวลา 5 ชั่วโมงที่การสมัครสมาชิกจะรีเซ็ต session ใช้รวมยอดต่อบทสนทนา และ daily --instances ใช้จัดกลุ่มตามโปรเจกต์เพื่อให้คุณเห็นว่า repository ใดมีค่าใช้จ่ายสูง เพิ่ม --since และ --until เพื่อกำหนดช่วงเวลา และรัน npx ccusage@latest daily --help สำหรับรูปแบบวันที่ที่เวอร์ชันของคุณรองรับ ณ เดือนตุลาคม 2026 เครื่องมือนี้ยังสามารถอ่าน CLI ของเอเจนต์อื่นได้ด้วย รวมถึง Codex และ OpenCode ซึ่งมีความสำคัญหากคุณกำลังเปรียบเทียบข้อมูล รายงานเริ่มต้นจะรวมแหล่งข้อมูลที่ตรวจพบทั้งหมดเข้าด้วยกัน ให้เพิ่ม claude ก่อน daily หรือ session เพื่อเน้นเฉพาะ Claude Code

การคำนวณราคามาจากตารางราคาโมเดล และเครื่องมือนี้มีโหมดค่าใช้จ่าย 3 โหมด --mode auto ใช้ค่า costUSD ที่ Claude Code เขียนลงในไฟล์เมื่อมีข้อมูลดังกล่าว และคำนวณจากจำนวน token ในกรณีที่ไม่มีข้อมูล --mode calculate จะคำนวณจาก token เสมอและเพิกเฉยต่อค่าใช้จ่ายที่บันทึกไว้ --mode display จะแสดงเฉพาะค่าใช้จ่ายที่บันทึกไว้และพิมพ์ $0.00 สำหรับแถวที่ไม่มีข้อมูล หากยอดรวมดูไม่ถูกต้อง ให้รันรายงานเดิมภายใต้ calculate แล้วตามด้วย display ช่องว่างขนาดใหญ่ระหว่างสองค่านี้หมายความว่ารายการส่วนใหญ่ไม่มีการบันทึกค่าใช้จ่ายไว้ ดังนั้นทุกสิ่งที่คุณกำลังอ่านเป็นเพียงการประมาณการ หากคุณจ่ายในอัตราตามสัญญา ให้ใช้ pricingOverrides ภายใต้ defaults ในไฟล์ config ccusage.json เพื่อแทนที่ราคาสำหรับโมเดลแต่ละตัว

ข้อมูลเดียวกันนี้สามารถนำไปใช้ใน prompt ของคุณได้ ccusage statusline จะพิมพ์บรรทัดขนาดกะทัดรัดสำหรับแถบสถานะของ Claude Code ซึ่งเชื่อมต่อเข้ากับ ~/.claude/settings.json เช่นเดียวกับคำสั่งบรรทัดสถานะอื่นๆ ดู การสร้างบรรทัดสถานะ Claude Code สำหรับบล็อกการตั้งค่าและฟิลด์ที่ได้รับ

สิ่งที่ตัวแยกวิเคราะห์ log มองไม่เห็นคือสิ่งที่ไม่ได้เกิดขึ้นบนเครื่องนี้ แล็ปท็อปเครื่องที่สอง, เซสชันบน claude.ai, หรือการทำงานของเพื่อนร่วมงาน: บันทึกเหล่านั้นจะอยู่ในดิสก์ของเครื่องนั้นๆ เซสชัน terminal เก่าจะถูกล้างออกหลังจากไม่มีการใช้งานครบ 30 วันโดยค่าเริ่มต้นภายใต้ cleanupPeriodDays แต่สามารถกำหนดค่าการเก็บรักษาได้: ให้ใช้ค่าที่มาก เช่น 3650 เพื่อเก็บประวัติย้อนหลังหลายปี บันทึกของเซสชันที่เริ่มต้นหรือดำเนินการต่อล่าสุดใน Desktop หรือ Cowork จะถูกเก็บไว้นานกว่าระยะเวลานั้นโดยค่าเริ่มต้น โดยมีข้อยกเว้น เช่น การกำหนดค่า HIPAA

มีความเสี่ยงอีกประการหนึ่งซึ่งเป็นเรื่องของโครงสร้าง เอกสารของ Anthropic ระบุว่ารูปแบบรายการข้อมูลเป็นเรื่องภายในของ Claude Code และมีการเปลี่ยนแปลงระหว่างเวอร์ชัน ดังนั้นสคริปต์ที่แยกวิเคราะห์ไฟล์เหล่านี้โดยตรงอาจใช้งานไม่ได้เมื่อมีการปล่อยเวอร์ชันใหม่ ซึ่งใช้กับเครื่องมือทุกตัวในรูปแบบนี้ และนี่คือเหตุผลว่าทำไมการเขียน jq แบบบรรทัดเดียวด้วยตัวเองเพื่อจัดการกับ JSONL จึงเป็นความคิดที่ไม่ดีนัก: ตัวแยกวิเคราะห์ที่ได้รับการดูแลรักษาจะคอยติดตามการเปลี่ยนแปลงรูปแบบให้คุณ และบรรทัดเดียวที่คุณเขียนไว้จะรายงานตัวเลขที่ผิดพลาดอย่างมั่นใจในวันที่ฟิลด์ถูกเปลี่ยนชื่อ

สุดท้าย ตัวเลขดอลลาร์ต้องมีข้อควรระวังสำหรับการสมัครสมาชิก การใช้งานภายในขีดจำกัดของแผน Pro หรือ Max จะไม่ถูกเรียกเก็บเงินต่อ token ดังนั้นตัวเลขที่ได้คือราคาที่ token ของคุณจะมีมูลค่าหากคิดตามอัตรา API ปกติ มันเป็นตัววัดว่าการใช้งานของคุณหนักเพียงใด ไม่ใช่ใบแจ้งหนี้ของคุณ ข้อยกเว้นคือเครดิตการใช้งาน: หากคุณเปิดใช้งาน การใช้งานที่เกินขีดจำกัดของแผนจะถูกเรียกเก็บเงินตามอัตรา API มาตรฐานเป็นค่าใช้จ่ายแยกต่างหาก และ claude.ai จะแสดงยอดใช้จ่ายของเดือนนั้นภายใต้ Settings > Usage หากคำถามที่แท้จริงคือควรใช้แผนใด การเปรียบเทียบนั้นเป็นอีกหัวข้อหนึ่ง: ดู การเรียกเก็บเงิน API เทียบกับการสมัครสมาชิก Claude

รูปแบบที่ 2: หน้าจอแสดงการใช้งานในตัวช่วยบอกว่าโมเดลใดเป็นตัวใช้จ่ายงบประมาณ

Claude Code มาพร้อมกับระบบรายงานในตัวซึ่งผู้ใช้ส่วนใหญ่ไม่เคยเปิดดู ให้รันคำสั่ง /usage ภายในเซสชัน บล็อก Session ที่ด้านบนจะแสดงจำนวนโทเค็นแยกตามโมเดลและมูลค่าเป็นดอลลาร์สำหรับเซสชันปัจจุบัน ซึ่งคำนวณจากจำนวนโทเค็นในเครื่องตามอัตรามาตรฐาน เว้นแต่ผู้ดูแลระบบจะตั้งค่าตาราง modelPricing ไว้ในการตั้งค่าแบบจัดการ (managed settings) ซึ่งในกรณีนั้นบรรทัด Total cost จะแสดงข้อความ at your organization's configured rates ไม่ว่ากรณีใด ตัวเลขนี้เป็นเพียงการประมาณการซึ่งอาจแตกต่างจากใบแจ้งหนี้จริง และสำหรับแผน Pro หรือ Max ทาง Anthropic ระบุว่าตัวเลขนี้ไม่มีผลต่อการเรียกเก็บเงินเนื่องจากมีการรวมการใช้งานดังกล่าวไว้ในแผนแล้ว ยอดรวมจะถูกรีเซ็ตเมื่อ /clear เริ่มการสนทนาใหม่

สำหรับแผน Pro, Max, Team หรือ Enterprise แบบคิดตามจำนวนที่นั่ง หน้าจอเดียวกันจะแสดงปริมาณการใช้งานที่ใช้ไปเทียบกับขีดจำกัดของแผน แผน Enterprise แบบคิดตามการใช้งานจริง (usage-based) จะไม่มีโควตาที่ต้องกังวลว่าจะหมด เนื่องจากทุกโทเค็นจะถูกเรียกเก็บเงินตามอัตรา API สำหรับแผนเหล่านี้ หน้าจอยังแสดงการจำแนกการใช้งานล่าสุดตามทักษะ (skills), subagents, ปลั๊กอิน และ MCP servers แต่ละตัว โดยคิดเป็นเปอร์เซ็นต์ของยอดรวม ระบบจะแจ้งเตือนพฤติกรรมที่คิดเป็น 10% หรือมากกว่าของการใช้งานล่าสุด เช่น บริบทที่ยาวเกินไปหรือการพลาดแคช (cache misses) กด d หรือ w เพื่อสลับระหว่างช่วง 24 ชั่วโมงล่าสุดและ 7 วันล่าสุด ตัวเลขเหล่านี้เป็นค่าประมาณที่คำนวณจากประวัติเซสชันในเครื่องนี้เท่านั้น ดังนั้นการใช้งานบนอุปกรณ์เครื่องที่สองจะไม่ถูกนับรวม เมื่อโควตาเต็ม Claude Code จะระบุขีดจำกัดและแสดงเวลาที่จะรีเซ็ต แถบการใช้งานที่ว่างเปล่าไม่ได้หมายความว่าโควตาเต็ม เซสชันสามารถรอและดำเนินการต่อได้หลังจากรีเซ็ต และ สิ่งที่ควรทำเมื่อถึงขีดจำกัด เป็นการตัดสินใจแยกต่างหากเกี่ยวกับโมเดล บริบท และแผนการใช้งาน

เมื่อมีนักพัฒนามากกว่าหนึ่งคน ตัวเลขจะเปลี่ยนไปอยู่ในระดับบัญชี องค์กรที่ใช้ API จะได้รับหน้า Console Cost ซึ่งเป็นแดชบอร์ดของ Claude Code ที่แสดงค่าใช้จ่ายและจำนวนบรรทัดที่ยอมรับต่อสมาชิก รวมถึง Claude Code Analytics API ที่ส่งคืนเมตริกรายวันต่อผู้ใช้ด้วยคีย์ผู้ดูแลระบบ แผน Team และ Enterprise จะได้รับรายงานค่าใช้จ่ายในคอนโซลผู้ดูแลระบบพร้อมตัวเลือกส่งออกเป็น CSV ซึ่งอัปเดตทุกวัน โดยครอบคลุมทั้งการใช้เครดิตในแผนแบบคิดตามที่นั่งและการใช้งานเต็มรูปแบบในแผน Enterprise แบบคิดตามการใช้งานจริง ส่วนแผน Enterprise จะมี Analytics API เพิ่มเติม สิ่งที่คุณเห็นจะขึ้นอยู่กับวิธีการลงชื่อเข้าใช้ของนักพัฒนาแต่ละคน ดังนั้นองค์กรแบบผสมจะต้องอ่านรายงานสองชุดและรวมตัวเลขด้วยตนเอง

สำหรับการวางแผนงบประมาณ ตัวเลขที่เผยแพร่ในเอกสารด้านต้นทุนของ Anthropic ณ เดือนตุลาคม 2026 คือค่าเฉลี่ยประมาณ 13 ดอลลาร์ต่อนักพัฒนาต่อวันที่มีการใช้งาน และ 150 ถึง 250 ดอลลาร์ต่อนักพัฒนาต่อเดือน โดย 90% ของผู้ใช้มีค่าใช้จ่ายต่ำกว่า 30 ดอลลาร์ต่อวันที่มีการใช้งาน ให้ถือว่าตัวเลขนี้เป็นเกณฑ์มาตรฐานจากการใช้งานจริงในระดับองค์กร ไม่ใช่การคาดการณ์สำหรับทีมของคุณ ควรเริ่มจากกลุ่มนำร่องและวัดผลก่อนที่จะสรุปตัวเลขในภาพรวม

สิ่งที่แดชบอร์ดไม่สามารถมองเห็นได้คือรายละเอียดที่ต่ำกว่าระดับวันและระดับบุคคล แดชบอร์ดจะบอกคุณว่าโมเดล Opus ถูกใช้งานมากที่สุดในวันอังคาร แต่จะไม่บอกว่า prompt ใด, repository ใด หรือ CI job ใดที่เป็นสาเหตุ นอกจากนี้ยังมีอาการหน่วงเนื่องจากรายงานขององค์กรอัปเดตเป็นรายวัน ดังนั้นจึงเป็นเครื่องมือสำหรับทบทวนย้อนหลังมากกว่าที่จะเป็นวิธีหยุดยั้งเอเจนต์ที่ทำงานผิดปกติในทันที การหยุดยั้งเอเจนต์ที่ทำงานผิดปกติจำเป็นต้องใช้การจำกัด (limits) ไม่ใช่รายงาน ซึ่งเป็นหัวข้อของ การควบคุมค่าใช้จ่ายของเอเจนต์บน VPS

รูปแบบที่ 3: การใช้ OpenTelemetry stack ของคุณเองเพื่อระบุว่า prompt ใดที่ประสิทธิภาพลดลง

Claude Code จะส่งข้อมูล metrics และ events ของ OpenTelemetry ออกมาเมื่อคุณเปิดใช้งาน telemetry และกำหนดค่า exporters นี่เป็นทางเลือกเดียวที่สามารถสตรีมข้อมูลจำนวน token และค่าใช้จ่ายรายผู้ใช้เข้าสู่ระบบที่คุณควบคุมได้แบบเกือบเรียลไทม์ โดย metrics เหล่านี้ประกอบด้วย claude_code.cost.usage ในหน่วย USD, claude_code.token.usage ในหน่วย token, claude_code.session.count และ claude_code.active_time.total

metric ของ token เป็นสิ่งที่น่าสนใจเนื่องจากมี attributes ที่เฉพาะตัว ข้อมูลแต่ละจุดจะมี type ซึ่งระบุว่าเป็น input, output, cacheRead หรือ cacheCreation รวมถึง model และ query_source ซึ่งระบุว่าเป็น main, subagent หรือ auxiliary นอกจากนี้ยังมี agent.name, skill.name, mcp_server.name และ mcp_tool.name ชื่อของ MCP servers ที่คุณกำหนดค่าเองและ subagents ที่คุณสร้างขึ้นจะถูกส่งมาเป็น custom เว้นแต่คุณจะตั้งค่า OTEL_LOG_TOOL_DETAILS=1 ซึ่งจะเพิ่มคำสั่ง Bash และข้อมูล input ของเครื่องมือเข้าไปในเหตุการณ์ของเครื่องมือด้วย ข้อมูลเหล่านี้เพียงพอที่จะตอบคำถามที่ dashboard ทั่วไปทำไม่ได้ เช่น ค่าใช้จ่ายส่วนที่เป็นของ subagents เทียบกับส่วนที่เป็นการใช้งานของคุณเอง, MCP server ตัวใดที่ทำให้ input tokens เพิ่มขึ้นเป็นสองเท่า, หรือการอ่าน cache ลดลงหลังจากมีการแก้ไขไฟล์ CLAUDE.md หรือไม่ พฤติกรรมของ cache มักเป็นจุดที่พบความผิดปกติได้บ่อย และ เมื่อการทำ prompt caching คุ้มค่ากับต้นทุน จะอธิบายสิ่งที่คุณกำลังตรวจสอบอยู่

มีข้อควรแก้ไขหนึ่งประการที่ควรทราบ เนื่องจากเป็นประเด็นที่พบได้บ่อย Langfuse เป็น tracing backend ที่ดีสำหรับการ self-host และการรันบน VPS ได้อธิบายไว้ใน การ self-host Langfuse สำหรับการทำ agent tracing โดย OTLP endpoint ของ Langfuse จะรับเฉพาะ traces เท่านั้น ตามค่าเริ่มต้น Claude Code จะส่งออก metrics และ log events ไม่ใช่ spans ดังนั้นการชี้ OTEL_EXPORTER_OTLP_ENDPOINT ไปที่ Langfuse จะทำให้โปรเจกต์ว่างเปล่าและไม่แสดงข้อผิดพลาดใดๆ ที่เป็นประโยชน์ การส่งออก span สามารถทำได้แต่ยังอยู่ในสถานะเบต้าและจะปิดใช้งานอยู่จนกว่าคุณจะตั้งค่า CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 และ OTEL_TRACES_EXPORTER การเชื่อมต่อ Claude Code เข้ากับ Langfuse โดยตรงใช้วิธีที่ต่างออกไป คือการใช้ Stop hook หรือปลั๊กอินที่ติดตั้ง hook ดังกล่าว เพื่ออ่านบันทึกการสนทนาหลังจากการตอบกลับแต่ละครั้งแล้วแปลงเป็น traces ซึ่งจะมีข้อจำกัดแบบเดียวกับการใช้ log parser ที่ทำงานเฉพาะในเครื่อง Langfuse เป็นเครื่องมือที่เหมาะสมสำหรับ agents ที่คุณสร้างขึ้นบน API ด้วยตนเอง ซึ่งโค้ดของคุณจะเป็นผู้สร้างแต่ละ span พร้อมกับระบุ prompt, model และค่าใช้จ่าย สำหรับยอดรวมการใช้งานจาก Claude Code CLI นั้น การใช้ metrics store จะเหมาะสมกว่า

การตั้งค่าการติดตามค่าใช้จ่ายของ Claude Code บน VPS ของคุณเอง

ใช้เพียงสองบริการก็เพียงพอแล้ว ได้แก่ collector สำหรับรับข้อมูลเมตริก และ Prometheus สำหรับจัดเก็บข้อมูล ให้เก็บทั้งสองบริการไว้ไม่ให้เข้าถึงได้จากอินเทอร์เน็ตสาธารณะ เนื่องจากพอร์ต OTLP ที่เปิดทิ้งไว้จะยอมรับการเขียนข้อมูลจากใครก็ตามที่พบพอร์ตนั้น ให้เขียน /opt/ccmetrics/compose.yaml:

services:
  collector:
    image: otel/opentelemetry-collector-contrib:latest
    command: ["--config=/etc/otel/config.yaml"]
    volumes:
      - ./collector.yaml:/etc/otel/config.yaml:ro
    ports:
      - "10.8.0.1:4318:4318"
    restart: unless-stopped
  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
      - prom-data:/prometheus
    ports:
      - "127.0.0.1:9090:9090"
    restart: unless-stopped

volumes:
  prom-data:

10.8.0.1 คือที่อยู่ของเซิร์ฟเวอร์ภายในอุโมงค์ WireGuard เพื่อให้ collector สามารถเข้าถึงได้จากเครื่องของคุณเท่านั้นและจากที่อื่นไม่ได้ ที่อยู่หน้าพอร์ตมีผลสำคัญในที่นี้ เนื่องจากพอร์ตที่เผยแพร่ผ่าน Docker จะไม่ถูกกรองโดย ufw: ดู เหตุใดพอร์ตที่เผยแพร่โดย Docker จึงข้าม ufw การตั้งค่าอุโมงค์ VPN สามารถดูได้ที่ การทำ WireGuard VPN บน VPS ของคุณเอง

/opt/ccmetrics/collector.yaml:

receivers:
  otlp:
    protocols:
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:

exporters:
  prometheus:
    endpoint: 0.0.0.0:8889

service:
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [prometheus]

/opt/ccmetrics/prometheus.yml พอร์ต 8889 จะไม่ถูกเผยแพร่ไปยังโฮสต์ เนื่องจาก Prometheus จะเข้าถึง collector ผ่านเครือข่าย Compose โดยใช้ชื่อบริการ:

global:
  scrape_interval: 30s

scrape_configs:
  - job_name: claude-code
    static_configs:
      - targets: ["collector:8889"]
cd /opt/ccmetrics
docker compose up -d
docker compose logs collector

log ของ collector ควรลงท้ายด้วย Everything is ready. Begin running and processing data. หาก log หยุดลงที่ข้อผิดพลาดในการตั้งค่า แสดงว่า YAML ไม่สามารถ parse ได้ และ container จะรีสตาร์ทวนซ้ำ

จากนั้นให้ชี้ Claude Code ไปที่บริการนี้ ในแต่ละเครื่องที่รัน Claude Code ให้เพิ่มสิ่งนี้ลงใน ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "none",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://10.8.0.1:4318",
    "OTEL_METRIC_EXPORT_INTERVAL": "10000"
  }
}

เริ่มเซสชัน ส่ง prompt หนึ่งรายการ รอจนครบช่วงเวลาการส่งออก (ในที่นี้คือ 10 วินาที โดยค่าเริ่มต้นคือ 60 วินาที) จากนั้นสอบถาม Prometheus ว่าได้รับข้อมูลอะไรบ้าง:

curl -s http://localhost:9090/api/v1/label/__name__/values | grep -o 'claude_code[a-z_]*'

คุณควรได้รับชื่อหลายรายการที่ขึ้นต้นด้วย claude_code_ ตัว exporter จะเปลี่ยนจุดเป็นขีดล่างและต่อท้ายด้วยหน่วยวัด ดังนั้นสตริงที่แน่นอนจะขึ้นอยู่กับเวอร์ชันของ collector ของคุณ หากผลลัพธ์ว่างเปล่าแสดงว่าไม่มีข้อมูลส่งเข้ามา ตรวจสอบว่าโปรโตคอลและพอร์ตตรงกัน เนื่องจาก http/protobuf ใช้พอร์ต 4318 และ grpc ใช้พอร์ต 4317 หากไม่ตรงกันจะเกิดความล้มเหลวโดยไม่มีการแจ้งเตือน ให้รัน claude --debug-file /tmp/claude-debug.log และดูในไฟล์นั้นเพื่อหาบรรทัด [3P telemetry] ซึ่งเป็นจุดที่ Claude Code รายงานข้อผิดพลาดในการส่งออก OTel

สำหรับกรณีที่มีเครื่องเดียวและไม่มีเซิร์ฟเวอร์ ให้ข้ามขั้นตอนทั้งหมดข้างต้น ตั้งค่า CLAUDE_CODE_ENABLE_TELEMETRY=1 และ OTEL_METRICS_EXPORTER=prometheus แล้ว Claude Code จะเปิด scrape endpoint ที่ http://localhost:9464/metrics ด้วยตัวเอง เมื่อ prometheus เป็น exporter รายการเดียวที่ระบุไว้ Claude Code จะละเว้นหน่วย USD, tokens และ s ออกจากเมตริกที่ส่งออก เพื่อให้ scrape ยังคงอยู่ในรูปแบบข้อความ Prometheus ที่ถูกต้อง ชื่อเมตริกจะไม่เปลี่ยนแปลง และการตั้งค่าที่รวม exporter หลายตัวเข้าด้วยกัน เช่น otlp,prometheus จะยังคงรักษาหน่วยวัดไว้

การตัดสินใจเรื่องความเป็นส่วนตัวประการหนึ่งมาพร้อมกับรูปแบบนี้ โดยค่าเริ่มต้นจะมีเพียงจำนวนนับและ metadata เท่านั้นที่ออกจากเครื่อง จะไม่มีข้อความ prompt และไม่มีผลลัพธ์จากเครื่องมือ OTEL_LOG_USER_PROMPTS=1 จะเพิ่มข้อความ prompt ลงในเหตุการณ์ที่ส่งออกและเปิดใช้งานข้อความตอบกลับของผู้ช่วยด้วย เว้นแต่ OTEL_LOG_ASSISTANT_RESPONSES=0 จะกำหนดค่าไว้เป็นอย่างอื่น OTEL_LOG_TOOL_CONTENT=1 จะเพิ่มผลลัพธ์ของเครื่องมือที่เลือกเข้าไปใน trace spans โดยมีการยกเว้นและตัดทอนที่ขีดจำกัดเนื้อหา (ค่าเริ่มต้นคือ 60 KB) แฟล็กเหล่านี้อาจเปิดเผยซอร์สโค้ดและข้อมูลลับในเนื้อหาที่เลือกได้ โดยแฟล็กเหล่านี้ไม่ได้ส่งออกทุกอย่างในบริบทโดยอัตโนมัติ เนื้อหาการสนทนาฉบับเต็มต้องใช้การตั้งค่า OTEL_LOG_RAW_API_BODIES แยกต่างหาก โปรดเปิดใช้งานสิ่งเหล่านี้อย่างตั้งใจ และอ่าน การเก็บข้อมูลลับไม่ให้หลุดไปในบริบทของเอเจนต์ ก่อนดำเนินการ

การติดตามค่าใช้จ่ายสำหรับการรันด้วยสคริปต์และ CI

การรันแบบไม่โต้ตอบเป็นกรณีที่ทำให้เกิดค่าใช้จ่ายโดยไม่ทันสังเกต เพราะไม่มีใครเฝ้าดูหน้าจอ claude -p ที่ใช้ร่วมกับ --output-format json จะรายงานค่าใช้จ่ายของการรันนั้นใน result payload:

claude -p "summarise the failing tests" --output-format json | jq '.total_cost_usd'

payload จะมี total_cost_usd พร้อมรายละเอียดแยกตามโมเดล ดังนั้นงาน CI จึงบันทึกค่าใช้จ่ายของตนเองได้โดยไม่ต้องใช้ dashboard เช่นเดียวกับตัวเลขที่คำนวณภายในเครื่องทั้งหมด ค่านี้เป็นเพียงค่าประมาณจากฝั่ง client และการรันที่ดำเนิน conversation ต่อกับ --continue หรือ --resume จะรายงานยอดรวมของ conversation ทั้งหมด รวมการรันก่อนหน้านี้ด้วย ให้เขียนค่าดังกล่าวต่อท้ายไฟล์ หรือส่งค่าเป็น metric ไปยัง collector ด้านบน วิธีนี้เป็นการติดตามค่าใช้จ่ายที่มีประโยชน์และมีต้นทุนต่ำที่สุด โดยใช้การเรียก jq 1 ครั้งต่อการรัน unerquicklich

รูปแบบความล้มเหลวและสิ่งที่คุณจะพบ

รายงานว่างเปล่า npx ccusage@latest daily การไม่แสดงแถวข้อมูลหมายความว่าโปรแกรมไม่ได้อ่านข้อมูลจากตำแหน่งที่ Claude Code เขียนไว้ CLAUDE_CONFIG_DIR จะเปลี่ยนตำแหน่งดังกล่าว และ ccusage ก็อ่านตัวแปรนั้นเช่นกัน ดังนั้นให้รันทั้งสองคำสั่งด้วยค่าเดียวกัน หากเซสชันเก่าหายไป ให้ตรวจสอบ cleanupPeriodDays โดยปกติแล้วเซสชันในเทอร์มินัลจะถูกลบออกหลังจากไม่มีการใช้งานครบ 30 วัน ในขณะที่บันทึกการสนทนาจาก Desktop และ Cowork มักจะถูกเก็บไว้นานกว่านั้น

เครื่องสองเครื่องรายงานยอดรวมไม่ตรงกัน เป็นเรื่องปกติและไม่ใช่ข้อผิดพลาด การแจกแจงของ /usage และตัวแยกวิเคราะห์ log ทั้งหมดจะอ่านเฉพาะประวัติเซสชันในเครื่องเท่านั้น ดังนั้นการใช้งานจากอุปกรณ์อื่นหรือจาก claude.ai จึงไม่ปรากฏในทั้งสองกรณี

ยอดรวมในเครื่องไม่ตรงกับใบแจ้งหนี้ ตัวเลขในเครื่องจะคำนวณจากจำนวนโทเค็นตามอัตรามาตรฐาน เว้นแต่คุณจะตั้งค่าอัตราตามสัญญาไว้ โดยใช้ตาราง modelPricing ในการตั้งค่าที่มีการจัดการสำหรับ /usage หรือใช้ pricingOverrides สำหรับ ccusage หากคุณใช้การสมัครสมาชิก การใช้งานภายในขีดจำกัดของแผนจะไม่ถูกเรียกเก็บเงินตามจำนวนโทเค็น แต่จะหักจากเครดิตการใช้งานเท่านั้น หน้า Cost ใน Console ถือเป็นข้อมูลอ้างอิงหลักสำหรับการเรียกเก็บเงินผ่าน API

ค่าใช้จ่ายเพิ่มขึ้นในขณะที่คุณทำงานเดิม ให้ตรวจสอบคอลัมน์ cache ก่อนเป็นอันดับแรก เซสชันที่ยาวจะส่งประวัติทั้งหมดซ้ำในทุกรอบการสนทนา โดยจะคิดราคาตามอัตรา cache ในขณะที่ cache ยังทำงานอยู่ และคิดราคา input เต็มจำนวนเมื่อ cache หมดอายุ ดังนั้นการหยุดพักนานเพียงครั้งเดียวจะทำให้ระบบต้องประมวลผลการสนทนาทั้งหมดใหม่ ซึ่งจะแสดงเป็นตัวเลข input จำนวนมากเทียบกับตัวเลข output จำนวนน้อย และ การกำหนดราคาโทเค็น input เทียบกับ output จะอธิบายว่าเหตุใดทั้งสองค่าจึงเปลี่ยนแปลงอย่างเป็นอิสระต่อกัน

วันที่มีการใช้งาน subagents ดูเป็นไปไม่ได้ subagent แต่ละตัวจะรัน context window ของตัวเอง ดังนั้นการใช้โทเค็นจะเพิ่มขึ้นตามจำนวน subagent ที่รันและระยะเวลาที่แต่ละตัวทำงาน ในแผนการใช้งาน /usage จะแสดงส่วนแบ่งของ subagent สำหรับเครื่องนี้เป็นเปอร์เซ็นต์ สำหรับรายละเอียดในแต่ละคำขอ ข้อมูล OTel จะแยกส่วน subagent ออกผ่านแอตทริบิวต์ query_source บน claude_code.token.usage ตัวแยกวิเคราะห์ log จะแสดงให้คุณเห็นเพียงยอดรวมและทิ้งให้คุณต้องคาดเดาเอง

FAQ

ccusage แสดงยอดที่ฉันต้องจ่ายจริงสำหรับแผน Max หรือไม่?

ไม่แสดง การใช้งานที่อยู่ภายใต้ขีดจำกัดของแผนสมาชิกจะไม่ถูกคิดเงินตามจำนวน token ดังนั้นตัวแยกวิเคราะห์ log จึงคำนวณราคา token ของคุณตามอัตรามาตรฐานของ API และแสดงให้เห็นว่างานเดียวกันนี้จะมีค่าใช้จ่ายเท่าใดหากทำผ่าน API ซึ่งเป็นตัวชี้วัดเปรียบเทียบที่ดีว่าในแต่ละวันมีการใช้งานหนักเพียงใด และมีประโยชน์สำหรับการเปรียบเทียบโครงการหรือโมเดลต่างๆ สำหรับยอดที่คุณต้องชำระจริง หน้า Console Cost จะครอบคลุมการเรียกเก็บเงินของ API และหน้าการเรียกเก็บเงินของแผนสมาชิกจะครอบคลุมการสมัครสมาชิก หากคุณเปิดใช้งานเครดิตการใช้งาน การใช้งานที่เกินขีดจำกัดจะถูกคิดเงินตามอัตรามาตรฐานของ API และ claude.ai จะแสดงยอดใช้จ่ายนั้นภายใต้ Settings > Usage

Claude Code จัดเก็บไฟล์เซสชันที่เครื่องมือเหล่านี้อ่านไว้ที่ไหน?

จัดเก็บไว้ใน ~/.claude/projects/<project>/<session-id>.jsonl โดยที่ <project> คือพาธของไดเรกทอรีทำงานที่แทนที่อักขระที่ไม่ใช่ตัวอักษรหรือตัวเลขด้วย - แต่ละบรรทัดเป็นวัตถุ JSON สำหรับข้อความหนึ่งรายการ การใช้เครื่องมือ หรือรายการข้อมูลเมตา CLAUDE_CONFIG_DIR จะย้ายไดเรกทอรีทั้งหมด และ cleanupPeriodDays ใน settings.json จะควบคุมการเก็บรักษาข้อมูล ซึ่งโดยปกติจะตั้งค่าเริ่มต้นไว้ที่ 30 วันหากไม่มีการใช้งานสำหรับเซสชันเทอร์มินัล ส่วนบันทึกของ Desktop และ Cowork มักจะถูกเก็บไว้นานกว่านั้น Anthropic ระบุว่ารูปแบบรายการข้อมูลเป็นรูปแบบภายในและอาจมีการเปลี่ยนแปลงระหว่างเวอร์ชัน ดังนั้นควรแยกวิเคราะห์ด้วยเครื่องมือที่มีการดูแลรักษาแทนการเขียนสคริปต์ด้วยตนเอง

ฉันสามารถส่ง telemetry ของ Claude Code ไปยัง Langfuse ได้หรือไม่?

ไม่สามารถทำได้ด้วย telemetry ค่าเริ่มต้น Langfuse OTLP endpoint รองรับ traces และโดยปกติแล้ว Claude Code จะส่งออกเป็น metrics และ log events แทนที่จะเป็น spans ข้อมูลจึงไม่มีปลายทางรองรับ การส่งออก span เป็นฟีเจอร์เบต้าที่คุณต้องเปิดใช้งานเอง และการเชื่อมต่อ Claude Code ของ Langfuse เองจะใช้ Stop hook ที่แปลงบันทึกเซสชันให้เป็น traces แทน สำหรับยอดรวมการใช้จ่าย ให้ส่ง metrics ของ Claude Code ไปยัง OpenTelemetry collector และจัดเก็บไว้ใน Prometheus ให้ใช้ Langfuse สำหรับเอเจนต์ที่คุณสร้างขึ้นเองบน API ซึ่งโค้ดของคุณจะส่ง spans ที่มี prompt, โมเดล และต้นทุนออกมา

ทำไมตัวเลขในเครื่องของฉันถึงไม่ตรงกับหน้าการใช้งานใน Console?

เนื่องจากมีการคำนวณที่แตกต่างกัน /usage และตัวแยกวิเคราะห์ log จะรวมจำนวน token จากไฟล์เซสชันบนเครื่องที่คุณใช้งาน จากนั้นจึงคำนวณราคาตามอัตรามาตรฐาน เว้นแต่จะมีการกำหนดอัตราตามสัญญาไว้ผ่าน modelPricing ในการตั้งค่าที่มีการจัดการสำหรับ /usage หรือ pricingOverrides สำหรับ ccusage ส่วน Console จะครอบคลุมการใช้งานขององค์กรคุณในทุกเครื่องและทุกคีย์ ให้ใช้หน้า Cost ของ Console สำหรับต้นทุน API จริง เนื่องจากตัวเลขการใช้จ่ายในแดชบอร์ดการวิเคราะห์ของ Claude Code เป็นเพียงการประมาณการ ความคลาดเคลื่อนเป็นเรื่องปกติ หากมีความคลาดเคลื่อนสูงมาก มักหมายความว่ามีอุปกรณ์เครื่องที่สอง, CI runner หรือสมาชิกในทีมคนอื่นกำลังเรียกเก็บเงินเข้าบัญชีเดียวกัน

ฉันจะติดตามต้นทุนของการรัน claude -p ใน CI ได้อย่างไร?

ให้รันด้วย --output-format json และอ่านค่า total_cost_usd จากผลลัพธ์ ตัวอย่างเช่นใช้ claude -p "..." --output-format json | jq '.total_cost_usd' ข้อมูลชุดเดียวกันนี้จะรวมรายละเอียดแยกตามโมเดลและ ID ของเซสชัน ให้บันทึกค่าดังกล่าวต่อหนึ่งงาน แล้วคุณจะได้ยอดใช้จ่ายต่อไปป์ไลน์โดยไม่ต้องพึ่งพาเอเจนต์ แดชบอร์ด หรือบริการเพิ่มเติมใดๆ

บทความนี้มีประโยชน์หรือไม่