Gambaran Umum Alat CLI
CLI adalah alat baris perintah (command-line), bukan satu perangkat lunak tertentu. Claude Code, Codex CLI, Gemini CLI, OpenClaw, dan OpenCode semuanya termasuk dalam kategori ini: Anda memasukkan bahasa alami di terminal, dan mereka dapat membaca proyek, menginterpretasikan kode, membuat berkas, menjalankan perintah, atau membantu Anda menyelesaikan tugas pengembangan.
Apa itu CLI dan untuk apa kegunaannya
Alat CLI lebih andal daripada perangkat lunak obrolan biasa dan juga lebih rentan terhadap salah penggunaan. Saat pemula mengonfigurasinya untuk pertama kali, jalankan hanya di proyek pengujian, dan atur agar "hanya menginterpretasikan, tidak mengubah, dan tidak menjalankan perintah".
Apa yang harus dipersiapkan terlebih dahulu
| Hal yang perlu disiapkan | Deskripsi | Alasan penting |
|---|---|---|
| Terminal | Windows menggunakan PowerShell, macOS / Linux menggunakan Terminal | CLI berjalan sepenuhnya di terminal |
| Alat itu sendiri | Pasang Claude Code, Codex CLI, Gemini CLI, OpenClaw, atau OpenCode terlebih dahulu | Berkas konfigurasi hanya berlaku untuk alat yang sudah terpasang |
| Kunci / Metode Masuk | Bisa berupa login resmi, API Key, OAuth, atau Kunci penyedia AI | Setiap CLI memiliki metode autentikasi yang berbeda |
| Base URL | Hanya diperlukan saat menggunakan penyedia AI atau perantara (agent) | Akhiran alamat mungkin berbeda tergantung protokol, jadi Anda tidak bisa hanya mengubah nama domain saja. |
| Proyek Pengujian | Buat folder kosong baru atau salin proyek yang ada. | Mencegah rusaknya proyek sebenarnya selama konfigurasi pertama kali |
Halaman Konfigurasi Khusus
Cara memilih halaman yang ingin dilihat
| Apa yang ingin Anda lakukan sekarang | Rekomendasi halaman untuk dibuka | Alasan |
|---|---|---|
| Hanya ingin beralih di antara beberapa penyedia CLI secara seragam | Langkah umum CC-Switch | CC-Switch lebih cocok untuk manajemen Penyedia terpusat, lalu meneruskannya ke alat seperti Claude, Codex, Gemini, dll. |
| Hanya mengonfigurasi Claude Code | Konfigurasi Claude Code | Untuk Claude Code, fokus pada Kunci terkait Anthropic / Claude, Base URL, nama model, dan settings.json |
| Hanya mengonfigurasi Codex CLI | Konfigurasi Codex | Untuk Codex, fokus pada config.toml, Penyedia kompatibel OpenAI, nama model, dan variabel lingkungan |
| Hanya mengonfigurasi Gemini CLI | Konfigurasi Gemini | Metode login Gemini, Kunci, dan antarmuka Vertex / Gemini berbeda dari antarmuka yang kompatibel dengan OpenAI |
| Menggunakan OpenClaw / OpenCode | OpenClaw / OpenCode | Kolom Provider untuk kedua alat ini dapat berubah tergantung versi, Anda harus merujuk pada halaman terkait dan dokumentasi resmi |
Risiko yang perlu diperhatikan sebelum konfigurasi
| Risiko | Kemungkinan terjadinya | Rekomendasi |
|---|---|---|
| Alat dapat membaca berkas proyek | Claude Code, Codex, Gemini, OpenClaw, OpenCode | Jalankan di direktori pengujian untuk pertama kali, jangan langsung membuka proyek produksi sebenarnya |
| Model dapat mengeksekusi atau menyarankan perintah | Semua CLI kode | Aktifkan mode konfirmasi terlebih dahulu, dan periksa setiap tindakan dengan saksama saat menghadapi perintah hapus, pindah, pasang, unggah, dll. |
| Item konfigurasi saling menimpa (override) satu sama lain | Variabel lingkungan sistem, konfigurasi proyek, konfigurasi pengguna, CC-Switch | Jika konfigurasi tidak berpengaruh, periksa prioritasnya terlebih dahulu, jangan mengubah banyak tempat secara bersamaan |
| Penggunaan protokol yang tercampur | OpenAI, Claude, Gemini, Vertex, antarmuka kompatibel penyedia AI | Isi halaman alat sesuai dengan antarmuka apa pun yang disediakan oleh backend penyedia |
| Menyalin contoh milik orang lain | Tutorial pihak ketiga, tangkapan layar, dokumen lama | URL, Kunci, dan nama model dalam contoh harus diganti dengan konten dari backend penyedia Anda sendiri |
Cara melakukan pengujian keamanan pertama kali
Setelah konfigurasi selesai, jangan langsung membiarkan CLI mengubah proyek sebenarnya. Pertama, buat direktori kosong, masukkan berkas pengujian sederhana ke dalamnya, dan biarkan alat hanya membaca serta menginterpretasikan tanpa mengubah berkas tersebut.
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.Jika langkah ini tidak menghasilkan respons yang normal, buka halaman pemecahan masalah yang sesuai. Jangan biarkan CLI memproses proyek sebenarnya secara otomatis sebelum memastikan konfigurasinya berhasil.