วิธีบันทึกเซสชัน Claude Code และเอเจนต์อื่นๆ ทั้งหมดที่ไม่ยอมให้ความร่วมมือ: คู่มือภาคสนามเชิงปฏิบัติ

ใช่: คุณสามารถบันทึกเซสชัน Claude Code ได้ในวันนี้ และสิ่งที่คุณได้คือทุกอย่าง (ทุกเทิร์นของโมเดล ทุกการเรียกใช้เครื่องมือ ทุกไฟล์ที่เอเจนต์แตะต้อง) ในรูปแบบที่คุณสามารถเล่นซ้ำได้ นั่นคือคำตอบแบบสั้น และมันเป็นจริงในวันนี้ คำตอบแบบยาวคือ ความสามารถในการบันทึกนั้นถูกกำหนดต่อแฮร์เนส โดยมีคำถามสองข้อ: แฮร์เนสสามารถชี้ไปที่พร็อกซีได้หรือไม่ และรูปแบบ wire format ของมันเป็นที่เข้าใจเมื่อทราฟฟิกมาถึงหรือไม่ Claude Code ผ่านทั้งสองข้อ และ Codex CLI ที่ลงชื่อเข้าใช้ด้วยคีย์ API ก็ผ่านเช่นกัน เอเจนต์ที่มี URL ของผู้ให้บริการถูกฮาร์ดโค้ดไว้ในซอร์ส เอเจนต์ที่รันในคอนเทนเนอร์หรือบน VPS และแฮร์เนสที่ลงชื่อเข้าใช้ด้วยการสมัครสมาชิก ต่างก็ใช้เส้นทางที่แตกต่างกัน และหนึ่งในนั้น ในวันนี้ ไม่มาถึง

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

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

อะไรเป็นตัวกำหนดว่าฮาร์เนสสามารถถูกบันทึกได้หรือไม่?

คำถามแนว "ช่วยอัดให้หน่อยได้ไหม" ทุกคำถามจะลดรูปเหลือเพียงคำถามเดียวกันสองข้อเท่านั้น

ข้อแรก: ฮาร์เนสสามารถกำหนดให้ชี้ไปที่พร็อกซีได้หรือไม่? สี่วิธีครอบคลุมเรื่องนี้ โดยเรียงตามลำดับความสะดวกจากมากไปน้อย

• ตัวแปร base-URL. เส้นทางที่สร้างขึ้นสำหรับสิ่งนี้: ฮาร์เนสจะอ่านตัวแปรสภาพแวดล้อม base-URL และคุณเป็นผู้ตั้งค่า

• การสร้างแฮร์เนสด้วยตนเอง กระบวนการลูกจะสืบทอดสภาพแวดล้อมจากกระบวนการแม่ ดังนั้นเกตเวย์ที่สร้างเอเจนต์เขียนโค้ดก็จะถูกดักจับด้วยเช่นกัน โดยไม่ต้องอาศัยความร่วมมือจากเอเจนต์

• การสกัดกั้น TLS: สำหรับฮาร์เนสที่ไม่อ่านคอนฟิกใดๆ เลย ตัวบันทึกจะเรียกใช้เอเจนต์ และคุณเลือกที่จะให้มีการสกัดกั้น

• แนบ.เมื่อเอเจนต์ทำงานในที่ที่เครื่องบันทึกไม่สามารถเปิดใช้มันได้ สิ่งที่เหลืออยู่คือการแนบ

หากไม่มีกรณีใด ๆ เหล่านั้นใช้ได้ ทราฟฟิกจะไม่ไปถึงเครื่องบันทึก และก็ไม่มีอะไรต้องพูดคุยกัน

ประการที่สอง: เมื่อทราฟฟิกมาถึง รูปแบบสายส่ง (wire format) ของมันเป็นที่เข้าใจหรือไม่? การจับไบต์ไม่ใช่ตัวผลิตภัณฑ์ ตัวบันทึกจะต้องรู้จักบทสนทนาที่มันทำหน้าที่แทนอยู่ รวมถึงรูปร่างของการเรียกใช้เครื่องมือ (tool-call shapes) เฟรมสตรีมมิง และการลองใหม่ มิฉะนั้นการบันทึกนั้นก็เป็นเพียง pcap ไม่ใช่การเล่นซ้ำ รูปแบบที่ตัวบันทึกเข้าใจจะสร้างเซสชันที่คุณสามารถเล่นซ้ำได้ ส่วนภาษาถิ่นเฉพาะตัวจะให้เพียงสิ่งที่จับมาได้ซึ่งคุณได้แต่มองดู

