The Agent SDK

import { ClaudeCodeAgent } from "@anthropic-ai/claude-code-sdk";

// Create an agent with specific permissions
const agent = new ClaudeCodeAgent({
  model: "claude-sonnet-4-6",
  workingDirectory: "./packages/api",
  tools: {
    allowed: ["read_file", "write_file", "bash"],
    denied: ["web_search"]  // No external access for this agent
  },
  permissions: {
    mode: "acceptEdits",
    allowedCommands: ["npm test", "npm run build", "git status"]
  },
  claudeMd: `
    # API Agent
    You only work on the packages/api directory.
    Always run tests after making changes.
  `
});

// Run the agent
const result = await agent.run(
  "Fix all TypeScript errors in src/ and ensure tests pass"
);

console.log(result.summary);
console.log(result.filesModified);
console.log(result.commandsRun);

// Sequential pipeline
async function reviewAndFix(prNumber: string) {
  const reviewer = new ClaudeCodeAgent({
    model: "claude-opus-4-5",
    task: `Review PR #${prNumber} for issues`
  });

  const issues = await reviewer.run();

  if (issues.criticalIssuesFound) {
    const fixer = new ClaudeCodeAgent({
      model: "claude-sonnet-4-6",
      context: issues.summary,
      task: "Fix the critical issues identified in the review"
    });

    await fixer.run();
  }

  return issues;
}

// Fan-out pattern
async function parallelAudit(directories: string[]) {
  const agents = directories.map(dir =>
    new ClaudeCodeAgent({
      workingDirectory: dir,
      task: "Audit this directory for security vulnerabilities"
    })
  );

  const results = await Promise.all(agents.map(a => a.run()));

  const synthesizer = new ClaudeCodeAgent({
    context: results.map(r => r.summary).join("\n"),
    task: "Synthesize the audit findings and create a prioritized remediation plan"
  });

  return await synthesizer.run();
}

const agent = new ClaudeCodeAgent({ task: "Implement the new feature" });

agent.on("tool_use", (event) => {
  console.log(`Claude is using: ${event.tool} on ${event.file}`);
});

agent.on("file_modified", (event) => {
  notifyDeveloper(`${event.file} was modified`);
});

agent.on("test_result", (event) => {
  if (!event.passed) {
    console.warn(`Test failed: ${event.test_name}`);
  }
});

const result = await agent.run();