Acha Kubonyeza Approve: Jinsi ya Kurekebisha Ruhusa za Claude Code CLI

Nilitumia muda mwingi zaidi kubonyeza "Approve" kuliko kupitia kazi wakati wa kazi yangu ya kwanza na Claude Code.

Kila faili lililosomwa. Kila hali ya git. Kila amri.

Kufikia mwisho, nilikuwa nimebonyeza prompts arobaini. Nilijihisi kutokuwa na imani na mabadiliko hayo kuliko nilivyokuwa nilipoanza. Mfumo wa ruhusa ulinifanya nianze kukubali kila kitu bila kulisoma (rubber-stamping).

Lazima uweke mipangilio ya ruhusa ili ukubali tu yale muhimu.

Claude Code si dirisha la mazungumzo (chat window). Inasoma faili, inaandika faili, na kuendesha amri za shell. Mbinu ya jumla ya "kukubali kila kitu" ni hatari.

Modes zinafafanua jinsi Claude inavyofanya kazi wakati hakuna sheria maalum iliyopo.

• default: Salama kwa miradi mipya. Reads: Auto. Edits: Asks. Bash: Asks. • plan: Bora kwa mapitio ya kodi (code reviews). Reads: Auto. Edits: Blocked. Bash: Blocked. • acceptEdits: Bora kwa uandishi wa kodi unaoendelea. Reads: Auto. Edits: Auto. Bash: Asks. • bypassPermissions: Bora kwa CI/CD. Reads: Auto. Edits: Auto. Bash: Auto.

Unabadilisha modes kwa kutumia amri ya /permissions.

Mipangilio hufuata utaratibu wa daraja (hierarchy). Kiwango cha juu zaidi daima hushinda.

  1. Sera ya kampuni (Enterprise policy)
  2. Mipangilio ya mtumiaji (~/.claude/settings.json)
  3. Mipangilio ya mradi (.claude/settings.json)
  4. Mradi wa ndani (.claude/settings.local.json)

Sheria hutumia mfumo rahisi: allow, deny, au ask.

Muhimu: Mpangilio wa tathmini ni deny, kisha ask, kisha allow. Deny daima hushinda.

Ikiwa unataka kuzima zana (tool) kabisa, tumia jina lake pekee. Ikiwa unataka kuwekea mipaka zana, tumia sheria ya kiwango maalum (scoped rule) kwa kutumia mfumo wa glob pattern.

Mfano kwa maendeleo yanayoendelea:

  • Allow: Bash(npm run *), Bash(git status)
  • Deny: Bash(rm -rf *), Bash(curl *)
  • Ask: Bash(git push *)

Unaweza pia kulinda data nyeti. Tumia sheria ya deny kwa faili kama .env ili kuhakikisha Claude haisomi kamwe siri zako (credentials).

Vidokezo vya kitaalamu kwa mtiririko wako wa kazi:

  • Tumia /permissions kwenye CLI ili kufungua UI inayoweza kuingiliana (interactive UI).
  • Ongeza sheria kwa kitu chochote unachokubali zaidi ya mara mbili.
  • Tumia bendera (flags) kama --permission-mode ili kuweka sheria kwa kikao kimoja bila kubadilisha faili.
  • Katika CI/CD, tumia bypassPermissions pamoja