คำตอบจะแตกต่างกันไปตามแต่ละฮาร์เนส และยังต่างกันในรายละเอียดที่ทำผิดพลาดได้ง่าย: มันคือบทเรียนเดียวกันกับที่ได้จากการเปรียบเทียบว่าฮาร์เนสของ DeepSeek แตกต่างจาก Claude Code อย่างไร ส่วนที่เหลือของบทความนี้จะแสดงให้เห็นว่าคำถามสองข้อนี้มีหน้าตาเป็นอย่างไรเมื่อคุณรันฮาร์เนสจริง ๆ

Claude Code, Codex CLI และ Agents SDK

Claude Code คือเกณฑ์มาตรฐานที่สิ่งอื่นๆ ทั้งหมดถูกนำมาเทียบวัด เพราะมันอ่านค่าตัวแปรANTHROPIC_BASE_URL จากนั้นก็ตั้งตัวแปรนั้นให้ชี้ไปที่ตัวบันทึก เริ่มเอเจนต์ แล้วเซสชันก็จะถูกส่งมาทีละเทิร์น: โพรอมป์ การเรียกใช้เครื่องมือ การแก้ไขไฟล์ และคำตอบของโมเดลที่แทรกอยู่ระหว่างนั้น เราได้ทดสอบแบบ end-to-end กับกรณีการแก้บั๊กจริง (รีพอซิทอรีจริง จุดบกพร่องจริง และเซสชันที่ดำเนินตั้งแต่โพรอมป์แรกจนถึงการแก้ไขที่ใช้งานได้จริง) และเอเจนต์จริงตัวแรกนั้นก็ทำให้เกิดข้อผิดพลาดสี่อย่างที่ไม่มีฟิกซ์เจอร์ตัวใดเคยสร้างมาก่อน ทั้งสี่อย่างได้รับการแก้ไขเรียบร้อยแล้ว ซึ่งถ้าพูดกันตรงๆ ก็คือ ทราฟฟิกสังเคราะห์ไม่ได้ช่วยเตรียมคุณให้พร้อมสำหรับสิ่งที่เอเจนต์จริงจะทำเมื่อมันถูกปล่อยให้อยู่กับโค้ดเบสตามลำพัง

Codex CLI ที่เข้าสู่ระบบด้วยคีย์ API ก็เป็นเรื่องเดียวกันเมื่อใช้งานผ่าน OPENAI_BASE_URL โดยชี้ไปที่ตัวบันทึก แล้วคุณก็จะได้เซสชันนั้น และไม่มีอะไรอื่นเกี่ยวกับวิธีใช้แฮร์เนสของคุณที่เปลี่ยนไป

เอเจนต์เชิงโปรแกรมได้รับเส้นทางที่ง่ายที่สุด กระบวนการลูกสืบทอดสภาพแวดล้อมจากกระบวนการแม่ ดังนั้นเกตเวย์ที่สร้างเอเจนต์เขียนโค้ดจึงถูกจับภาพไปด้วยโดยไม่ต้องอาศัยความร่วมมือจากเอเจนต์ ตั้งค่าตัวแปร base-URL ครั้งเดียวในกระบวนการที่ทำการสร้าง แล้วทุกเอเจนต์ที่มันเปิดตัวจะมายังตัวบันทึกได้เอง หากคุณรันเอเจนต์จาก CI จากออร์เคสเตรเตอร์ หรือผ่าน Agents SDK นี่คือเส้นทางที่คุณอยู่แล้ว

ในทุกกรณีเหล่านี้ ตัวบันทึกคือ OrcaReplay มันติดตั้งด้วย npm i -g orcareplay และต้องใช้ Node 20 ขึ้นไป และไม่มีดีเพนเดนซีแบบเนทีฟ ไม่มีอะไรต้องคอมไพล์ ไม่มีอะไรต้องบิลด์ มันจับทราฟฟิกเอเจนต์เดียวกันกับที่ OrcaRouter ส่งผ่าน แคตตาล็อกโมเดลของ OrcaRouter.

เอเจนต์ที่ไม่อ่านตัวแปร base-URL

