Cara Menginstal dan Mengatur Claude Code: Panduan Lengkap (2026)

Claude Code adalah agen coding AI berbasis terminal dari Anthropic. Ia membaca basis kode Anda, mengedit file nyata, menjalankan perintah shell, dan mengelola git — semuanya dari command line. Tidak perlu tab browser, tidak perlu copy-paste.

Panduan ini mencakup setiap metode instalasi (native, npm, Homebrew), autentikasi, konfigurasi, dan — yang terpenting — apa yang harus dilakukan setelah instalasi untuk mengubah Claude Code dari asisten coding menjadi agen multimodal penuh dengan kemampuan pembuatan gambar, video, pencarian web, dan penyimpanan cloud.

Prasyarat

Sebelum menginstal, pastikan Anda memiliki:

• Sistem operasi: macOS 13+ (Ventura), Ubuntu 20.04+ / Debian 10+, atau Windows 10 (1809+) dengan WSL
• RAM: Minimal 4 GB, direkomendasikan 8 GB untuk basis kode yang lebih besar
• Koneksi internet: Semua pemrosesan AI berjalan di infrastruktur cloud Anthropic — tanpa koneksi, Claude Code tidak dapat beroperasi
• Akun Anthropic: Akun Claude Pro ($20/bulan), Max ($100–200/bulan), Teams, Enterprise, atau Console (API). Paket gratis Claude.ai tidak menyertakan Claude Code. Lihat perbandingan harga Claude Code untuk membantu memilih paket.
• Terminal: Bash, Zsh, atau PowerShell
• Node.js 18+: Hanya diperlukan untuk metode instalasi npm

GPU tidak diperlukan. Mesin Anda hanya menjalankan klien CLI ringan; semua komputasi AI terjadi di sisi server.

Langkah 1: Instal Node.js (Khusus Metode npm)

Jika Anda berencana menggunakan installer native — yang kini menjadi jalur yang direkomendasikan Anthropic — lewati langkah ini sepenuhnya. Installer native tidak memiliki dependensi.

Untuk pengguna npm, periksa versi Node Anda:

node --version

Jika output menampilkan v18.0.0 atau lebih tinggi, lanjut ke Langkah 2. Jika tidak, instal melalui nvm (Node Version Manager) untuk menghindari masalah izin:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Tutup dan buka kembali terminal Anda, lalu:

nvm install 22
nvm use 22
node --version  # Should show v22.x.x

Node.js 22 adalah rilis LTS saat ini dan bekerja dengan baik bersama Claude Code.

Langkah 2: Instal Claude Code

Tiga metode instalasi tersedia. Pilih salah satu.

Opsi A: Installer Native (Direkomendasikan)

Nol dependensi. Pembaruan otomatis di latar belakang. Inilah yang terutama diuji dan didukung oleh Anthropic.

macOS dan Linux:

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell, jalankan sebagai Administrator):

irm https://claude.ai/install.ps1 | iex

Installer menempatkan binary claude ke PATH Anda dan mengonfigurasi pembaruan otomatis. Kurang dari satu menit dari awal hingga selesai.

Opsi B: Homebrew (macOS / Linux)

brew install --cask claude-code

Satu catatan: Instalasi Homebrew tidak diperbarui secara otomatis. Jalankan brew upgrade claude-code secara berkala.

Opsi C: npm

npm install -g @anthropic-ai/claude-code

Jangan gunakan sudo. Jika Anda mengalami kesalahan izin EACCES, solusinya adalah nvm — bukan menjalankan npm sebagai root. Direktori npm milik root menimbulkan masalah izin berantai.

Verifikasi

Konfirmasi instalasi berhasil:

claude --version

Untuk diagnostik lingkungan lengkap:

claude doctor

Langkah 3: Autentikasi

claude

Saat pertama kali diluncurkan, Claude Code membuka browser Anda untuk autentikasi OAuth. Masuk ke akun Anthropic Anda, otorisasi CLI, dan Anda terhubung.

Opsi Autentikasi

Browser OAuth (default): Terbaik untuk mesin pribadi. Bekerja dengan akun Pro, Max, Teams, dan Enterprise. Token sesi disimpan secara lokal setelah otorisasi.

Kunci API (CI/CD dan headless): Untuk server, kontainer, atau pipeline di mana browser tidak tersedia:

export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude

Buat kunci Anda di console.anthropic.com. Penggunaan API ditagih per token dengan tarif standar Anthropic. Untuk perincian lengkap tentang langganan vs penagihan API, lihat panduan harga Claude Code.

