Claude как «руки» на твоём сервере

Зачем вообще это нужно

Простой путь: Claude Code на сервере

Свой агент: tool use через API

Главное правило: песочница и whitelist

Куда положить ключ ANTHROPIC_API_KEY

// agent.mjs — запусти как: node agent.mjs
// Установка: npm i @anthropic-ai/sdk
import Anthropic from '@anthropic-ai/sdk';
import { readFile, writeFile } from 'node:fs/promises';
import readline from 'node:readline/promises';

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

// === ОПИСАНИЕ ТУЛОВ для Claude ===
// Claude увидит эти описания и решит когда вызывать.
const tools = [
  {
    name: 'read_file',
    description: 'Прочитать файл из папки ./data/. Возвращает содержимое.',
    input_schema: {
      type: 'object',
      properties: {
        path: { type: 'string', description: 'Путь, например ./data/products.json' },
      },
      required: ['path'],
    },
  },
  {
    name: 'write_file',
    description: 'Перезаписать файл новым содержимым. Только в ./data/.',
    input_schema: {
      type: 'object',
      properties: {
        path: { type: 'string' },
        content: { type: 'string' },
      },
      required: ['path', 'content'],
    },
  },
];

// === ОБРАБОТЧИКИ — что РЕАЛЬНО делать когда Claude вызвал tool ===
const handlers = {
  read_file: async ({ path }) => {
    if (!path.startsWith('./data/')) return { error: 'Доступ только к ./data/' };
    return { content: await readFile(path, 'utf-8') };
  },
  write_file: async ({ path, content }) => {
    if (!path.startsWith('./data/')) return { error: 'Доступ только к ./data/' };
    await writeFile(path, content);
    return { ok: true };
  },
};

// === ЦИКЛ АГЕНТА ===
async function runAgent(userMessage) {
  const messages = [{ role: 'user', content: userMessage }];
  let iterations = 0;

  while (iterations++ < 10) {           // лимит — защита от зацикливания
    const r = await client.messages.create({
      model: 'claude-sonnet-4-6',
      max_tokens: 1024,
      tools,
      messages,
    });
    messages.push({ role: 'assistant', content: r.content });

    if (r.stop_reason !== 'tool_use') {
      // Claude закончил — отдаём текст пользователю
      return r.content.find((b) => b.type === 'text')?.text ?? 'готово';
    }

    // Выполняем все запрошенные тулы и возвращаем результаты
    const toolUses = r.content.filter((b) => b.type === 'tool_use');
    const results = [];
    for (const use of toolUses) {
      console.log('→ tool:', use.name, use.input);
      const handler = handlers[use.name];
      const result = handler ? await handler(use.input) : { error: 'Нет такого тула' };
      results.push({
        type: 'tool_result',
        tool_use_id: use.id,
        content: JSON.stringify(result),
      });
    }
    messages.push({ role: 'user', content: results });
  }
}

// === ДЕМО ===
const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
const ask = await rl.question('Что сделать? ');
const answer = await runAgent(ask);
console.log('\n→', answer);
rl.close();

// Пример запроса:
// "В файле ./data/products.json у товара 'Молоко' измени price на 95"
// Claude САМ: 1) read_file → видит JSON 2) меняет цифру 3) write_file 4) пишет "готово"

Минимальный агент: Claude меняет JSON-конфиг через две функции read_file/write_file