ฮาร์เนสบางตัวกำหนด URL ของผู้ให้บริการแบบตายตัวไว้ในซอร์สโค้ดของพวกมัน ไม่มีตัวแปรสภาพแวดล้อม ไม่มีไฟล์คอนฟิก ไม่มีแฟล็ก. การตั้งค่า ANTHROPIC_BASE_URL ไม่ได้ทำอะไรเลย เพราะไม่มีอะไรอ่านมัน ถ้าตัวบันทึกสามารถเรียกใช้เอเจนต์ได้ ก็ยังมีหนทางอยู่ และหนทางนั้นคือสิ่งที่ผู้คนกังวลมากที่สุด: การสกัดกั้น TLS

การเลือกเข้าร่วมก็คือการเลือกเข้าร่วมจริง ๆ กล่าวคือโดยค่าเริ่มต้นแล้วระบบจะปิดฟีเจอร์นี้ไว้ เมื่อคุณเปิดใช้งานสำหรับการรันครั้งหนึ่ง ตัวบันทึก (recorder) จะสร้างหน่วยงานออกใบรับรอง (certificate authority) ที่ไม่ซ้ำกับสำหรับการรันนั้น และหน่วยงานดังกล่าวจะถูกไว้วางใจโดยเอเจนต์ (agent) ที่ตัวบันทึกเปิดใช้งานเท่านั้น กล่าวคือมันจะถูกส่งมอบให้กับกระบวนการเดียวเท่านั้น ไม่ได้ถูกติดตั้งในคีย์เชนของระบบคุณ และไม่ถูกทิ้งไว้สำหรับการรันครั้งถัดไป เมื่อการรันสิ้นสุดลง หน่วยงานนั้นจะถูกลบทิ้ง เอเจนต์จะเชื่อมต่อไปยังโฮสต์ที่กำหนดตายตัวเหมือนที่เคยทำมาโดยตลอด ตัวบันทึกจะเป็นฝ่ายตอบรับ และเซสชันก็จะเกิดขึ้นราวกับว่า URL นั้นสามารถกำหนดค่าได้อยู่แล้วตั้งแต่แรก

สิ่งที่เส้นทางจงใจปฏิเสธนั้นสำคัญพอ ๆ กับสิ่งที่มันทำจริง ๆ มันอ่านเฉพาะโฮสต์ในรายการอนุญาตของมันเท่านั้น ไม่มีอะไรอื่นนอกเหนือจากนั้น โฮสต์ที่อยู่นอกรายการอนุญาตจะถูกส่งผ่านทันเนลโดยไม่ถูกอ่าน และถูกบันทึกเพียงเป็นที่อยู่กับจำนวนไบต์ ซึ่งเป็นหลักฐานว่าเอเจนต์ได้ติดต่อกับบางสิ่ง โดยไม่มีการบันทึกสิ่งที่พูดคุยกันแม้แต่ไบต์เดียว ขอบเขตนั้นคือการตัดสินใจเชิงออกแบบ ไม่ใช่ข้อจำกัดที่เรายังไม่ได้จัดการ ระเบียบวินัยเดียวกันนี้แทรกซึมอยู่ในไฟร์วอลล์เอเจนต์ของ OrcaRouter โดยที่รายการอนุญาตคือผลิตภัณฑ์ ไม่ใช่ผลพลอยได้จากการบันทึก

ข้อแม้คือสิ่งเดียวกับคำถามแรก: การดักจับจะทำงานเมื่อตัวบันทึกเปิดตัวเอเจนต์ เอเจนต์ที่กำลังรันอยู่ในคอนเทนเนอร์อยู่แล้วไม่เคยได้รับ certificate authority ของรอบการรันนั้น และมันจะไม่เชื่อถือคำตอบของตัวบันทึก

เอเจนต์ที่ไม่ได้อยู่บนเครื่องนี้

คอนเทนเนอร์มีสภาพแวดล้อมของตัวเอง ตัวแปร base-URL ที่คุณตั้งไว้ในเชลล์ไม่สามารถเข้าถึงภายในนั้นได้ และตัวบันทึกบนโฮสต์ไม่สามารถเปิดกระบวนการที่อยู่ที่อื่นอยู่แล้ว เช่น บน VPS, ใน CI, ในแซนด์บ็อกซ์ที่แฮร์เนสสร้างขึ้นโดยไม่ถามคุณ การจับภาพแบบอาศัยการเปิดกระบวนการล้มเหลวตรงนี้ไม่ใช่เพราะเอเจนต์ยาก แต่เพราะตัวบันทึกไม่มีโอกาสได้แตะต้องมันเลย

