Claude Code அமர்வு தொடக்கத்தில் வரையறுக்கப்பட்ட திட்டச் சூழல் hook சேர்க்கவும்

Claude Code hook என்பது அமர்வின் குறிப்பிட்ட தருணத்தில் செயலி இயக்கும் கட்டளை. இந்த வழிகாட்டி திட்ட எல்லைக்குள் ஒரு SessionStart hook சேர்க்கிறது. அது தற்போதைய Git கிளையைப் படித்து உரையாடல் தொடங்கும்போதோ தொடரும்போதோ குறுகிய சூழல் வரியை வழங்கும். இதன் அடிப்படை Anthropic இன் தற்போதைய hook குறிப்பேடு; இதை 2026 அக்டோபர் 19 அன்று சரிபார்த்தோம். BIG CHANGE Node மூலம் ஸ்கிரிப்டை நேரடியாகவும் அமைப்புகளின் JSONஐயும் சரிபார்த்தது; Claude Code hook இயக்கவோ மாதிரி பதிலைச் சோதிக்கவோ இல்லை.

முக்கிய மாற்றம்

• என்ன மாறியது: இந்தத் திட்டத்தின் SessionStart hook, Claude Code உரையாடலைத் தொடங்கும்போதோ தொடரும்போதோ குறுகிய Git கிளை வரியை வழங்குகிறது.
• ஏன் முக்கியம்: ஒவ்வொரு முறையும் கையால் ஒட்டாமல் தொடக்கம் அல்லது மீண்டும் தொடரும்போது தற்போதைய கிளை அமர்வுச் சூழலுக்கு வருகிறது.
• கவனிக்க வேண்டியது: சூழல் ஒரு விதியைக் கட்டாயப்படுத்தாது; மாதிரி பதிலுக்கும் உத்தரவாதமில்லை. உங்கள் நம்பகமான திட்டத்தில் தொடக்கம், மீண்டும் தொடர்தல் ஆகியவற்றில் உண்மையாகக் கிடைக்கிறதா எனப் பாருங்கள்.

நிறுவுவதற்கு முன்

மாற்ற அனுமதி உள்ள Git திட்டத்தைப் பயன்படுத்துங்கள். ஒரே முனையத்தில் Claude Code, Node.js, Git கிடைக்க வேண்டும்; திட்டத்தின் .claude/settings.json கோப்பைத் திருத்தவும் அனுமதி வேண்டும். சரிபாருங்கள்: node --version, git --version , claude --version. தயாரிப்பு கணினியில் Claude Code 2.1.301, Node 24.19.0 இருந்தன; இவை பார்த்த பதிப்புகள், குறைந்தபட்சத் தேவைகள் அல்ல.

மாதிரிக்கு அனுப்புமுன் கிளையின் பெயரைப் பாருங்கள். கிளைப் பெயரில் வாடிக்கையாளர், கோரிக்கை அல்லது சம்பவத்தின் பெயர் இருக்கலாம். எழுத்துகளை வடிகட்டுவதும் உரையைச் சுருக்குவதும் அதன் பொருளை அகற்றாது. கிளைப் பெயர் மாதிரி சூழலுக்கு அனுமதிக்கப்பட்டால் மட்டுமே எடுத்துக்காட்டை நிறுவுங்கள். இல்லையெனில் அனுமதிக்கப்பட்ட உணர்வுப்பூர்வமற்ற நிலையை வெளியிட ஸ்கிரிப்டை மாற்றி, நிறுவுமுன் மாற்றத்தை ஆய்வு செய்யுங்கள். Anthropic இன் தரவுப் பயன்பாட்டு ஆவணம் சேவையின் தரவுக் கையாளுதலை விளக்குகிறது; உங்கள் திட்டத்தின் அனுமதிகளையும் பின்பற்றுங்கள்.

Hook கட்டளைகள் உங்கள் பயனர் அனுமதிகளுடன் இயங்குகின்றன. செயல்படுத்துமுன் இருக்கும் திட்ட மற்றும் பயனர் hookகள், நிறுவனக் கொள்கை, முழு ஸ்கிரிப்ட் ஆகியவற்றைப் பாருங்கள். திட்ட அமைப்புகள் களஞ்சியத்தில் commit செய்யப்படலாம்; .claude/settings.local.json உள்ளூரிலேயே இருக்கும். இந்த எடுத்துக்காட்டு திட்ட அமைப்புக் கோப்பைப் பயன்படுத்துவதால் கட்டமைப்பு அந்தத் திட்டத்திற்கு மட்டுமே பொருந்தும்.