Model penagihan mana yang dipilih? Langganan (Pro/Max) lebih sederhana untuk penggunaan sehari-hari dan menyertakan Claude Code dalam paket bulanan Anda. Penagihan API memberikan kontrol granular untuk beban kerja variabel atau otomatis.

Langkah 4: Sesi Claude Code Pertama Anda

Navigasikan ke direktori proyek mana pun:

cd ~/my-project
claude

Claude Code membaca struktur proyek Anda dan menempatkan Anda ke dalam REPL interaktif. Mulailah dengan sesuatu yang berisiko rendah:

> Explain the architecture of this project

Ia memindai file Anda, mengidentifikasi stack, dan memberikan ringkasan struktural. Kemudian coba sesuatu dengan konsekuensi nyata:

> Add input validation to the user registration form

Claude Code mengidentifikasi file yang relevan, mengusulkan perubahan, dan menunggu konfirmasi Anda. Anda meninjau setiap perubahan dalam tampilan diff sebelum menerima — ia tidak menimpa file secara sembarangan.

Untuk tugas satu kali tanpa memasuki mode interaktif, gunakan flag -p (print):

claude -p "Write unit tests for the auth module"

Menjalankan tugas, mengeluarkan hasilnya, lalu keluar. Sangat cocok untuk scripting dan pipeline CI/CD.

Langkah 5: Konfigurasi Claude Code

Pemilihan Model

Claude Code secara default menggunakan model terbaru yang tersedia. Timpa dengan:

# Atur model default
claude config set model claude-opus-4-7

# Atau untuk satu sesi
claude --model claude-sonnet-4-6

Izin

Claude Code meminta konfirmasi sebelum menulis file atau menjalankan perintah. Jika Anda mempercayainya pada proyek tertentu:

claude config set permissions.auto-accept-edits true

Berguna untuk kecepatan. Kurang berguna saat mengerjakan kode produksi. Untuk penjelasan mendalam tentang semua mode izin, subagen, dan hook, lihat panduan fitur lanjutan Claude Code.

Pengaturan Tingkat Proyek

Buat .claude/settings.json di root proyek Anda untuk konfigurasi bersama tim (commit file ini):

{
  "permissions": {
    "allow": ["read", "write", "shell"],
    "deny": ["shell:rm -rf *"]
  },
  "model": "claude-sonnet-4-6",
  "environment": {
    "NODE_ENV": "development"
  }
}

Untuk penggantian pribadi yang tidak perlu di-commit, gunakan .claude/settings.local.json.

CLAUDE.md

Konfigurasi yang paling berdampak. Buat file CLAUDE.md di root proyek Anda untuk memberi Claude konteks persisten: perintah build, konvensi kode, keputusan arsitektur. Jalankan /init di dalam Claude Code untuk membuatnya secara otomatis, lalu sesuaikan.

CLAUDE.md yang baik bersifat ringkas — targetkan 50–100 baris. Untuk setiap baris, tanyakan: "Apakah menghapus ini akan menyebabkan Claude membuat kesalahan?" Jika tidak, hapus.

Instruksi Spesifik Platform

macOS

Apple Silicon (M1–M4) dan Mac Intel keduanya didukung. Installer native adalah jalur paling bersih:

curl -fsSL https://claude.ai/install.sh | bash

Linux

Bekerja pada Ubuntu 20.04+, Debian 10+, dan sebagian besar distribusi modern. Installer native yang sama seperti macOS. Pada distro lama, gunakan npm dengan nvm.

Windows

Opsi 1: Installer PowerShell native

irm https://claude.ai/install.ps1 | iex

Opsi 2: WSL (direkomendasikan untuk kompatibilitas Linux penuh)

wsl --install
# Reboot, lalu di terminal WSL:
curl -fsSL https://claude.ai/install.sh | bash

Docker

FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code

Saat runtime, teruskan kunci API sebagai variabel lingkungan — jangan memasukkannya ke dalam image.

CI/CD (Contoh GitHub Actions)

- name: AI Code Review
  run: |
    npx @anthropic-ai/claude-code -p "Review this PR for bugs" --output-format json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Integrasi IDE

Claude Code berbasis terminal, tetapi plugin IDE memberikan tampilan diff native.

VS Code: Instal "Claude Code" dari panel Extensions, atau:

code --install-extension anthropic.claude-code

JetBrains: Settings → Plugins → Marketplace → cari "Claude Code" → Install. Perubahan muncul di penampil diff native IDE.