สำหรับกรณีนี้โดยเฉพาะ มี orca attach ซึ่งบันทึกเอเจนต์ที่ตัวบันทึกไม่สามารถเริ่มได้ เช่น เอเจนต์ในคอนเทนเนอร์หรือบน VPS โดยทิศทางจะกลับกัน: แทนที่ตัวบันทึกจะเริ่มเอเจนต์และส่งมอบสภาพแวดล้อมให้กับมัน orca attach จะเชื่อมต่อกับเอเจนต์ที่กำลังทำงานอยู่แล้วและบันทึกมัน

สิ่งที่ attach ไม่ได้ทำคือการตอบคำถามที่สองให้คุณ มันจัดการส่งทราฟฟิกไปยังตัวบันทึกได้ ส่วนทราฟฟิกนั้นจะกลายเป็นเซสชันที่คุณเล่นซ้ำได้หรือไม่ ยังคงขึ้นอยู่กับว่าตัวบันทึกเข้าใจรูปแบบ wire format หรือไม่ แนบเอเจนต์ที่พูดรูปแบบที่ตัวบันทึกรู้จัก คุณก็จะได้เซสชันที่เล่นซ้ำได้ แนบเอเจนต์ที่ไม่พูดรูปแบบนั้น คุณก็จะพบกำแพง ซึ่งการพบกำแพงโดยตั้งใจมีค่าใช้จ่ายถูกกว่าการพบกลางเหตุการณ์

การเข้าสู่ระบบแบบสมาชิกเปลี่ยนแปลงอะไรบ้าง?

ไบนารีเดียวกันนี้สามารถบันทึกได้หรือไม่ได้ ขึ้นอยู่กับวิธีที่มันลงชื่อเข้าใช้ Codex CLI ที่ลงชื่อเข้าใช้ด้วยคีย์ API จะถูกจับผ่าน OPENAI_BASE_URL: ชี้มันไปที่ตัวบันทึก แล้วคุณก็เสร็จเรียบร้อย ลงชื่อเข้าใช้ CLI ตัวเดียวกันด้วยการสมัครสมาชิก ChatGPT แล้วมันจะหยุดติดต่อกับ endpoint นั้นโดยสิ้นเชิง มันจะติดต่อกับ backend ของตัวเอง โดยยืนยันตัวตนเป็นคุณ และไม่มี origin ให้เขียนทับใหม่ ตัวแปร base-URL ยังคงมีอยู่ แต่ไม่ว่าคุณจะชี้มันไปที่ใด สิ่งนั้นก็จะไม่กลายเป็นบริการที่ harness ใช้จริง

นี่คือคำถามที่สองที่ล้มเหลว ไม่ใช่คำถามแรก ไบต์สามารถถูกทำให้เคลื่อนที่ได้ ตัวบันทึกยังมองเห็นมันได้ด้วยซ้ำ แต่บทสนทนานี้ถูกส่งไปยังแบ็กเอนด์ที่ตัวบันทึกไม่สามารถทำหน้าที่แทนได้ ในโฟลว์ที่ไม่ใช่ API ที่ตัวบันทึกใช้สื่อสาร จึงไม่มีการรีเพลย์ให้สร้างขึ้น เพราะไม่มีต้นทางที่ตัวบันทึกจะกลายเป็นได้

สำหรับฮาร์เนสที่ลงชื่อเข้าใช้ด้วยการสมัครสมาชิก คำตอบที่ตรงไปตรงมาในปัจจุบันก็คือ มันไม่สามารถบันทึกได้ และบทเรียนที่มีประโยชน์ก็คือ วิธีการลงชื่อเข้าใช้เป็นส่วนหนึ่งของการตัดสินใจเรื่องความสามารถในการบันทึก หากคุณต้องการบันทึกสำหรับงานประเมินหรือสำหรับร่องรอยการตรวจสอบ ให้รันเซสชันที่บันทึกไว้โดยใช้คีย์ API และเก็บการสมัครสมาชิกไว้สำหรับงานแบบโต้ตอบ — วิธีเปลี่ยนเซสชันที่บันทึกไว้ให้กลายเป็นการประเมินการถดถอย ครอบคลุมวงรอบนั้นตั้งแต่ต้นจนจบ และก่อนที่คุณจะเลือกใช้ฮาร์เนสใดเป็นมาตรฐาน ให้ถามคำถามสองข้อนั้นกับมันก่อน เราทำเช่นนั้นกับทุกฮาร์เนสเสมอ ล่าสุดกับฮาร์เนส Prime Agent.

