agentica-claude-proxy

# Agentica-Claude Code Proxy Integration Use this skill when developing or debugging the Agentica-Claude proxy integration. ## When to Use - Setting up Agentica agents to use Claude Code tools - Debugging agent hallucination issues - Fixing permission errors in file operations - Understanding the REPL response format ## Architecture Overview ``` Agentica Agent → S_M_BASE_URL → Claude Proxy → claude -p → Claude CLI (with tools) (localhost:2345) (localhost:8080) ``` ## Critical Requirements ### 1. --allowedTools Flag (REQUIRED) Claude CLI in `-p` mode restricts file operations. You MUST add: ```python subprocess.run([ "claude", "-p", prompt, "--append-system-prompt", system_prompt, "--allowedTools", "Read", "Write", "Edit", "Bash", # REQUIRED ]) ``` Without this, agents will report "permission denied" for Write/Edit operations. ### 2. SSE Streaming Format (REQUIRED) Agentica expects SSE streaming, not plain JSON: ```python # Response format yield f"data: {json.dumps(chunk)}\n\n" yield "data: [DONE]\n\n" ``` ### 3. REPL Response Format (REQUIRED) Agents MUST return results as Python code blocks with a return statement: ```python return "your result here" ``` Agentica's REPL parser extracts code between \`\`\`python and \`\`\`. ## Anti-Hallucination Prompt Engineering Agents will hallucinate success without actually using tools unless you explicitly warn them: ``` ## ANTI-HALLUCINATION WARNING **STOP AND READ THIS CAREFULLY:** ...