---
title: "Pakai AGENTS.md di Claude Code dan Codex"
description: "Codex membaca AGENTS.md secara bawaan. Claude Code 2.1.277 atau yang lebih baru membacanya kalau proyek kamu tidak punya CLAUDE.md. Untuk memakai keduanya, tulis @AGENTS.md di CLAUDE.md kamu."
canonical: "https://logbrew.co/id/guides/agents-md"
last_updated: "2026-11-10"
---

# Pakai AGENTS.md di Claude Code dan Codex

Codex membaca `AGENTS.md` secara bawaan. Claude Code 2.1.277 atau yang lebih baru membacanya kalau proyek kamu tidak punya `CLAUDE.md`. Untuk memakai keduanya, tulis `@AGENTS.md` di `CLAUDE.md` kamu.

Diuji pada 10 November 2026 dengan Claude Code 2.1.319 dan Codex CLI 0.167.0

Oleh [Furkan Erday](https://github.com/furkanerday). Furkan Erday adalah pendiri LogBrew. Setiap hari ia membangun LogBrew dengan Claude Code dan Codex.

Canonical: https://logbrew.co/id/guides/agents-md

## Kapan setiap agen memuat `AGENTS.md`

| Proyek kamu berisi | Claude Code | Codex |
| --- | --- | --- |
| Hanya `AGENTS.md` | Dimuat | Dimuat |
| `AGENTS.md` dan `CLAUDE.md` | Dilewati | Dimuat |
| `CLAUDE.md` yang mengimpor `@AGENTS.md` | Dimuat | Dimuat |
| `CLAUDE.md` berupa symlink ke `AGENTS.md` | Dimuat | Dimuat |
| `AGENTS.md` dan `CLAUDE.local.md` | Dilewati | Dimuat |

Kami membaca instruksi yang dikirim setiap agen bersama permintaan pertamanya.

## Siapkan 1 file untuk kedua agen

### Tulis AGENTS.md di root proyek

Taruh perintah build, perintah test, dan aturan kode dalam 1 file. Kedua agen membacanya mulai dari root repositori Git sampai ke folder kamu saat ini.

### Perbarui Claude Code

Claude Code membaca `AGENTS.md` sendiri mulai versi 2.1.277. Versi lama perlu impor di langkah berikutnya.

```bash
claude update
```

### Impor AGENTS.md dari CLAUDE.md

Kalau ada `CLAUDE.md`, `.claude/CLAUDE.md`, atau `CLAUDE.local.md` di folder kamu atau di atasnya, Claude Code tidak membaca `AGENTS.md`. Tambahkan baris ini ke `CLAUDE.md` kamu agar keduanya dimuat.

```bash
@AGENTS.md
```

### Atau tautkan CLAUDE.md ke AGENTS.md

Kalau `CLAUDE.md` kamu hanya akan berisi impor itu, jadikan saja symlink.

```bash
ln -s AGENTS.md CLAUDE.md
```

### Atau muat keduanya lewat pengaturan

Untuk tetap memakai `CLAUDE.local.md` sambil memuat `AGENTS.md`, tambahkan ini ke `~/.claude/settings.json`. Dalam sesi, opsi instruksi proyek di `/config` mengatur nilai yang sama.

```bash
{
  "pluginConfigs": {
    "cc-plugin-agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}
```

### Cek apa yang dimuat Codex

Jalankan ini dari folder tempat kamu bekerja. Dokumentasi Codex memberikan perintah ini agar Codex mengulang instruksi yang dimuatnya.

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

## Hasil pengujian kami

Kami mengarahkan kedua agen ke server uji lokal dan membaca instruksi yang dikirim masing-masing agen bersama permintaan pertamanya. Dari situ terlihat persis file mana yang dimuat setiap agen.

Claude Code memuat `AGENTS.md` saat proyek tidak punya `CLAUDE.md`, dan log debug-nya menulis `no CLAUDE.md found; AGENTS.md loaded`. Kalau ada `CLAUDE.md` di sebelahnya, Claude Code tidak memuat `AGENTS.md`. Dengan impor `@AGENTS.md` atau symlink, isi `AGENTS.md` muncul tepat satu kali.

Pengaturan `pluginConfigs` di atas memuat kedua file, juga saat ada `CLAUDE.local.md` di proyek.

Codex memuat `~/.codex/AGENTS.md` lebih dulu, lalu `AGENTS.md` di root, lalu file di folder saat ini. `AGENTS.override.md` menggantikan `AGENTS.md` di foldernya. Codex melewati `CLAUDE.md` sampai kami menambahkannya ke `project_doc_fallback_filenames`. Saat kedua file ada, Codex hanya memuat `AGENTS.md`, bahkan setelah fallback diatur.

## AGENTS.md vs CLAUDE.md

Codex membaca `AGENTS.override.md` atau `AGENTS.md` di setiap folder, ditambah `~/.codex/AGENTS.md` global, sampai total 32 KiB secara bawaan. Codex membaca `CLAUDE.md` hanya kalau kamu mencantumkannya di `project_doc_fallback_filenames`.

Claude Code membaca `CLAUDE.md` lebih dulu. Claude Code membaca `AGENTS.md` dan `.claude/AGENTS.md` hanya kalau tidak ada `CLAUDE.md` proyek yang berlaku. `~/.claude/CLAUDE.md` pribadi kamu tidak dihitung, jadi file itu tetap dimuat bersama `AGENTS.md`.

## Isi laporan di GitHub

#6235, dengan 409 komentar, meminta Claude Code mendukung AGENTS.md. Pada 17 Agustus 2026, seorang engineer Anthropic menutupnya dengan solusi impor dan symlink di atas. Sekarang Claude Code membaca file itu sendiri. #31005 juga meminta dukungan `.agents/skills/` dan masih terbuka.

## Pertanyaan yang sering diajukan

### Apakah Claude Code membaca AGENTS.md?

Ya, mulai versi 2.1.277, selama tidak ada `CLAUDE.md`, `.claude/CLAUDE.md`, atau `CLAUDE.local.md` di folder kamu atau di atasnya. Kami memastikannya di 2.1.319.

### Sebaiknya pakai AGENTS.md atau CLAUDE.md?

Pakai `AGENTS.md` kalau ada anggota tim yang memakai Codex atau agen lain. Simpan `CLAUDE.md` hanya untuk aturan khusus Claude Code, lalu impor `@AGENTS.md` dari situ.

### Bisakah CLAUDE.md dijadikan symlink ke AGENTS.md?

Bisa. Dalam pengujian kami, Claude Code memuat file yang ditautkan satu kali, sama seperti impor.

### Apakah Codex membaca CLAUDE.md?

Tidak secara bawaan. Tambahkan `project_doc_fallback_filenames = ["CLAUDE.md"]` ke `~/.codex/config.toml`.

## Beri agen kamu akses ke error produksi

Hubungkan server MCP LogBrew, dan Claude Code atau Codex bisa membaca error, log, dan trace dari proyek yang kamu setujui. Mulai dengan paket gratis yang lega, tanpa perlu kartu.

[Hubungkan agen kamu](https://logbrew.co/id/agents)

## Sumber

- [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md)
- [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235)
- [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005)

## Panduan lain untuk agen coding AI

- [Tambahkan server MCP ke Claude Code dan Codex](https://logbrew.co/id/guides/mcp-server-claude-code-codex)
- [Atasi error Claude overloaded 529 dan rate limit 429](https://logbrew.co/id/guides/claude-overloaded-rate-limit-error)
- [Cara mengatasi error di Claude Code, Codex, dan JavaScript browser](https://logbrew.co/id/guides)