การตั้งค่าขั้นสูง

Profiles

Profiles ช่วยให้คุณบันทึก named configuration layers และสลับระหว่างกันโดยใช้ --profile profile-name ไฟล์ profile อยู่ที่ ~/.codex/profile-name.config.toml และ override base user config ของคุณ

One-off CLI Overrides

ช่วยให้คุณเปลี่ยนการตั้งค่าสำหรับการรันครั้งเดียวโดยไม่ต้องแก้ไขไฟล์ config ใช้ flags เฉพาะเช่น --model gpt-5.4 หรือใช้ -c / --config สำหรับ key overrides ทั่วไปที่ parse เป็น TOML

Project Config Files

ไฟล์ .codex/config.toml ใน repository ให้ repo-scoped overrides Codex จะเดินจาก project root ไปยัง current directory และโหลดทุก config file ที่พบ ไฟล์ที่อยู่ใกล้ที่สุดจะชนะหากหลายไฟล์กำหนด key เดียวกัน

การตั้งค่า Provider และ Model

Codex รองรับ custom model providers นอกเหนือจาก built-in OpenAI, Ollama, และ LM Studio กำหนด providers เพิ่มเติมด้วย base URLs, authentication, และ optional HTTP headers:

[model_providers.proxy]
name = "OpenAI using LLM proxy"
base_url = "http://proxy.example.com"
env_key = "OPENAI_API_KEY"

Amazon Bedrock พร้อมใช้งานเป็น built-in provider ที่ต้องการ AWS profile และ region configuration สำหรับ data residency ให้สร้าง custom provider ด้วย regional base URL prefix ที่เหมาะสม

Model reasoning และ verbosity ควบคุมพฤติกรรม output ปิดการใช้งาน summaries ด้วย model_reasoning_summary = "none" หรือปรับ verbosity ด้วย model_verbosity = "low"

Security และ Sandbox Configuration

Approval policies (approval_policy) มีตั้งแต่ untrusted ถึง never ควบคุมว่า Codex จะหยุดรอการยืนยันจากผู้ใช้เมื่อใด Sandbox modes ควบคุม filesystem และ network access โดยมีตัวเลือก workspace-write และ danger-full-access

Shell environment policy (shell_environment_policy) จำกัด environment variables ที่ subprocess tools ได้รับ เริ่มต้นด้วย inherit = "none" สำหรับ clean slate แล้วเพิ่ม variables ที่ต้องการโดยใช้ glob patterns

Granular approval policies ช่วยให้คุณ auto-reject prompt categories เฉพาะ (เช่น request_permissions) ขณะที่ยังคง interactive สำหรับ categories อื่น

Advanced Features

Hooks (ใน hooks.json หรือ inline [hooks] tables) ทำงานเมื่อเกิด lifecycle events Project-local hooks โหลดเฉพาะเมื่อ .codex/ layer ได้รับความไว้วางใจ

MCP servers ขยายความสามารถของ Codex ผ่าน Model Context Protocol ดูเอกสารเฉพาะสำหรับการตั้งค่า

OpenTelemetry (OTel) ส่ง structured logs และ metrics สำหรับ observability ตั้งค่า exporters (otlp-http หรือ otlp-grpc) เพื่อส่งข้อมูล event ไปยังระบบภายนอก

Notifications ผ่าน notify command ช่วยให้คุณ trigger external programs เมื่อเกิด agent events เช่น turn completion มีประโยชน์สำหรับ webhooks หรือ desktop alerts

History persistence บันทึก session transcripts ไปยัง history.jsonl โดยค่าเริ่มต้น ปิดการใช้งานด้วย persistence = "none" หรือจำกัดขนาดไฟล์ด้วย max_bytes

Project Discovery และ State

Project root detection ค่าเริ่มต้นคือ directories ที่มี .git แต่ปรับแต่งได้ด้วย project_root_markers ตั้งค่า list ว่างเพื่อใช้เฉพาะ current directory เป็น root

AGENTS.md ให้ project guidance ที่รวมโดยอัตโนมัติเมื่อเริ่ม session ปรับแต่งได้ผ่าน project_doc_max_bytes และ fallback filenames

Config storage อยู่ภายใต้ CODEX_HOME (ค่าเริ่มต้น ~/.codex) รวมถึง config.toml, credential files, history, และ logs