# Claude AI

> Anthropic Claude AI — generate text, analyze documents, chat with history, and call tools via Claude models. Supports vision, thinking mode, MCP integration, and function calling via `robomotion claude`. Do NOT use for OpenAI, Gemini, or direct conversation — this runs Claude API calls through the Robomotion CLI.

- Skill: `robomotionio/claude-ai` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add robomotionio/claude-ai`
- Raw SKILL.md: https://api.skillmd.com/api/skills/robomotionio/claude-ai/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: robomotionio (https://skillmd.com/u/robomotionio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/robomotionio/claude-ai

---

# Claude AI (Anthropic)

The `robomotion claude` CLI calls the Anthropic Claude API for text generation, document analysis, chat completions with history, and tool/function calling. It supports vision (image inputs), extended thinking mode, MCP server integration, and model listing.

## When to use
- Generate text or chat responses with Claude models (Opus, Sonnet, Haiku)
- Analyze documents (PDF, images) using Claude's vision and Files API
- Use function calling / tool use with Claude for structured workflows
- Integrate with MCP servers for extended capabilities

## Prerequisites
- `robomotion` CLI installed
- Package installed: `robomotion install claude`
- Anthropic API key configured via Robomotion vault

## IMPORTANT: Session Mode Required for Multi-Step Operations
Each CLI command runs as a **separate process** — connection IDs from `connect` do NOT persist across calls.
You MUST use `--session` on `connect` and pass `--session-id` to all subsequent commands.

## Workflow
1. Install (once): `robomotion install claude`
2. Connect with session:
   ```
   robomotion claude connect_claude --session --output json
   # → {"outConnectionId":"<connection-id>","session_id":"<session-id>"}
   ```
3. Use the returned `connection-id` and `session-id` in all subsequent commands:
   ```
   robomotion claude generate_text --connection-id "<connection-id>" --system-prompt <prompt> --user-prompt <prompt> --session-id "<session-id>" --output json
   ```
4. Disconnect when done:
   ```
   robomotion claude disconnect_claude --connection-id "<connection-id>" --session-id "<session-id>" --output json
   ```

**Always** append `--output json` to get structured JSON results.

## Commands Reference
- `robomotion claude connect_claude --session --output json`
  Connect to Anthropic Claude API and create a client session
- `robomotion claude generate_text --connection-id --system-prompt --user-prompt --image-paths --image-paths [--model] [--custom-model] [--max-tokens] [--temperature] [--top-p] [--top-k] [--thinking-mode] [--thinking-budget] [--120] --session-id "<session-id>" --output json`
  Generate text responses from Claude AI with optional vision capabilities
- `robomotion claude generate_chat_text --connection-id --system-prompt --user-prompt --history [--model] [--custom-model] [--max-tokens] [--temperature] [--top-p] [--top-k] [--stop-sequences] [--thinking-mode] [--thinking-budget] [--120] --session-id "<session-id>" --output json`
  Generate chat responses from Claude AI with conversation history support
- `robomotion claude analyze_document --connection-id --system-prompt --user-prompt --file-paths --file-paths [--model] [--custom-model] [--max-tokens] [--temperature] [--top-p] [--top-k] [--thinking-mode] [--thinking-budget] [--300] --session-id "<session-id>" --output json`
  Analyze documents using Claude AI with Beta Files API support
- `robomotion claude call_tool --connection-id --prompt --tools --history [--model] [--custom-model] [--max-tokens] [--max-tool-rounds] [--120] --session-id "<session-id>" --output json`
  Call tools using Claude AI function calling capabilities
- `robomotion claude mcp_message --connection-id --prompt --mcp-servers [--model] [--custom-model] [--max-tokens] [--120] --session-id "<session-id>" --output json`
  Send messages using Claude AI with Model Context Protocol (MCP) integration
- `robomotion claude list_models --connection-id [--30] --session-id "<session-id>" --output json`
  List available Claude models from the Anthropic API
- `robomotion claude disconnect_claude --connection-id --session-id "<session-id>" --output json`
  Disconnect from Claude API and release the client session

## Environment
- ROBOMOTION_API_TOKEN (if vault credentials are needed)