இரு கோப்புகளை நிறுவுங்கள்

1. திட்டத்திற்குள் .claude/hooks/ உருவாக்குங்கள். முழுத் தொகுதியையும் .claude/hooks/session-context.cjs என்ற பெயரில் சேமியுங்கள்.

'use strict';

const { execFileSync } = require('node:child_process');

const project = process.env.CLAUDE_PROJECT_DIR;
if (!project) {
  process.stderr.write('CLAUDE_PROJECT_DIR is unavailable\n');
  process.exit(1);
}

try {
  const raw = execFileSync('git', ['-C', project, 'branch', '--show-current'], {
    encoding: 'utf8',
    timeout: 1500,
    maxBuffer: 4096,
    stdio: ['ignore', 'pipe', 'pipe'],
  }).trim();
  const branch = raw ? raw.replace(/[^A-Za-z0-9._/-]/g, '_').slice(0, 80) : 'detached HEAD';
  process.stdout.write(`Current project branch: ${branch}\n`);
} catch {
  process.stderr.write('Could not read the project branch; check Git and project path\n');
  process.exit(1);
}

Git துணைச் செயல்முறைக்கு 1.5 வினாடி நேரவரம்பும் 4,096 பைட் வெளியீட்டு இடையகமும் உண்டு. detached HEAD போன்ற நிலையில் கிளை முடிவு காலியாக இருந்தால் அது detached HEAD ஆகும். திட்டப் பாதை இல்லாவிட்டால் அல்லது Git தோற்றால் குறுகிய stderr கண்டறிதலும் வெளியேற்றக் குறியீடு 1உம் வரும்.

2. ஏற்கெனவே உள்ள உங்கள் .claude/settings.json கோப்பைத் திறக்கவும். கீழுள்ள hooks.SessionStart பதிவை மற்ற அமைப்புகள், hook குழுக்களுடன் இணைத்து, பழைய பதிவுகளைப் பாதுகாக்கவும். ஆய்வு செய்த தொகுப்பின் முழு settings.example.json ஐ இந்தத் தொகுதி காட்டுகிறது. கோப்பில் ஏற்கெனவே SessionStart பதிவுகள் இருந்தால் வரிசையை மாற்றாமல் அதில் இக்குழுவைச் சேர்க்கவும்.

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "node",
            "args": ["${CLAUDE_PROJECT_DIR}/.claude/hooks/session-context.cjs"],
            "timeout": 5
          }
        ]
      }
    ]
  }
}

Matcher புதிய அமர்வையும் மீண்டும் தொடரும் அமர்வையும் உள்ளடக்கும். Anthropic clear, compact , fork ஆகியவற்றையும் SessionStart மூலங்களாக ஆவணப்படுத்துகிறது; எடுத்துக்காட்டு அவற்றை வேண்டுமென்றே தவிர்க்கிறது. args புலம் exec வடிவத்தைத் தேர்வு செய்கிறது: Claude Code node ஐ அழைக்கும்போது தீர்மானிக்கப்பட்ட திட்ட ஸ்கிரிப்ட் பாதையை ஒரே argument ஆகத் தருகிறது; shell quoting அல்லது parsing இல்லை. Windowsஇல் node.exe உண்மையான executable ஆகக் கிடைக்க வேண்டும்; .cmd shim exec வடிவத்திற்கு ஏற்றதல்ல. கட்டளையின் ஐந்து வினாடி hook நேரவரம்பு, ஸ்கிரிப்டின் 1.5 வினாடி Git வரம்பிலிருந்து வேறானது.

முதலில் ஸ்கிரிப்ட், பிறகு Claude Code சரிபார்க்கவும்

3. Claude Code திறப்பதற்கு முன் திட்ட முனையத்தில் ஸ்கிரிப்டை இயக்கி வெளியீட்டை Git உடன் ஒப்பிடுங்கள். PowerShellஇல்:

$env:CLAUDE_PROJECT_DIR = (Get-Location).Path
node .claude/hooks/session-context.cjs
git branch --show-current

Bashஇல்:

