​
Metode autentikasi

Menyiapkan Claude Code memerlukan akses ke model Anthropic. Untuk tim, Anda dapat menyiapkan akses Claude Code dengan salah satu dari tiga cara:
  • Claude API melalui Claude Console
  • Amazon Bedrock
  • Google Vertex AI

​
Autentikasi Claude API

Untuk menyiapkan akses Claude Code untuk tim Anda melalui Claude API:
  1. Gunakan akun Claude Console yang sudah ada atau buat akun Claude Console baru
  2. Anda dapat menambahkan pengguna melalui salah satu metode di bawah ini:
    • Undang pengguna secara massal dari dalam Console (Console -> Settings -> Members -> Invite)
    • Siapkan SSO
  3. Saat mengundang pengguna, mereka memerlukan salah satu peran berikut:
    • Peran “Claude Code” berarti pengguna hanya dapat membuat kunci API Claude Code
    • Peran “Developer” berarti pengguna dapat membuat jenis kunci API apa pun
  4. Setiap pengguna yang diundang perlu menyelesaikan langkah-langkah berikut:

​
Autentikasi penyedia cloud

Untuk menyiapkan akses Claude Code untuk tim Anda melalui Bedrock atau Vertex:
  1. Ikuti dokumentasi Bedrock atau dokumentasi Vertex
  2. Distribusikan variabel lingkungan dan instruksi untuk menghasilkan kredensial cloud kepada pengguna Anda. Baca lebih lanjut tentang cara mengelola konfigurasi di sini.
  3. Pengguna dapat menginstal Claude Code

​
Kontrol akses dan izin

Kami mendukung izin yang terperinci sehingga Anda dapat menentukan dengan tepat apa yang diizinkan untuk dilakukan agen (misalnya menjalankan tes, menjalankan linter) dan apa yang tidak diizinkan untuk dilakukan (misalnya memperbarui infrastruktur cloud). Pengaturan izin ini dapat dicek ke dalam kontrol versi dan didistribusikan ke semua pengembang di organisasi Anda, serta disesuaikan oleh pengembang individual.

​
Sistem izin

Claude Code menggunakan sistem izin bertingkat untuk menyeimbangkan kekuatan dan keamanan:
Jenis AlatContohPersetujuan DiperlukanPerilaku “Ya, jangan tanya lagi”
Hanya-bacaBaca file, LS, GrepTidakN/A
Perintah BashEksekusi shellYaPermanen per direktori proyek dan perintah
Modifikasi FileEdit/tulis fileYaSampai sesi berakhir

​
Mengonfigurasi izin

Anda dapat melihat & mengelola izin alat Claude Code dengan /permissions. UI ini mencantumkan semua aturan izin dan file settings.json yang menjadi sumbernya.
  • Aturan Allow akan memungkinkan Claude Code menggunakan alat yang ditentukan tanpa persetujuan manual lebih lanjut.
  • Aturan Ask akan meminta konfirmasi pengguna setiap kali Claude Code mencoba menggunakan alat yang ditentukan. Aturan Ask mengambil prioritas atas aturan allow.
  • Aturan Deny akan mencegah Claude Code menggunakan alat yang ditentukan. Aturan Deny mengambil prioritas atas aturan allow dan ask.
  • Direktori tambahan memperluas akses file Claude ke direktori di luar direktori kerja awal.
  • Mode default mengontrol perilaku izin Claude saat menghadapi permintaan baru.
Aturan izin menggunakan format: Tool atau Tool(optional-specifier) Aturan yang hanya nama alat cocok dengan penggunaan alat apa pun. Misalnya, menambahkan Bash ke daftar aturan allow akan memungkinkan Claude Code menggunakan alat Bash tanpa memerlukan persetujuan pengguna.

​
Mode izin

Claude Code mendukung beberapa mode izin yang dapat diatur sebagai defaultMode dalam file pengaturan:
ModeDeskripsi
defaultPerilaku standar - meminta izin pada penggunaan pertama setiap alat
acceptEditsSecara otomatis menerima izin edit file untuk sesi
planMode Plan - Claude dapat menganalisis tetapi tidak memodifikasi file atau menjalankan perintah
bypassPermissionsMelewati semua prompt izin (memerlukan lingkungan yang aman - lihat peringatan di bawah)

​
Direktori kerja

Secara default, Claude memiliki akses ke file di direktori tempat ia diluncurkan. Anda dapat memperluas akses ini:
  • Selama startup: Gunakan argumen CLI --add-dir <path>
  • Selama sesi: Gunakan perintah slash /add-dir
  • Konfigurasi persisten: Tambahkan ke additionalDirectories dalam file pengaturan
File di direktori tambahan mengikuti aturan izin yang sama dengan direktori kerja asli - mereka menjadi dapat dibaca tanpa prompt, dan izin edit file mengikuti mode izin saat ini.

​
Aturan izin khusus alat

