Add Claude (Anthropic) as a BYOK Connector in git-lrc

[vaibhavawasthi99]

Goal

Integrate Anthropic as a BYOK (Bring Your Own Key) connector in git-lrc, enabling users to run AI code reviews using Claude models alongside existing providers.

High-Level Architecture
git diff → Connector → Claude API → Structured Review Output → UI Rendering

Input: staged git diff
Processing: send diff to Claude API
Output: structured review comments (line, issue, severity)
Display: existing git-lrc review UI

Implementation Plan

1. Add Claude Connector Module

Create a new connector (similar to existing providers):

connectors/claude.py (or equivalent based on repo structure)
Responsibilities:
Accept diff and api_key
Call Anthropic API
Return structured review output

2. Claude API Integration

Use Anthropic Messages API:

def review_with_claude(diff, api_key):
    url = "https://api.anthropic.com/v1/messages"

    headers = {
        "x-api-key": api_key,
        "anthropic-version": "2023-06-01",
        "content-type": "application/json"
    }

    prompt = f"""
You are a senior software engineer performing code review.

Analyze the following git diff and return issues in JSON format:
[
  {{
    "line": <line_number>,
    "issue": "<description>",
    "severity": "low|medium|high"
  }}
]

Focus on:
- Bugs
- Security issues
- Logic errors
- Performance risks

Diff:
{diff}
"""

    payload = {
        "model": "claude-3-sonnet-20240229",
        "max_tokens": 1200,
        "messages": [
            {"role": "user", "content": prompt}
        ]
    }

    response = requests.post(url, headers=headers, json=payload)
    return response.json()

3. Response Parsing Layer

Convert Claude output → git-lrc internal format:

def parse_claude_response(response):
    content = response["content"][0]["text"]
    
    try:
        issues = json.loads(content)
    except:
        # fallback if not valid JSON
        issues = [{
            "line": None,
            "issue": content,
            "severity": "medium"
        }]
    
    return issues

4. Integrate into Connector Pipeline

Update provider selection logic:

if provider == "gemini":
    return review_with_gemini(diff)
elif provider == "openai":
    return review_with_openai(diff)
elif provider == "claude":
    return review_with_claude(diff, api_key)

5. Extend BYOK Configuration

Update connector configuration:

Add "claude" as provider option
Accept API key input
Store securely (same as other connectors)

6. UI Integration (lrc ui)

Enhance connector management UI:

Add Claude option in provider list
Input field for API key
Allow prioritization (existing behavior)

7. Error Handling

Handle:

Invalid API key
Rate limits
Token limits (large diffs → chunking if needed)
Non-JSON responses

8. Optional Enhancements (Phase 2)
   Diff chunking for large commits
   Better prompt engineering for inline comments
   Severity classification tuning
   Streaming responses for faster UI feedback

Testing Plan
Unit test Claude connector independently
Validate parsing with:
clean JSON response
malformed response

Integration test:

git add .
git lrc review

Verify:

Comments appear correctly in UI
Line mapping works
Performance is acceptable

Deliverables

Claude connector module
Updated provider selection logic
UI support in lrc ui
Documentation update (README / BYOK section)

**This adds Claude as a first-class BYOK connector, enabling users to:

Choose Claude for reviews
Use their own API key
Maintain existing git-lrc workflow**