Lebih dari Sekadar Instalasi: Beri Claude Code Kemampuan Agen

Di sinilah sebagian besar panduan setup berhenti. Claude Code sudah terinstal, terautentikasi, berjalan — tetapi terbatas pada apa yang disediakan CLI dasar: pengeditan file, perintah shell, operasi git.

Yang tidak dapat dilakukan Claude Code secara default:

• Menghasilkan gambar atau mengedit foto
• Membuat atau menganalisis video
• Mencari web secara langsung
• Menyimpan dan mengambil file dari penyimpanan cloud
• Mempublikasikan konten ke web

Kemampuan ini memerlukan server MCP (Model Context Protocol). MCP adalah standar terbuka yang memungkinkan agen AI terhubung ke alat eksternal. Claude Code mendukung MCP secara native — Anda mengonfigurasi server, dan Claude dapat memanggilnya langsung. Untuk panduan lengkap, lihat panduan menambahkan kemampuan ke Claude Code dengan MCP.

Jalur Cepat: AnyCap Agent CLI

Daripada mengonfigurasi server MCP individual satu per satu, Anda dapat memberi Claude Code serangkaian kemampuan agen lengkap dengan satu CLI:

npx -y skills add anycap-ai/anycap -a claude-code

Ini menginstal runtime kemampuan agen AnyCap, memberi Claude Code akses ke:

Satu CLI. Satu alur autentikasi. Semua kemampuan. Anda tidak perlu mengelola kunci API terpisah untuk pembuatan gambar, video, pencarian, dan penyimpanan — AnyCap menangani semuanya melalui satu instalasi. Untuk panduan mendalam tentang integrasi MCP, termasuk opsi konfigurasi server manual, lihat panduan kemampuan MCP.

Konfigurasi MCP Manual

Jika Anda lebih suka mengonfigurasi server MCP secara individual, tambahkan ke .mcp.json di root proyek Anda:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"]
    }
  }
}

Atau tambahkan secara interaktif:

claude mcp add github -- npx -y @modelcontextprotocol/server-github
claude mcp list
claude mcp get github

Pemecahan Masalah

Jalankan claude doctor sebelum menghabiskan waktu pada debugging manual — ini mendeteksi sebagian besar masalah konfigurasi secara otomatis.

Menjaga Claude Code Tetap Diperbarui

Installer native: Pembaruan terjadi secara otomatis. Tidak perlu tindakan. Periksa versi Anda dengan claude --version.

npm: npm update -g @anthropic-ai/claude-code

Homebrew: brew upgrade claude-code

Langkah Selanjutnya

Claude Code sudah terinstal. Inilah yang perlu dilakukan selanjutnya:

1. Buat CLAUDE.md — Jalankan /init di dalam Claude Code untuk memberi konteks proyek yang persisten.
2. Tambahkan kemampuan agen — Instal AnyCap untuk memberi Claude Code kemampuan pembuatan gambar, video, pencarian, dan penyimpanan. Lihat panduan kemampuan MCP.
3. Coba tugas nyata — Pilih sesuatu yang biasanya memakan waktu 20 menit dan lihat bagaimana Claude menanganinya.

Artikel Terkait

• Claude Code vs Cursor: Agen Coding AI Mana yang Menang di 2026? — Agen berbasis terminal vs fork IDE. Bandingkan otonomi, penanganan konteks, harga, tugas nyata, dan kapan menggunakan masing-masing.
• Fitur Lanjutan Claude Code: Subagen, Auto-Approve & Mode Bash — Kuasai subagen untuk pemrosesan paralel, auto-approve untuk alur kerja lebih cepat, dan eksekusi bash untuk akses shell penuh.
• Cara Menambahkan Kemampuan Agen ke Claude Code dengan MCP — Panduan konfigurasi MCP langkah demi langkah plus jalur cepat satu perintah AnyCap untuk pembuatan gambar, video, pencarian web, dan penyimpanan cloud.
• Harga & Paket Claude Code Dibandingkan — Perincian lengkap Pro ($20/bln), Max ($100–200/bln), Teams, Enterprise, dan penagihan API.
• Batas Rate & Batas Token Claude Code Dijelaskan — Strategi praktis untuk tetap produktif dan menghindari batas rate dan batas sesi.

Claude Code adalah cara tercepat untuk membawa AI ke dalam alur kerja pengembangan Anda tanpa mengubah alat. Begitu sudah disiapkan, perbedaannya langsung terasa.