Beberapa alat mendukung kontrol izin yang lebih terperinci: Bash
  • Bash(npm run build) Cocok dengan perintah Bash yang tepat npm run build
  • Bash(npm run test:*) Cocok dengan perintah Bash yang dimulai dengan npm run test
  • Bash(curl http://site.com/:*) Cocok dengan perintah curl yang dimulai dengan tepat curl http://site.com/
Claude Code menyadari operator shell (seperti &&) jadi aturan pencocokan awalan seperti Bash(safe-cmd:*) tidak akan memberinya izin untuk menjalankan perintah safe-cmd && other-cmd
Keterbatasan penting dari pola izin Bash:
  1. Alat ini menggunakan pencocokan awalan, bukan regex atau pola glob
  2. Wildcard :* hanya berfungsi di akhir pola untuk mencocokkan kelanjutan apa pun
  3. Pola seperti Bash(curl http://github.com/:*) dapat dilewati dengan banyak cara:
    • Opsi sebelum URL: curl -X GET http://github.com/... tidak akan cocok
    • Protokol berbeda: curl https://github.com/... tidak akan cocok
    • Redirect: curl -L http://bit.ly/xyz (redirect ke github)
    • Variabel: URL=http://github.com && curl $URL tidak akan cocok
    • Spasi ekstra: curl http://github.com tidak akan cocok
Untuk penyaringan URL yang lebih andal, pertimbangkan:
  • Menggunakan alat WebFetch dengan izin WebFetch(domain:github.com)
  • Menginstruksikan Claude Code tentang pola curl yang diizinkan melalui CLAUDE.md
  • Menggunakan hook untuk validasi izin kustom
Read & Edit Aturan Edit berlaku untuk semua alat bawaan yang mengedit file. Claude akan melakukan upaya terbaik untuk menerapkan aturan Read ke semua alat bawaan yang membaca file seperti Grep, Glob, dan LS. Aturan Read & Edit keduanya mengikuti spesifikasi gitignore dengan empat jenis pola yang berbeda:
PolaArtiContohCocok
//pathPath absolut dari root filesystemRead(//Users/alice/secrets/**)/Users/alice/secrets/**
~/pathPath dari direktori homeRead(~/Documents/*.pdf)/Users/alice/Documents/*.pdf
/pathPath relatif terhadap file pengaturanEdit(/src/**/*.ts)<path file pengaturan>/src/**/*.ts
path atau ./pathPath relatif terhadap direktori saat iniRead(*.env)<cwd>/*.env
Pola seperti /Users/alice/file BUKAN path absolut - ini relatif terhadap file pengaturan Anda! Gunakan //Users/alice/file untuk path absolut.
  • Edit(/docs/**) - Edit di <project>/docs/ (BUKAN /docs/!)
  • Read(~/.zshrc) - Membaca .zshrc direktori home Anda
  • Edit(//tmp/scratch.txt) - Mengedit path absolut /tmp/scratch.txt
  • Read(src/**) - Membaca dari <current-directory>/src/
WebFetch
  • WebFetch(domain:example.com) Cocok dengan permintaan fetch ke example.com
MCP
  • mcp__puppeteer Cocok dengan alat apa pun yang disediakan oleh server puppeteer (nama dikonfigurasi di Claude Code)
  • mcp__puppeteer__puppeteer_navigate Cocok dengan alat puppeteer_navigate yang disediakan oleh server puppeteer
Tidak seperti jenis izin lainnya, izin MCP TIDAK mendukung wildcard (*).Untuk menyetujui semua alat dari server MCP:
  • ✅ Gunakan: mcp__github (menyetujui SEMUA alat GitHub)
  • ❌ Jangan gunakan: mcp__github__* (wildcard tidak didukung)
Untuk menyetujui alat tertentu saja, cantumkan masing-masing:
  • ✅ Gunakan: mcp__github__get_issue
  • ✅ Gunakan: mcp__github__list_issues

​
Kontrol izin tambahan dengan hook

Hook Claude Code menyediakan cara untuk mendaftarkan perintah shell kustom untuk melakukan evaluasi izin saat runtime. Ketika Claude Code melakukan panggilan alat, hook PreToolUse berjalan sebelum sistem izin berjalan, dan output hook dapat menentukan apakah akan menyetujui atau menolak panggilan alat menggantikan sistem izin.

​
Pengaturan kebijakan yang dikelola enterprise

Untuk deployment enterprise Claude Code, kami mendukung pengaturan kebijakan yang dikelola enterprise yang mengambil prioritas atas pengaturan pengguna dan proyek. Ini memungkinkan administrator sistem untuk menegakkan kebijakan keamanan yang tidak dapat diganti oleh pengguna. Administrator sistem dapat menerapkan kebijakan ke:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux dan WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
File kebijakan ini mengikuti format yang sama dengan file pengaturan reguler tetapi tidak dapat diganti oleh pengaturan pengguna atau proyek. Ini memastikan kebijakan keamanan yang konsisten di seluruh organisasi Anda.

​
Prioritas pengaturan

Ketika beberapa sumber pengaturan ada, mereka diterapkan dalam urutan berikut (prioritas tertinggi ke terendah):
  1. Kebijakan enterprise
  2. Argumen baris perintah
  3. Pengaturan proyek lokal (.claude/settings.local.json)
  4. Pengaturan proyek bersama (.claude/settings.json)
  5. Pengaturan pengguna (~/.claude/settings.json)
Hierarki ini memastikan bahwa kebijakan organisasi selalu ditegakkan sambil tetap memungkinkan fleksibilitas di tingkat proyek dan pengguna jika sesuai.

​
Manajemen kredensial

Claude Code mengelola kredensial autentikasi Anda dengan aman:
  • Lokasi penyimpanan: Di macOS, kunci API, token OAuth, dan kredensial lainnya disimpan di macOS Keychain yang terenkripsi.
  • Jenis autentikasi yang didukung: Kredensial Claude.ai, kredensial Claude API, Bedrock Auth, dan Vertex Auth.
  • Skrip kredensial kustom: Pengaturan apiKeyHelper dapat dikonfigurasi untuk menjalankan skrip shell yang mengembalikan kunci API.
  • Interval refresh: Secara default, apiKeyHelper dipanggil setelah 5 menit atau pada respons HTTP 401. Atur variabel lingkungan CLAUDE_CODE_API_KEY_HELPER_TTL_MS untuk interval refresh kustom.