# Claude Code tidak bisa melihat file proyek: penyebab dan cara mengatasinya pada 2026 > Mengapa Claude Code tidak dapat menemukan file proyek: Claude dijalankan dari folder yang salah, file berada di subfolder, atau file tercantum di .gitignore. Cara memberikan akses dengan add-dir, cd, dan settings. Source: https://ailoot.ai/blog/id/claude-code-cant-see-project-files/ Canonical: https://ailoot.ai/blog/id/claude-code-cant-see-project-files/ Language: id Publisher: Ailoot (https://ailoot.ai/) Translation: guide-199 Revision: sha256-8ecbda67b1cbeaecc4ad3b6bdea8d9ac3b444886b27b8c84237e1c138447cc30 Gambaran yang familier: Anda meminta Claude Code memperbaiki file, lalu ia menjawab bahwa file itu tidak ada. Atau diam-diam ia mengubah sesuatu yang sama sekali berbeda dari yang Anda maksud. Anda membuka folder—file itu ada, tepat di tempat seharusnya. Namun, Claude sepertinya tidak menyadarinya. Hampir selalu, ada satu penyebabnya, dan tidak ada yang rusak. Claude tidak melihat file di seluruh komputer. Ia hanya dapat mengakses folder tempat Anda menjalankannya. Memulai dari folder saudara atau di bawah akar proyek dapat menaruh file yang diperlukan di luar pohon kerja. Memulai dari induk seperti home memberi cakupan lebih luas; itu tidak membuat proyek turunan tidak dapat diakses. Saya akan menjelaskan langkah demi langkah mengapa hal ini terjadi dan cara memberi Claude akses ke file yang dibutuhkannya. Saya mengutip perintah dan pengaturan langsung dari dokumentasi resmi Claude Code, yang saya periksa pada awal September 2026. Materi tambahan tentang cara mengonfigurasi alat tersedia di [dokumentasi Ailoot](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
## Mengapa Claude Code Tidak Bisa Melihat Beberapa File Proyek?
Poin utama Claude Code membaca file bukan dari seluruh drive, melainkan hanya dari folder tempat Anda menjalankannya. Folder ini disebut direktori kerja. Claude dapat melihat dan membaca semua yang ada di dalamnya beserta subfoldernya tanpa perlu bertanya. Segala sesuatu di luarnya—di folder sebelah, satu tingkat di atas, atau di drive lain—tidak dapat diakses sampai Anda memberikan izin sendiri. Jadi, alasan paling umum file “tidak terlihat” itu sederhana: Anda menjalankan Claude dari folder yang berbeda. Pertama, periksa tepatnya dari mana Anda membukanya.
Secara default, Claude Code bekerja dengan satu folder: folder tempat Anda memasukkan perintah `claude` dan memulai sesi. Dokumentasi menyatakannya secara langsung.

Secara default, Claude memiliki akses ke file dalam folder tempat Anda menjalankannya.