CLAUDE_PROJECT_DIR="$PWD" node .claude/hooks/session-context.cjs
git branch --show-current

ஸ்கிரிப்ட் stdoutஇல் சரியாக ஒரு வரி இருக்க வேண்டும்: Current project branch: BRANCH, இதில் BRANCH என்பது ஸ்கிரிப்டின் எழுத்து வடிகட்டி, 80 எழுத்து வரம்புக்குப் பிந்தைய Git முடிவு. Detached HEAD நிலையில் Current project branch: detached HEAD அச்சிடப்படும். நேரடிச் சரிபார்ப்பு இந்த முனையத்தில் உள்ளூர் ஸ்கிரிப்ட் வேலை செய்கிறது என்பதை மட்டுமே நிரூபிக்கும். எங்கள் தயாரிப்புச் சரிபார்ப்பில் சாதாரண கிளை முடிவு Git உடன் பொருந்தியது; இல்லாத மற்றும் தவறான திட்டப் பாதைகள் காலியான stdout, stderr கண்டறிதல், வெளியேற்றம் 1 கொடுத்தன. நீண்ட பெயர் வரம்பையும் detached HEAD மாற்று மதிப்பையும் மூலத்தில் ஆய்வு செய்தோம்; அந்த நிலைகளை இயக்கவில்லை.

4. நம்பகமான திட்டத்தில் புதிய ஊடாடும் Claude Code செயல்முறையை claude --debug-file STARTUP_PRIVATE_LOG உடன் தொடங்கி உங்கள் கட்டுப்பாட்டிலுள்ள தனிப்பட்ட பாதையைப் பயன்படுத்துங்கள். workspace trust ஏற்குமுன் திட்ட மற்றும் பயனர் hookகளைப் பாருங்கள். debug பதிவில் SessionStart நிகழ்வு, மூலம் startup, தேர்ந்தெடுத்த ஸ்கிரிப்ட் பாதை, வெளியேற்ற நிலை, வெளியீட்டுக் கையாளுதல் ஆகியவற்றைப் பாருங்கள். கருவி பயன்படுத்தவோ தனியே Git படிக்கவோ அனுமதிக்காமல் Claudeக்கு எந்தக் கிளைச் சூழல் கிடைத்தது என்று கேளுங்கள். பதில், debug பதிவு ஆகியவற்றை நேரடி முடிவுடன் ஒப்பிடுங்கள். Hook stdout Claude சூழலில் சேரும்; காட்சி UIஇல் செய்தியாகத் தோன்றும் என உறுதி இல்லை.
5. அந்த அமர்விலிருந்து வெளியேறுங்கள். தனிச் செயல்முறையில் claude --debug-file RESUME_PRIVATE_LOG --resume கொண்டு தொடருங்கள்; பின்னர் SessionStart resume நிகழ்வைப் பார்த்து கருவி அல்லது Git மறுவாசிப்பு இல்லாமல் கேள்விச் சரிபார்ப்பை மீண்டும் செய்யுங்கள். இரு debug பதிவுகளையும் தனிப்பட்டதாக வைத்திருங்கள்; திட்ட விவரங்கள் வெளியாகலாம். ஊடாடாத -p அல்லது SDK இயக்கத்தில் அதே workspace-trust கேள்வி வராது; களஞ்சிய hookகள் தானாக இயங்கலாம். எனவே இந்தச் சரிபார்ப்பிற்கு ஊடாடும் முறையைப் பயன்படுத்துங்கள். கோப்புக் கண்காணிப்பான் பொதுவாக hook அமைப்பு மாற்றங்களைக் கண்டறியும் என Anthropic சொல்கிறது; புதிய செயல்முறை தொடக்கம், மீண்டும் தொடர்தல் சோதனையைத் தெளிவாக்கும்.

பின்னர் இயல்பான திட்டப் பணியால் கிளை மாறினால் நேரடிச் சரிபார்ப்பையும் புதிய அமர்வையும் மீண்டும் செய்து வரி மாறுகிறதா பாருங்கள். இந்த வழிகாட்டியைச் சோதித்ததாகக் கூறுவதற்காக மட்டும் கிளைகளை மாற்றாதீர்கள்.

இயங்காவிட்டால்