ข้อสรุป

คุณสามารถบันทึกเซสชัน Claude Code ได้ในวันนี้ด้วยคำสั่งเดียวและตัวแปรสภาพแวดล้อมตัวเดียว:

• npm i -g orcareplay

• ชี้ ANTHROPIC_BASE_URL ไปที่เครื่องบันทึก

• รันเอเจนต์

Codex CLI ที่ใช้ API key ก็ยังอยู่ห่างเท่าเดิม URL ที่เขียนตายตัวทำให้คุณต้องเลือกยอมรับการดักจับ TLS ซึ่งอ่านได้เฉพาะรายการอนุญาต (allowlist) ของมันเท่านั้น (เป็นแนวปฏิบัติเดียวกันกับที่ไฟร์วอลล์เอเจนต์ของ OrcaRouter บังคับใช้) และจะไม่เก็บใบรับรองของตัวเองไว้อีกเมื่อการรันสิ้นสุดลง คอนเทนเนอร์หรือ VPS จะทำให้คุณต้องรัน orca attach. การเข้าสู่ระบบด้วยบัญชีแบบสมัครสมาชิกจะทำให้คุณสูญเสียตัวการบันทึกนั่นเอง: ฮาร์เนสดังกล่าวจะไม่ถูกบันทึก และการกำหนดค่าใดๆ ก็ไม่สามารถเปลี่ยนแปลงสิ่งนั้นได้ในวันนี้

ภาพรวมของการตัดสินใจทั้งหมด:

• Claude Code — คีย์ API สำหรับลงชื่อเข้าใช้ เทียบกับ เส้นทางไปยังตัวบันทึก ANTHROPIC_BASE_URL เทียบกับ บันทึกได้ในวันนี้ ใช่

• Codex CLI — คีย์ API สำหรับเข้าสู่ระบบ เทียบกับ เส้นทางไปยังตัวบันทึก OPENAI_BASE_URL เทียบกับ บันทึกได้ในวันนี้: ใช่

• ฮาร์เนสที่ฝัง URL ผู้ให้บริการไว้ตายตัว — การลงชื่อเข้าใช้แบบใดก็ได้ เทียบกับ เส้นทางไปยังตัวบันทึก การดักจับ TLS แบบเลือกเข้าร่วม, ที่เริ่มต้นโดยตัวบันทึก เทียบกับ บันทึกได้ในวันนี้ ใช่

• เอเจนต์ในคอนเทนเนอร์หรือบน VPS — ลงชื่อเข้าใช้จากที่ใดก็ได้ เทียบกับ การกำหนดเส้นทางไปยังตัวบันทึก orca attach เทียบกับ บันทึกได้ในปัจจุบัน: ได้ หากทราบรูปแบบ wire

• Codex CLI — การเข้าสู่ระบบ: การสมัครสมาชิก ChatGPT เทียบกับ เส้นทางไปยังตัวบันทึก: ไม่มี เทียบกับ บันทึกได้ในวันนี้: ไม่

แถวสุดท้ายเป็นเพียงชุดค่าผสมเดียวเท่านั้นที่ไม่มีเส้นทางไปยังเครื่องบันทึกเลย

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

หมายเหตุแหล่งข้อมูล: พฤติกรรมและตัวเลขทุกอย่างในบทความนี้ (เส้นทางจับภาพ `ANTHROPIC_BASE_URL` และ `OPENAI_BASE_URL`, ปัญหาหลังฟิกซ์เจอร์สี่กรณีและแนวทางแก้ไข, วงจรชีวิตใบรับรอง TLS, พฤติกรรม allowlist-and-tunnel, `orca attach` และข้อกำหนดการติดตั้ง) มาจากการตรวจสอบด้วยตนเองบนแฮร์เนสที่ระบุชื่อไว้ ล่าสุดเมื่อวันที่ 2026-09-04 เราไม่อ้างอิงเกณฑ์มาตรฐานจากบุคคลที่สาม เนื่องจากเราไม่ได้รันเกณฑ์มาตรฐานใด ๆ