— Claude Code Docs, Configure permissions, dokumentasi resmi
Folder ini adalah direktori kerjanya. Di dalamnya, Claude membaca file apa pun tanpa pertanyaan tambahan: mengedit prompt, menelusuri kode, membaca file tertentu—semuanya langsung berfungsi. Namun, segala sesuatu di luar folder ini secara default tidak dapat diakses. Folder sebelah, folder satu tingkat di atas, drive lain—Claude tidak akan melihatnya sampai Anda mengizinkannya. Di situlah ketidakcocokan folder kerja dapat berpengaruh. Misalnya proyek berada di `/Users/you/my-shop`, tetapi Claude dijalankan dari `/Users/you/other-project`, folder saudara. `index.html` dalam `my-shop` berada di luar pohon kerja itu. Memulai dari `/Users/you` berbeda: `my-shop` adalah turunannya dan tidak menjadi tidak dapat diakses hanya karena dimulai dari home, meskipun konteks yang dipilih lebih luas daripada yang dimaksud. Akses folder juga tidak berarti setiap file sudah dibaca. Berikutnya, saya akan menjelaskan cara memeriksa dan memperbaikinya: pertama, kita pastikan dari folder mana Claude dijalankan, lalu kita berikan akses ke file yang dibutuhkannya dengan berbagai cara—mulai dari instruksi sekali pakai hingga pengaturan permanen. ## Bagaimana Cara Memeriksa Folder Tempat Claude Code Dijalankan?
Poin utama Tanyakan kepada Claude di folder mana ia berada, atau minta ia menampilkan direktori saat ini dengan perintah `pwd`—perintah ini hanya memeriksa dan tidak mengubah apa pun. Bandingkan hasilnya dengan lokasi proyek Anda sebenarnya. Jika jalurnya berbeda, itulah penyebabnya: Claude dijalankan dari folder yang salah. Solusi yang lebih andal adalah menutup sesi lalu menjalankan ulang Claude langsung dari folder proyek: buka folder tersebut di terminal dan masukkan `claude` di sana.
Sebelum memperbaiki apa pun, pastikan memang folder yang menjadi masalah. Ini mudah diperiksa. Minta Claude di chat menampilkan direktori tempatnya berada saat ini—ia akan menjalankan `pwd`, yang aman: perintah ini hanya menampilkan jalur dan tidak menyentuh apa pun. ```bash pwd ``` Jawaban menunjukkan direktori kerja sebenarnya. Bandingkan dengan jalur proyek lengkap: `/Users/you/other-project` adalah saudara `/Users/you/my-shop`, sedangkan `/Users/you` adalah induknya. Kasus saudara menaruh `my-shop` di luar pohon kerja; kasus induk mencakupnya tetapi tidak memilih proyek spesifik itu sebagai akar. Cara paling tepat untuk mengatasi ketidakcocokan ini adalah menjalankan Claude langsung dari folder proyek. Tutup sesi saat ini, buka folder yang benar di terminal, lalu jalankan Claude dari sana: ```bash # Ganti jalur ilustratif ini dengan akar proyek Anda sebenarnya. cd /Users/you/my-shop claude ``` Sekarang `my-shop` akan menjadi folder kerja, dan semua file proyek akan terlihat. Aturan yang sama berlaku di editor seperti VS Code: buka folder yang berisi proyek. Bukan folder satu tingkat di atasnya dan bukan seluruh drive. Folder yang Anda buka menentukan apa yang dianggap Claude sebagai direktori kerjanya. Jika menjalankan ulang merepotkan—misalnya, Anda sudah memberikan konteks kepada Claude dalam sesi ini dan tidak ingin kehilangannya—Anda dapat menambahkan atau berpindah folder saat itu juga. Dua bagian berikutnya membahasnya. ## Bagaimana Cara Menunjukkan File di Folder Sebelah kepada Claude Code?
Poin utama Tanpa memulai ulang sesi, tambahkan folder yang Anda perlukan dengan perintah `/add-dir` langsung di chat: masukkan `/add-dir` dan jalur folder, lalu file-file di dalamnya akan tersedia dengan cara yang sama seperti file di folder utama. Untuk membuka akses tepat saat Claude mulai, tambahkan flag `--add-dir` dengan jalur ke perintah `claude`. Jika Anda ingin folder terbuka otomatis setiap kali, tambahkan folder tersebut di bawah kunci `additionalDirectories` dalam pengaturan. Dalam ketiga cara ini, file di folder yang ditambahkan dapat dibaca tanpa konfirmasi terpisah.
Terkadang proyek tidak disimpan hanya dalam satu folder. Kode berada di satu tempat, gambar atau teks di folder sebelah, dan komponen bersama di tempat lain di dekatnya. Menjalankan ulang Claude di tiap folder secara bergantian merepotkan. Lebih baik berikan akses ke folder yang dibutuhkan sambil mempertahankan folder utama sebagai direktori kerja. Cara paling sederhana adalah melakukannya langsung di sesi aktif dengan perintah: ``` /add-dir ../assets ``` Masukkan `/add-dir` dan jalur folder, lalu Claude akan langsung memiliki akses ke file-file di dalamnya dengan cara yang sama seperti file di folder utama. Claude tidak akan meminta izin lagi: folder yang ditambahkan mengikuti aturan yang sama dengan direktori kerja.

