Panduan Lengkap Claude Code: Cara Install, Konfigurasi, dan Menggunakan AI Programming Assistant di Terminal Anda

本文能帮你做到什么： Panduan ini akan membantu Anda menginstal Claude Code di sistem operasi Anda, mengonfigurasi API lokal atau pihak ketiga untuk mengatasi batasan jaringan regional, serta menguasai perintah dasar untuk otomatisasi coding, debugging, dan operasi Git langsung dari terminal.

Claude Code adalah asisten pemrograman berbasis Command Line Interface (CLI) revolusioner yang dikembangkan oleh Anthropic. Berbeda dengan chat biasa, Claude Code dapat langsung membaca repositori lokal Anda, menjalankan tes, menulis kode, hingga melakukan commit Git berdasarkan perintah bahasa alami.

Berikut adalah panduan langkah demi langkah untuk menginstal dan menggunakan Claude Code secara optimal.

Langkah 1: Instalasi Claude Code

Anda dapat menginstal Claude Code secara native atau menggunakan package manager seperti Homebrew, WinGet, atau NPM.

Metode A: Instalasi Native (Direkomendasikan)

• macOS, Linux, WSL:

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

• Windows PowerShell:

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

• Windows CMD:

  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  

Metode B: Instalasi via NPM (Alternatif Populer)

Pastikan Anda sudah menginstal Node.js (v18.0 atau lebih tinggi). Jalankan perintah berikut di terminal Anda:

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

Untuk memverifikasi keberhasilan instalasi, jalankan:

claude --version

Langkah 2: Konfigurasi Lewati Login Resmi & Menggunakan API Custom (Opsional)

Di beberapa wilayah (seperti China Daratan), akses langsung ke API Anthropic resmi mungkin dibatasi. Anda bisa mengalihkan rute API ke penyedia lokal (misalnya Aliyun Bailian) dan melewati verifikasi login resmi.

1. Lewati Verifikasi Onboarding:
   Buat atau edit file ~/.claude.json (Untuk Windows: C:\Users\<Nama_User>\.claude.json) dan tambahkan baris berikut:

   {
     "hasCompletedOnboarding": true
   }
   

2. Konfigurasi API Key & Endpoint Kustom:
   Buat file setelan di ~/.claude/settings.json (Windows: C:\Users\<Nama_User>\.claude\settings.json) dan isi dengan konfigurasi API Anda:

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY_DISINI",
       "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
       "ANTHROPIC_MODEL": "qwen3.7-max",
       "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1000000"
     }
   }
   

Langkah 3: Memulai Sesi Claude Code Pertama Anda

Masuk ke direktori proyek software Anda melalui terminal, lalu jalankan perintah claude:

cd /path/to/your/project
claude

Jika konfigurasi Anda benar, Anda akan langsung disambut oleh terminal interaktif Claude Code. Anda bisa mengetik /help untuk melihat daftar lengkap perintah yang tersedia.

Langkah 4: Mengajukan Pertanyaan tentang Codebase Anda

Anda tidak perlu menyalin kode secara manual ke dalam chatbox. Claude Code dapat membaca file proyek Anda secara cerdas. Cobalah pertanyaan berikut:

• what does this project do? (Minta ringkasan fungsionalitas proyek)
• explain the folder structure (Minta penjelasan struktur folder)
• where is the main entry point? (Temukan file utama aplikasi Anda)

Langkah 5: Melakukan Perubahan Kode Otomatis

Mari kita instruksikan Claude untuk menulis fungsi baru. Ketik perintah seperti ini di sesi interaktif:

"Tambahkan fungsi hello world di file utama"

Claude Code akan otomatis:

1. Mencari file yang relevan.
2. Menampilkan draf perubahan kode (diff).
3. Meminta persetujuan Anda sebelum benar-benar menulis ke file.

Langkah 6: Menggunakan Integrasi Git Secara Interaktif

Claude Code mempermudah pengelolaan repositori Git Anda melalui bahasa alami. Cobalah perintah berikut di dalam terminal Claude:

• File mana saja yang baru saya ubah?
• Commit perubahan saya dengan pesan deskriptif
• Buat branch baru bernama feature/quickstart
• Bantu saya menyelesaikan konflik merge ini

Perintah Penting (Cheat Sheet)

常见问题

1. Muncul error "Unable to connect to Anthropic services. Failed to connect to api.anthropic.com"

• Penyebab: Claude Code mencoba mengakses server resmi Anthropic secara langsung tetapi terhalang oleh jaringan internet Anda.
• Solusi: Pastikan Anda telah membuat file ~/.claude.json dengan properti "hasCompletedOnboarding": true untuk melewati login resmi, dan telah mengatur ANTHROPIC_BASE_URL ke endpoint proxy/lokal yang valid di dalam ~/.claude/settings.json.

2. Muncul pesan "The token '&&' is not a valid statement separator"

• Penyebab: Anda menjalankan perintah instalasi CMD di dalam terminal PowerShell.
• Solusi: Buka terminal Command Prompt (CMD) biasa, atau gunakan perintah instalasi khusus PowerShell (irm https://claude.ai/install.ps1 | iex).

3. CC Switch mendeteksi "Endpoint daftar model tidak ditemukan" saat menambahkan vendor

• Penyebab: Beberapa penyedia lokal (seperti Aliyun Bailian) hanya mengekspos endpoint /v1/messages dan tidak menyediakan endpoint pencarian daftar model /v1/models.
• Solusi: Error ini dapat diabaikan dengan aman. Claude Code akan tetap berfungsi normal selama pemetaan model di opsi lanjutan CC Switch telah diisi secara manual.

在本站快速上手 Claude / GPT

本文涉及的能力可以直接在本站的中转 API 上调用，兼容 OpenAI / Anthropic 官方 SDK：

• 查看支持的全部模型与端点 → 模型列表
• 开通额度即可获取 API Key → 前往开通
• 持有兑换码可直接核销 → 兑换码入口

无需科学上网，国内可直连，5 分钟完成接入。