ஸ்கிரிப்டின் நேரடி முடிவில் தொடங்கி JSON இணைப்பு, SessionStart எழுத்துக்கூட்டல், startup|resume matcher, திட்ட-வேர் பாதை, node , git கிடைப்பது, workspace trust, debug பிழைகள் ஆகியவற்றைச் சரிபார்க்கவும். CLAUDE_PROJECT_DIR இல்லையெனில் CLAUDE_PROJECT_DIR is unavailable stderrஇல் அச்சிடப்படும். தவறான திட்டப் பாதை அல்லது Git தோல்வியில் Could not read the project branch; check Git and project path அச்சிடப்படும். இரண்டும் வெளியேற்றம் 1 கொடுக்கும்; சூழல் வரி இல்லை. SessionStart தோல்வி கண்டறிதலுக்கானது, தடுப்பதல்ல; செயலுக்கான அனுமதி வாயிலாகப் பயன்படாது. கருவிச் செயலைக் கட்டுப்படுத்த Anthropic PreToolUse ஐ ஆவணப்படுத்துகிறது; அது வேறு நிகழ்வு, தனியே ஆய்வு செய்த வடிவமைப்பு தேவை.

ஸ்கிரிப்ட் உள்ளூர் Git மட்டுமே இயக்கும்; வலையமைப்பு கோரிக்கையோ மாதிரி அழைப்போ செய்யாது. Claude Code தொடக்கம், தொடர்தல், கேள்விச் சரிபார்ப்புகள் கணக்கு, வழங்குநர் அல்லது மாதிரி பயன்பாட்டு ஒதுக்கீட்டைச் செலவிடலாம்; Anthropic செலவு வழிகாட்டியில் தற்போதைய விதிகள் உள்ளன. இங்கு நிலையான விலையோ கட்டணம் செலுத்திய அமர்வுச் சோதனையோ அறிவிக்கப்படவில்லை.

உரையாடல் தொடங்கிய பின்பான தனிப் பணிக்கு எங்கள் Claude Code அமர்வுச் சூழலை ஆய்வு செய்து தொடரும் வழிகாட்டி சூழல் ஆய்வையும் தொடர்தலையும் விளக்குகிறது. இந்தத் தொடக்க hookஐ அமைக்காது.

மூலங்கள் மற்றும் கூடுதல் வாசிப்பு

• Anthropic, Claude Code hook குறிப்பேடு — தற்போதைய முதன்மை விவரக்குறிப்பு 2026 அக்டோபர் 19 அன்று சரிபார்க்கப்பட்டது. இதில் SessionStart மூலங்கள், matcherகள், exec வடிவம் args, பாதை placeholderகள், stdout சூழல், அமைப்பு மறுஏற்றம், நம்பிக்கை, debug பதிவுகள், தடுக்காத தோல்வி விளக்கப்பட்டுள்ளன. இது ஆவண ஆதாரம், BIG CHANGE hook இயக்கியது அல்ல.
• Anthropic, hookகளால் செயல்களைத் தானியக்கமாக்குங்கள் — hook அமைப்பு, சோதனைக்கான அதிகாரப்பூர்வ வழிமுறை. மேலுள்ள துல்லியமான ஸ்கிரிப்ட், அமைப்புகள் இந்த வழிகாட்டிக்காக ஆய்வு செய்த வரையறுக்கப்பட்ட BIG CHANGE எடுத்துக்காட்டு; வழங்குநர் சோதனை முடிவின் நகல் அல்ல.
• Anthropic, Claude Code அமைப்பு — நிறுவல் மற்றும் சூழல் தேவைகள். எடுத்துக்காட்டைப் பயன்படுத்துமுன் தற்போதைய தள வழிமுறைகளைப் பாருங்கள்.
• Anthropic, Claude Code தரவுப் பயன்பாடு — கிளைத் தகவலை மாதிரிச் சூழலுக்கு அனுப்புமுன் ஆய்வு செய்ய வேண்டிய வழங்குநரின் தற்போதைய தரவுக் கையாளுதல் விதிகள்; திட்ட அனுமதி தனியான முடிவு.
• Anthropic, செலவுகளைத் திறம்பட நிர்வகிக்கவும் — ஊடாடும் சரிபார்ப்புகளுக்கான தற்போதைய கணக்கு, பயன்பாட்டு வழிமுறை. உள்ளூர் Git ஸ்கிரிப்ட் தானே மாதிரி அல்லது வலையமைப்பு கோரிக்கை செய்யாது.