Codex เป็นลูป: มันแก้ไขไฟล์, รันคำสั่ง, อ่านเอาต์พุต และตัดสินใจว่าจะทำอะไรต่อไป แล้วทำไมการทดสอบ API ของคุณจึงไม่อยู่ในลูปนั้นล่ะ? พวกมันอยู่ใน Apidog หลัง GUI, ทำงานเมื่อมีคนจำได้ที่จะคลิก เอเจนต์ของคุณไม่เคยแตะต้องพวกมันเลย
วิธีแก้ไขคือบล็อกการกำหนดค่าเพียงหนึ่งบล็อก Apidog CLI เป็นแพ็คเกจ npm, apidog-cli, ที่รันสถานการณ์การทดสอบที่คุณสร้างใน Apidog ได้โดยตรงจากเทอร์มินัล เมื่อติดตั้ง CLI แล้วและ Codex ทราบว่ามีอยู่ เอเจนต์ของคุณจะรันสถานการณ์ Apidog ในลักษณะเดียวกับการรันการทดสอบหน่วยของคุณ: เรียกใช้คำสั่ง, อ่านรหัสออก, แก้ไขโค้ดหากเป็นสีแดง
คู่มือนี้ครอบคลุมส่วนที่เฉพาะเจาะจงของ Codex ที่คู่มือการติดตั้งทั่วไปข้ามไป: บรรทัดที่แน่นอนสำหรับ AGENTS.md ของคุณ, พร้อมต์ที่จะส่งให้ Codex, วิธีที่มันรัน apidog run ภายในลูปของตัวเอง และวิธีอ่านผลลัพธ์
หากคุณยังไม่ได้ติดตั้ง CLI ให้ทำสิ่งนั้นก่อน วิธีติดตั้ง Apidog CLI ด้วยเอเจนต์โค้ดดิ้ง AI จะแนะนำการติดตั้ง npm, โทเค็นการเข้าถึง และการรันครั้งแรก โดยมี Codex เป็นผู้พิมพ์ บทความนี้สมมติว่า apidog --version พิมพ์ตัวเลขและบัญชี Apidog ของคุณได้รับการยืนยันสิทธิ์แล้ว
Codex ที่พูดถึงนี้คืออะไร
ทั้ง OpenAI Codex CLI และแอป Codex มันทำงานแบบโลคอล, อ่านรีโพซิโทรีของคุณ, แก้ไขไฟล์ และรันคำสั่งเชลล์ภายในแซนด์บ็อกซ์ โดยจะขอการอนุมัติขึ้นอยู่กับโหมดสิทธิ์ของคุณ มันไม่ใช่ API การเติมโค้ด Codex แบบเก่า หากคุณรัน codex แล้วได้อินเทอร์เฟซเต็มหน้าจอที่แสดงความแตกต่างและเอาต์พุตคำสั่ง คุณมาถูกที่แล้ว คู่มือ OpenAI Codex CLI ครอบคลุมพื้นฐาน
ความแตกต่างนี้สำคัญเพราะ Codex มีวิธีเรียนรู้กฎของโปรเจกต์ในแบบของมันเอง และกลไกนั้นเปลี่ยนคำสั่ง "รันการทดสอบของฉัน" แบบครั้งเดียวให้กลายเป็นสิ่งที่ Codex ทำได้ด้วยตัวเอง กลไกนั้นคือ AGENTS.md
กลไก: AGENTS.md ไม่ใช่การเตือนในแชท
Codex อ่านไฟล์ AGENTS.md ก่อนที่จะเริ่มทำงาน ลองคิดว่ามันเหมือน CLAUDE.md สำหรับ Claude Code: ไฟล์ Markdown ธรรมดาที่ประกอบด้วยคำแนะนำโปรเจกต์ที่ Codex โหลดเข้าสู่บริบทเมื่อเริ่มต้นทุกเซสชัน มันสร้างชุดคำสั่งโดยการเดินจาก root ของ Git ของคุณลงไปยังไดเรกทอรีปัจจุบันของคุณ, โดยต่อไฟล์ AGENTS.md แต่ละไฟล์จาก root ก่อน, ดังนั้นไฟล์ที่ใกล้กว่าจึงมีผลเมื่อเกิดความขัดแย้ง นอกจากนี้ยังมี ~/.codex/AGENTS.md แบบทั่วโลก สำหรับวัตถุประสงค์ของเรา ไฟล์เดียวที่ root ของ repo ก็เพียงพอแล้ว
นี่คือเหตุผลที่คุณเขียน CLI ลงใน AGENTS.md แทนที่จะพูดถึงมันในแชท ID สถานการณ์ที่พิมพ์ลงในแชทจะหายไปเมื่อเซสชันสิ้นสุดลง สิ่งที่อยู่ใน AGENTS.md จะอยู่ตรงนั้นสำหรับเพื่อนร่วมทีมทุกคนและทุกการรัน Codex นับจากนี้เป็นต้นไป
ขั้นตอนที่ 1: ให้พร้อมต์แก่ Codex และดูมันทำงาน
เมื่อบล็อกอยู่กับที่แล้ว ให้เริ่ม Codex ใน repo ของคุณ:
Codex โหลด AGENTS.md เมื่อมันเริ่มทำงาน ดังนั้นมันจึงรู้แล้วว่า CLI อยู่ตรงนั้น ทำการเปลี่ยนแปลงที่เกี่ยวข้องกับ API ของคุณ หรือขอให้มันรันการตรวจสอบ:
Codex ออกคำสั่ง apidog run จาก AGENTS.md ของคุณ ในโหมด Auto เริ่มต้น มันสามารถอ่านไฟล์, แก้ไขไฟล์ และรันคำสั่งภายในไดเรกทอรีการทำงานได้ด้วยตัวเอง ดังนั้น apidog run แบบธรรมดามักจะทำงานโดยไม่ต้องมีพร้อมต์ ตัวรายงาน -r cli จะพิมพ์ผลลัพธ์และสรุปแบบทีละขั้นตอนลงในเทอร์มินัล ซึ่งคุณสามารถดูคำขอและแอสเสิร์ทแต่ละรายการได้ในขณะที่มันเกิดขึ้น
คุณต้องการเห็นการรันที่กำลังทำงานและ Codex รายงานทั้งสรุปและรหัสออก หากโหมดสิทธิ์ของคุณเป็น Read-only, Codex จะหยุดชั่วคราวและถามก่อนที่จะรัน; อนุมัติ หรือเปลี่ยนโหมดด้วย /permissions ภายในเซสชัน โหมด Auto เป็นค่าเริ่มต้นที่เหมาะสม เนื่องจากสถานการณ์การทดสอบแบบอ่านอย่างเดียวกับสภาพแวดล้อม staging เป็นคำสั่งที่ปลอดภัยและทำงานภายในพื้นที่ที่โหมดนี้สร้างขึ้นมาเพื่อมัน
ขั้นตอนที่ 2: การทดสอบ Codex ภายในลูปของตัวเอง
ประเด็นคือจะเกิดอะไรขึ้นเมื่อคุณหยุดถามและ Codex รันสถานการณ์ด้วยตัวเองเพราะ AGENTS.md สั่งให้ทำ
ลองจินตนาการถึง Codex ที่กำลังแก้ไข handler ที่สร้างการตอบสนองการชำระเงิน ลูปของมันเปลี่ยนไป: มันแก้ไขโค้ด, จากนั้น แทนที่จะประกาศชัยชนะ มันจะรันสถานการณ์ Apidog ของคุณกับสภาพแวดล้อม staging, อ่านรหัสออก, และดำเนินการตามนั้น ถ้าเขียว, มันจะไปต่อ ถ้าแดง, มันจะเปิดรายงาน, อ่านว่าแอสเสิร์ทใดล้มเหลว (รหัสสถานะ, ฟิลด์ที่หายไป, ค่าที่ไม่ถูกต้อง), ลองแก้ไข, และรันใหม่ การทดสอบ API กลายเป็นส่วนหนึ่งของลูปแก้ไข-ทดสอบ-แก้ไขแบบเดียวกันที่ Codex ใช้รันการทดสอบหน่วยของคุณอยู่แล้ว คุณเขียนคำสั่งเดียว และ Codex ได้รวมคำสั่งนั้นเข้ากับวิธีการทำงานของมันแล้ว
นี่คือโมเดลการมอบหมายแล้วตรวจสอบ (delegate-then-verify) ที่ทำให้เวิร์กโฟลว์ของเอเจนต์ปลอดภัย Codex รันคำสั่งและอ่านผลลัพธ์ คุณยังคงสร้างสถานการณ์ด้วยสายตาใน Apidog และตรวจสอบว่าเอเจนต์อ่านรหัสออกอย่างตรงไปตรงมา สำหรับรูปแบบที่กว้างขึ้น โปรดดู วิธีใช้เอเจนต์ AI สำหรับการทดสอบ API และ ชุดทดสอบ AI ของ Apidog
ยืนยันว่า Codex กำลังรัน CLI จริงๆ
เอเจนต์รายงานความสำเร็จที่พวกเขาไม่ได้ทำ และ Codex ก็ไม่มีข้อยกเว้น มีการตรวจสอบสามข้อเรียงตามลำดับความบ่อยที่พวกมันตรวจพบปัญหา
ประการแรก ยืนยันว่าคำสั่งได้ทำงานจริงหรือไม่ อินเทอร์เฟซ Codex จะแสดงคำสั่งที่ดำเนินการและเอาต์พุตของมันแบบอินไลน์ มองหาบรรทัด apidog run ... และผลลัพธ์ภายใต้บรรทัดนั้น หาก Codex บอกว่าได้รันการทดสอบแต่คุณไม่เห็นคำสั่ง นั่นหมายความว่ามันสรุปสิ่งที่มันไม่เคยทำ ขอให้มันรันอีกครั้งและแสดงเอาต์พุตดิบ
ประการที่สอง ยืนยันรหัสออก ซึ่งเป็นสิ่งสำคัญ:
รหัสออกของคำสั่ง apidog run นั้นคืออะไร?
apidog run จะออกด้วย 0 เมื่อทุกแอสเสิร์ทผ่าน และไม่ใช่ศูนย์เมื่อมีสิ่งใดล้มเหลว พฤติกรรมเดียวนี้ทำให้ Codex หรือไปป์ไลน์ สามารถถือว่าการรันนั้นเป็นประตูที่สะอาด เมื่อข้อความของ Codex บอกว่า “tests passed” แต่รหัสออกไม่ใช่ศูนย์ รหัสออกนั้นถูกต้อง
ประการที่สาม ยืนยันว่ามันใช้สถานการณ์จริง หากการรันล้มเหลวด้วยข้อความ “scenario not found” Codex อาจสร้างหรือจำ ID ผิด ตรวจสอบค่า -t และ -e อีกครั้งกับ AGENTS.md และคำสั่งที่ Apidog สร้างในแท็บ CI/CD ID ใน AGENTS.md คือความจริง
การอ่านรายงานผลการทดสอบ
เมื่อการรันเป็นสีแดง รายงานจะมีคำตอบ ด้วย -r cli, Codex จะได้รับรายละเอียดที่อ่านง่ายในเทอร์มินัล: แต่ละคำขอ, แต่ละแอสเสิร์ท, และอันไหนที่ล้มเหลวพร้อมค่าที่คาดหวังเทียบกับค่าจริง แอสเสิร์ทที่ล้มเหลวจะระบุชื่อฟิลด์หรือรหัสสถานะที่แน่นอน ซึ่งมักจะเพียงพอสำหรับ Codex ที่จะหาวิธีแก้ไข
สำหรับรายงานที่คุณสามารถเปิดในเบราว์เซอร์หรือส่งให้เพื่อนร่วมทีม ให้เพิ่มตัวรายงาน HTML
ตัวรายงาน html จะเขียนไฟล์ที่สมบูรณ์ในตัวเองไปยัง ./apidog-reports เก็บ cli ไว้ในรายการเพื่อให้ Codex ยังคงได้รับเอาต์พุตแบบอินไลน์ที่มันอ่านเพื่อตัดสินใจขั้นตอนต่อไป สำหรับทุกแฟล็กและตัวรายงาน รวมถึงรูปแบบ JUnit ที่แดชบอร์ด CI แยกวิเคราะห์ได้ โปรดดู คู่มือ Apidog CLI ฉบับสมบูรณ์ และ การอ้างอิงคำสั่ง apidog run
สองวิธีที่จะเจาะลึกยิ่งกว่าคำสั่งเชลล์
การรัน apidog run จาก AGENTS.md ครอบคลุมสิ่งที่คุณต้องการส่วนใหญ่ มีสองเส้นทางที่จะไปได้ไกลกว่านั้น
อย่างแรกคือ MCP Codex รองรับ Model Context Protocol และคุณสามารถเพิ่มเซิร์ฟเวอร์ด้วย codex mcp add หรือโดยการแก้ไข ~/.codex/config.toml ด้วยบล็อก [mcp_servers.NAME] เซิร์ฟเวอร์ Apidog MCP เปิดเผยข้อมูลจำเพาะ API ของคุณผ่าน MCP ดังนั้น Codex สามารถอ่านสคีมาของคุณในขณะที่มันเขียนโค้ด ไม่ใช่แค่หลังจากนั้น CLI รันการทดสอบ; MCP ป้อนข้อมูลจำเพาะให้กับเอเจนต์
อย่างที่สองคือ codex exec ซึ่ง codex ธรรมดาจะเปิดอินเทอร์เฟซแบบโต้ตอบ แต่ codex exec "..." จะรัน Codex แบบไม่โต้ตอบและส่งผลลัพธ์ไปยัง stdout ซึ่งเป็นสิ่งที่คุณต้องการในสคริปต์และ CI หากต้องการรัน apidog run ในไปป์ไลน์โดยไม่มี Codex อยู่ด้วย Apidog CLI ใน GitHub Actions ครอบคลุมเรื่อง secrets, reporters และ exit-code gating
เมื่อ Codex ทำผิดพลาด
ความผิดพลาดบางอย่างมักเกิดขึ้นบ่อยครั้งระหว่างการตั้งค่า
มันละเลยบล็อก AGENTS.md หาก Codex รันคำสั่งทั่วไปหรือไม่รันเลย บล็อกนั้นอาจไม่ถูกโหลด ยืนยันว่าไฟล์ชื่อ AGENTS.md อย่างถูกต้องและอยู่ใน Git root ของคุณหรือไดเรกทอรีแม่ของไดเรกทอรีปัจจุบันของคุณ การพิมพ์ชื่อไฟล์ผิดหมายความว่า Codex จะไม่อ่านมันเลย; การรีสตาร์ทเซสชันจะบังคับให้มีการอ่านใหม่
มันส่ง access token ไปอยู่ดี. หาก Codex พยายามเพิ่ม --access-token แสดงว่ามันเดามาจากตัวอย่างสาธารณะ บล็อกได้บอกมันแล้วว่าไม่ต้องทำ เนื่องจากเครื่องได้รับการยืนยันสิทธิ์ผ่าน apidog login ย้ำบรรทัดนั้นอีกครั้ง และอย่าใส่โทเค็นจริงใน AGENTS.md เด็ดขาด
มันสร้างแฟล็กขึ้นมาเอง. ข้อผิดพลาด "unknown option" หมายความว่า Codex เดาแฟล็กที่เวอร์ชันของคุณไม่มี บอกให้มันรัน apidog run --help และคัดลอกแฟล็กที่ถูกต้องจากที่นั่น ซึ่งจะถูกต้องเสมอสำหรับเวอร์ชันที่คุณติดตั้งไว้
มันรายงานว่าผ่านในการรันที่ล้มเหลว. นี่คือข้อผิดพลาดที่แพงที่สุด และเป็นเหตุผลที่กฎรหัสออกอยู่ใน AGENTS.md ของคุณและขั้นตอนการยืนยันของคุณ เมื่อสรุปและรหัสออกไม่ตรงกัน รหัสออกคือสิ่งที่ถูกต้อง
จากเอเจนต์รายวันสู่ลูปที่ผ่านการทดสอบ
นั่นคือการตั้งค่า ติดตั้ง apidog-cli เพียงครั้งเดียวตาม คู่มือการติดตั้ง เพิ่มบล็อก Apidog สั้นๆ ลงใน AGENTS.md ของ repo ของคุณ และ Codex จะรู้วิธีรันการทดสอบ API ของคุณและอ่านผลลัพธ์ภายในลูปเดียวกับที่มันใช้แก้ไขโค้ดอยู่แล้ว จุดสิ้นสุดที่เสียจะถูกตรวจพบในขณะที่ Codex ยังคงทำงานกับการเปลี่ยนแปลง ไม่ใช่หลังจากที่ส่งมอบไปแล้ว
การทดสอบที่อยู่หลัง GUI จะทำงานเมื่อมนุษย์คลิก; คำสั่งบรรทัดเดียวจะทำงานเมื่อใดก็ตามที่ Codex ตัดสินใจ คุณยังคงสร้างสถานการณ์ด้วยสายตาใน Apidog และเอเจนต์ของคุณจะรันมันในที่ที่คุณไม่ได้ดูอยู่ ดาวน์โหลด Apidog, สร้างสถานการณ์หนึ่ง, วางคำสั่ง apidog run ของมันลงใน AGENTS.md และดู Codex หยิบมันขึ้นมาในการเปลี่ยนแปลงครั้งต่อไป