File di direktori tambahan mengikuti aturan akses yang sama dengan direktori kerja utama: file dibaca tanpa prompt.

— Claude Code Docs, Configure permissions, dokumentasi resmi
Jika Anda sudah tahu sebelumnya bahwa Anda akan bekerja dengan beberapa folder, buka akses begitu Claude mulai—gunakan jalur yang sama, tetapi dengan sebuah flag: ```bash claude --add-dir ../assets ``` Jika Anda selalu memerlukan folder sebelah yang sama dalam sebuah proyek, Anda tidak perlu menambahkannya secara manual setiap kali. File pengaturan `settings.json` memiliki kunci `additionalDirectories`. Cantumkan jalurnya di sana, dan folder tersebut akan terbuka otomatis setiap kali Claude dimulai: ```json { "permissions": { "additionalDirectories": ["../assets", "../shared"] } } ``` Satu catatan untuk Windows: Anda tidak dapat menambahkan folder jaringan menggunakan jalur seperti `\\server\shared`—Claude tidak menerima jalur semacam itu. Pasang folder tersebut sebagai drive terpisah dengan huruf drive, lalu berikan huruf itu melalui `--add-dir`. Folder lokal biasa tidak memiliki masalah ini. Bagaimana jika menambahkan folder sebelah belum cukup dan Anda perlu berpindah sepenuhnya ke folder lain? Ada perintah terpisah untuk itu, yang dibahas di bawah. ## Bagaimana Cara Memindahkan Claude Code ke Folder Lain Selama Sesi?
Poin utama Perintah `/cd` mengubah folder kerja utama tanpa menutup sesi: masukkan `/cd` dan sebuah jalur, lalu Claude akan berpindah ke sana dengan riwayat percakapan tetap utuh. Selama perpindahan, Claude akan mengambil file instruksi `CLAUDE.md` dari folder baru dan, jika Anda belum pernah bekerja di sana, meminta konfirmasi bahwa Anda memercayai folder tersebut. Perbedaan dari `/add-dir` adalah `/add-dir` membuka folder sebelah di samping folder utama, sedangkan `/cd` memindahkan seluruh direktori kerja ke lokasi baru. Perintah ini tersedia mulai versi 2.1.169.
Terkadang menambahkan folder sebelah belum cukup—Anda perlu mengubah folder utama dan berpindah ke proyek lain tanpa kehilangan konteks yang sudah Anda bangun. Gunakan perintah `/cd`: ``` /cd ../another-project ``` Setelah itu, Claude akan memperlakukan folder baru sebagai direktori kerjanya. Seluruh riwayat percakapan tetap ada, tetapi lokasi yang digunakan Claude sebagai acuan untuk file berubah ke lokasi baru. Claude juga mengambil file instruksi `CLAUDE.md` dari folder baru, jika ada—artinya, Claude menyesuaikan diri dengan aturan proyek baru. Ada satu hal yang perlu diketahui tentang kepercayaan: jika Anda belum pernah bekerja di folder ini, Claude akan bertanya apakah Anda memercayainya saat Anda berpindah ke sana. Ini adalah langkah perlindungan: file instruksi di folder yang belum dikenal bisa berisi apa saja, jadi Claude terlebih dahulu memastikan bahwa itu proyek Anda. Konfirmasikan, lalu lanjutkan. Perbedaan antara kedua perintah ini sederhana. `/add-dir` mempertahankan folder utama sebagai direktori kerja dan membuka folder sebelah sebagai tambahan—berguna ketika bagian-bagian proyek tersebar di beberapa tempat. `/cd` memindahkan seluruh direktori kerja ke lokasi baru—berguna ketika berpindah ke proyek lain. Perintah `/cd` diperkenalkan di versi 2.1.169, jadi jika tidak tersedia, perbarui Claude Code. Saya memiliki panduan terpisah tentang [cara memperbarui Claude Code](https://ailoot.ai/blog/id/update-claude-code/). Claude Code dapat melihat file hanyalah fondasinya. Hasil yang stabil tidak berasal dari akses file saja. Hasil itu bergantung pada isi file dan cara Anda membangun konteks seputar proyek.
[Panduan Ailoot](https://ailoot.ai/docs/)
## Mengapa Claude Code Tidak Bisa Melihat File di Subfolder?
Poin utama Subfolder bekerja berbeda dari folder sebelah: Claude memiliki akses ke sana, tetapi isinya tidak langsung masuk ke konteksnya. Claude memuat file instruksi dan isi subfolder sesuai kebutuhan, saat ia menelusurinya. Claude tidak memuatnya saat memulai. Jadi, file di subfolder yang bertingkat dalam mungkin “tidak terlihat” sampai Anda memberikan jalurnya langsung kepada Claude. Solusinya sederhana: berikan jalur file yang tepat kepada Claude atau minta ia membaca file terlebih dahulu, dan file itu akan terlihat.
Penting untuk tidak mencampuradukkan dua situasi yang berbeda. Folder sebelah (yang berada di luar proyek) sama sekali tidak dapat diakses sampai Anda menambahkannya. Subfolder di dalam proyek berbeda: Claude memiliki akses ke sana, tetapi sejak awal ia tidak menyimpan isi folder tersebut dalam konteksnya. Begini cara kerjanya. Saat Claude mulai, ia memuat hal-hal yang ada di tingkat teratas proyek. Ia memuat file dari subfolder sesuai kebutuhan, saat ia membuka subfolder tersebut untuk membaca sesuatu. Dokumentasi menjelaskan perilaku ini untuk file instruksi, dan logika yang sama berlaku secara umum untuk konteks.

Claude menemukan file di subfolder direktori kerja. Alih-alih memuatnya saat mulai, Claude mengambilnya ketika membaca file di subfolder tersebut.

— Claude Code Docs, Manage Claude's memory, dokumentasi resmi
Sederhananya: file di subfolder yang bertingkat dalam tidak hilang dan dapat diakses sepenuhnya. Claude hanya belum mengingatnya karena belum melihat ke sana—itulah sebabnya Claude bisa terkesan “tidak bisa melihat” file meskipun file itu ada dan dapat diakses. Anda dapat memperbaikinya dalam satu baris. Berikan jalur file langsung kepada Claude—misalnya, `src/components/header.jsx`—atau cukup minta Claude membaca file itu terlebih dahulu. Begitu Claude membukanya, file tersebut akan masuk ke konteks, dan Anda dapat mengerjakannya seperti biasa. Anda tidak perlu mengubah pengaturan apa pun. ## Di Mana File Hilang dari Menu @, dan Apa Hubungannya dengan .gitignore?
Poin utama Saat Anda mengetik simbol `@`, Claude Code menampilkan daftar file yang dapat dipilih. Secara default, daftar ini menyembunyikan apa pun yang tercantum di `.gitignore`—folder layanan, file lingkungan, hasil build. Jadi, file mungkin berada tepat di tempatnya tetapi tidak muncul di menu `@`. Pengaturan `respectGitignore` mengontrol hal ini: secara default, pengaturan ini aktif dan menyembunyikan file tersebut. Ubah nilainya menjadi `false`, maka menu juga akan menampilkan file yang tercantum di `.gitignore`. Anda selalu dapat memasukkan jalur file itu secara manual.
Alasan umum lainnya mengapa Anda mengira Claude “kehilangan” file adalah pemilih file. Saat Anda mengetik `@`, sebuah daftar muncul sehingga Anda dapat memilih file dengan mudah tanpa mengetik jalur lengkapnya. Namun, daftar itu tidak menampilkan semuanya. Secara default, menu `@` menyembunyikan file yang tercantum di `.gitignore`. File itu menentukan apa yang tidak seharusnya ditambahkan ke repositori bersama: folder layanan, file yang berisi kata sandi dan pengaturan lingkungan, serta hasil build yang sudah selesai. Alasannya jelas—biasanya Anda tidak perlu mengerjakan file-file ini secara manual, jadi file tersebut hanya akan memenuhi daftar. Namun, terkadang Anda memang perlu menggunakan salah satu file itu, tetapi file tersebut tidak ada di menu. Pengaturan `respectGitignore` mengontrol hal ini. Secara default, pengaturan ini aktif, sehingga file dari `.gitignore` tidak muncul di menu. Jika Anda ingin melihatnya, ubah nilainya menjadi `false`: ```json { "respectGitignore": false } ``` Anda dapat melakukan hal yang sama tanpa mengedit file, dengan menggunakan perintah `/config` di dalam Claude Code. Toggle di sana bernama “Respect .gitignore in file picker.” Hapus centangnya, dan file yang tersembunyi akan kembali ke menu. Satu catatan penting: `respectGitignore` hanya berlaku untuk menu `@` dan tidak ada hubungannya dengan akses file. Meskipun sebuah file disembunyikan dari daftar, Anda selalu dapat memasukkan jalurnya secara manual, lalu Claude akan membacanya. Menu ini hanya fitur kemudahan; menu ini tidak menentukan batas akses. ## Apa yang Harus Dilakukan Jika Claude Code Tidak Bisa Membaca File Tertentu?
Poin utama Terkadang foldernya sudah benar, tetapi Claude tetap menolak membaca satu file tertentu. Biasanya, penyebabnya adalah pembatasan dalam pengaturan. File `settings.json` mungkin berisi aturan `deny` yang memblokir pembacaan file tertentu, paling sering file `.env` yang berisi kunci dan kata sandi. Ada juga pengaturan yang memblokir pembacaan apa pun di luar folder kerja. Periksa kedua tempat ini di `settings.json`. Dan ingat bahwa pembatasan `.env` adalah perlindungan bawaan; Anda tidak seharusnya menghapusnya tanpa alasan yang kuat.
Jika foldernya sudah pasti benar dan akses terbuka, tetapi Claude tetap tidak mau membaca satu file tertentu, kemungkinan besar file tersebut dibatasi. Pembatasan ada di file pengaturan `settings.json` dan terdiri dari dua jenis. Jenis pertama adalah pembatasan yang ditargetkan pada file tertentu. Dalam pengaturan, pembatasan ini berupa aturan `deny`, dan paling sering berlaku untuk file `.env`, tempat kunci dan kata sandi disimpan: ```json { "permissions": { "deny": [ "Read(./.env)", "Read(./.env.*)" ] } } ``` Aturan semacam itu memblokir Claude agar tidak membaca file yang ditentukan, dan memang disengaja. Kunci dan kata sandi tidak seharusnya masuk ke percakapan dengan model, sehingga `.env` dikunci secara default. Jika Anda melihat Claude tidak mau membaca `.env` atau file serupa yang berisi rahasia, itu memang dirancang demikian, dan Anda tidak seharusnya menghapus pembatasan ini tanpa alasan yang kuat. Jenis kedua adalah pembatasan umum terhadap segala sesuatu di luar folder kerja. Pengaturan `blockReadsOutsideWorkingDirectories` mengontrolnya. Saat diaktifkan, Claude menolak membaca file apa pun di luar direktori kerja, meskipun Anda mencoba membukanya secara langsung. Jika nilainya `true` dan Anda memerlukan file eksternal, tambahkan foldernya menggunakan `/add-dir` atau nonaktifkan pembatasan ini: ```json { "permissions": { "blockReadsOutsideWorkingDirectories": false } } ``` Pengaturan ini diperkenalkan di versi 2.1.257. Jika Anda sudah mencoba segala cara lain tetapi file masih tidak dapat diakses, periksa `deny` dan `blockReadsOutsideWorkingDirectories`. ## Dari Mana Harus Memulai Jika Claude Code Tidak Bisa Melihat File?
Poin utama Mulailah dengan memeriksa folder: minta Claude menampilkan direktori saat ini menggunakan `pwd`, lalu bandingkan dengan lokasi proyek. Jika tidak cocok, jalankan ulang Claude dari folder proyek atau pindah ke sana dengan `/cd`. Perlu file dari folder sebelah? Buka aksesnya dengan `/add-dir`. Tidak bisa melihat file di subfolder? Berikan jalurnya langsung kepada Claude. File tidak ada di menu `@`? Penyebabnya terkait `.gitignore`—ubah `respectGitignore`. Satu file terkunci? Cari pembatasan `deny` di `settings.json`.
Berikut rencana singkat yang dapat Anda ikuti dari atas ke bawah. 1. Periksa folder kerja: minta Claude menampilkan direktori saat ini menggunakan `pwd`, lalu bandingkan dengan lokasi proyek. 2. Jika foldernya berbeda, jalankan ulang Claude dari folder yang benar (`cd project`, lalu `claude`) atau pindah ke sana dengan perintah `/cd`. 3. Perlu file dari folder sebelah? Tambahkan dengan `/add-dir` atau flag `--add-dir` saat menjalankan Claude. 4. File dari subfolder tidak ada di konteks? Berikan jalurnya langsung kepada Claude atau minta Claude membaca file tersebut. 5. File tidak ada di menu `@`? Penyebabnya `.gitignore`. Ubah `respectGitignore` menjadi `false` atau hapus centang kotak di `/config`. 6. Satu file tertentu terkunci? Periksa aturan `deny` dan `blockReadsOutsideWorkingDirectories` di `settings.json`. Dalam sembilan dari sepuluh kasus, langkah pertama menyelesaikan semuanya: Claude dijalankan dari folder yang salah. Akses file adalah fondasinya, tetapi hal itu tidak akan membangun proyek Anda. Saya telah membahas secara rinci cara membangun konteks di sekitar Claude agar ia mengingat seluruh proyek dan tidak kehilangan alur dalam panduan saya tentang [Second Brain di Claude Code](https://ailoot.ai/blog/id/claude-code-second-brain/).
### Sumber - [Claude Code - Configure permissions, dokumentasi resmi](https://docs.claude.com/en/docs/claude-code/permissions) - direktori kerja default, --add-dir dan /add-dir, /cd, additionalDirectories, akses tanpa prompt, jalur jaringan - [Claude Code - Manage Claude's memory, dokumentasi resmi](https://docs.claude.com/en/docs/claude-code/memory) - memuat file subfolder sesuai kebutuhan, CLAUDE.md, impor - [Claude Code - Settings reference, dokumentasi resmi](https://docs.claude.com/en/docs/claude-code/settings-reference) - respectGitignore dan menu @, blockReadsOutsideWorkingDirectories dan versi 2.1.257 - [Claude Code - Settings, dokumentasi resmi](https://docs.claude.com/en/docs/claude-code/settings) - aturan deny dan pemblokiran pembacaan .env
Temukan materi tambahan tentang penggunaan alat di [dokumentasi Ailoot](https://ailoot.ai/docs/).
[Panduan Ailoot](https://ailoot.ai/docs/)
[Kunjungi Ailoot](https://ailoot.ai/)
## Pertanyaan tentang Claude Code tidak bisa melihat file proyek: penyebab dan cara mengatasinya pada 2026 ### Mengapa memulai dari home berbeda dengan memulai dari proyek saudara? Proyek di bawah direktori home merupakan turunannya, sehingga memulai dari home tidak menaruhnya di luar pohon kerja; konteksnya justru lebih luas daripada yang dimaksud. Saudara folder kerja berada di luarnya. Bandingkan jalur lengkap sebelum mendiagnosis akses hilang. ### Apakah akses subfolder berarti filenya sudah berada dalam konteks? Tidak. Berikan jalur file kepada agen dan minta agen membacanya. Jika pembacaan ditolak, periksa izin yang berlaku; file yang tidak muncul pada menu pilihan dan pembacaan file yang ditolak merupakan masalah berbeda. ## Ailoot · Perusahaan dan portofolio proyeknya Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan. Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan. Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.