Documentation Index
Fetch the complete documentation index at: https://docs.claude-space.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Agent Node (Main Card)
The main agent card is the heart of your AI agent. It defines personality, behavior, model selection, and permissions.Overview
Always present: Every project has exactly 1 main agent card Location: Center of canvas by default Color: Gradient purple/blue Icon: Customizable (emoji or custom image) Required: Yes (cannot be deleted) [Screenshot: Main agent card with labeled components] Purpose:- Define agent personality and behavior via system prompt
- Select AI model (Claude Opus/Sonnet/Haiku)
- Configure permissions and sandbox settings
- Set temperature, max tokens, and other parameters
- Connect to all other node types (skills, memory, MCPs, etc.)
Configuration Sections
1. Basic Information
Name- Agent’s display name shown in chat interface
- Appears in dashboard project cards
- Used in exported
.claudefolder
- Brief summary of agent’s purpose
- Internal documentation (not sent to Claude)
- Shows on dashboard cards
- Visual identifier for your agent
- Emoji or custom image (PNG, JPG)
- Click icon to change
- 📧 Email handler
- 💻 Code reviewer
- 📊 Data analyzer
- 🔍 Researcher
- 💬 Chatbot
2. System Prompt
The system prompt is the most important configuration. It defines your agent’s:- Role and personality
- Instructions and guidelines
- Output format
- Constraints and limitations
✅ Do:
1. Start with clear role definition❌ Don’t:
1. Vague instructionsExample System Prompts
Example 1: Email Summarizer
Example 2: Code Reviewer
Example 3: Customer Support Bot
3. Claude Settings
Configure the Claude AI model and behavior parameters. [Screenshot: Claude Settings panel expanded]Model Selection
Choose the right Claude model for your use case:| Model | Best For | Speed | Cost | Token Limit |
|---|---|---|---|---|
| claude-opus-4-5 | Complex reasoning, coding, analysis | Slow | High | 200K |
| claude-sonnet-4-5 | General-purpose, balanced | Medium | Medium | 200K |
| claude-haiku-4-0 | Simple tasks, speed-critical | Fast | Low | 200K |
- Complex reasoning required (multi-step logic)
- Code generation and debugging
- Deep analysis and research
- Quality is more important than speed
- General-purpose tasks
- Balanced speed and quality
- Most common use cases
- Cost-effectiveness matters
- Simple, well-defined tasks
- Speed is critical
- High-volume operations
- Cost minimization important
Temperature (0.0 - 1.0)
Controls response randomness and creativity.- Code review and analysis
- Data extraction
- Factual question answering
- Consistent formatting
- General assistance
- Email drafting
- Document summarization
- Mixed creative/factual tasks
- Creative writing
- Brainstorming
- Idea generation
- Story telling
Max Tokens
Maximum length of response in tokens (roughly 4 characters per token). Common values:| Tokens | Approx Words | Approx Pages | Use Case |
|---|---|---|---|
| 512 | ~380 | 0.5 | Short summaries |
| 1024 | ~760 | 1 | Standard responses |
| 2048 | ~1500 | 2 | Detailed analysis |
| 4096 | ~3000 | 4 | Long-form content |
| 8192 | ~6000 | 8 | Comprehensive reports |
- Short answers (summaries, quick questions) → 512-1024
- Standard responses (email drafts, code reviews) → 1024-2048
- Long content (reports, documentation) → 4096-8192
4. Permissions
Control what your agent can access and modify. Three permission levels:- Allow (🟢) - Agent can use without asking
- Ask (🟡) - Agent requests permission each time
- Deny (🔴) - Agent cannot use at all
File System Permissions
read- Read file contents
- View file metadata
- Safe for most agents
- Create new files
- Modify existing files
- ⚠️ Use with caution
- Remove files permanently
- ⚠️ Very dangerous - usually deny
- Browse folder structure
- List files and directories
- Safe to allow
Execution Permissions
bash- Run shell commands
- Execute scripts
- ⚠️ Powerful - recommend ask
- Execute code in specific language
- ⚠️ Can modify system - recommend ask
Network Permissions
network- Make HTTP requests
- Access external APIs
- ⚠️ Can leak data - configure carefully
- Call external services
- Database connections
- ⚠️ Depends on API - review per case
Recommended Configurations
Low-Risk Agent (Read-only)5. Permission Modes
Control how your agent handles permission requests during chat. [Screenshot: Permission mode dropdown] Available Modes: default (Recommended for development)- Agent asks for permission on each tool use
- User approves/denies in chat interface
- Safest option
- Auto-approve file modifications
- Still asks for dangerous operations (delete, execute)
- Good for iterative development
- Run all tools without asking
- ⚠️ Dangerous - only for trusted workflows
- Use in controlled environments only
- Agent shows plan before execution
- User reviews full workflow
- Proceeds after approval
- No approval notifications
- Tools run based on permissions
- User not interrupted
default, move to acceptEdits once workflow is tested.
6. Sandbox Mode
Isolate your agent from system-level access. Enabled (✅ Recommended for testing)- Agent runs in isolated environment
- Limited file system access
- No system-level commands
- Safe for experimentation
- Full system access based on permissions
- Can execute any allowed command
- Required for some production use cases
- ⚠️ Review security implications
Connections
The main agent card connects to all other node types via specialized handles.Handle Locations
Connection Examples
Connect a Skill
- Hover over main card right edge
- Drag from right handle (circle appears)
- Drop on skill node
- Red connection line appears
Connect Memory
- Hover over main card bottom-left area
- Drag from bottom-left handle
- Drop on memory node
- Green connection line appears
Connect Sub-agent
- Hover over main card bottom center
- Drag from bottom handle
- Drop on sub-agent node
- Purple connection line appears
Connect Hook
- Hover over main card top-left
- Drag from top-left handle
- Drop on hook node
- Yellow connection line appears
Connect MCP
- Hover over main card top-right
- Drag from top-right handle
- Drop on MCP node
- Blue connection line appears
Real-World Examples
Example 1: Customer Support Agent
Use Case: Handle customer inquiries with empathy and accuracy Configuration: Name: Customer Support Bot Description: Assists customers with product questions and issues Icon: 💬 System Prompt:- Model: claude-sonnet-4-5 (balanced)
- Temperature: 0.5 (natural conversation)
- Max Tokens: 2048 (detailed responses)
- 🧠 Memory → Company KB (policies, FAQs)
- 🛠️ Skill → Ticket Creator
- 🔌 MCP → CRM Database (read-only)
Example 2: Code Quality Guardian
Use Case: Review code for bugs, security, and style Configuration: Name: Code Quality Guardian Description: Comprehensive code review for security and best practices Icon: 🛡️ System Prompt:- Model: claude-opus-4-5 (best reasoning)
- Temperature: 0.2 (consistent analysis)
- Max Tokens: 4096 (detailed reviews)
- 🛠️ Skill → File System (read code)
- 🧠 Memory → Style Guide
- 🪝 Hook → PreToolUse (log all file reads)
- 🎭 Sub-agent → Security Scanner (specialized)
Example 3: Research Assistant
Use Case: Comprehensive research with citation Configuration: Name: Research Assistant Pro Description: Researches topics and generates cited reports Icon: 🔍 System Prompt:- Model: claude-sonnet-4-5 (balanced)
- Temperature: 0.4 (mostly factual, some synthesis)
- Max Tokens: 8192 (long reports)
- 🛠️ Skill → Web Search
- 🛠️ Skill → File System
- 🧠 Memory → Research Guidelines
- 🔌 MCP → Context7 (documentation lookup)
Best Practices
System Prompt Design
✅ Do:Model Selection Strategy
Permission Strategy
Development Phase:Troubleshooting
Agent doesn’t respond or gives errors
Problem: Chat hangs or shows “Agent failed to respond” Solutions:- Check Claude authentication (Settings → Claude Configuration)
- Verify model selection is valid
- Check permissions allow needed operations
- Review system prompt for conflicts
- Reduce temperature if outputs are erratic
Agent ignores system prompt
Problem: Agent doesn’t follow instructions or format Solutions:- Lower temperature (try 0.2-0.4)
- Add explicit examples in system prompt
- Use stronger directives (“You MUST…”, “Always…”, “Never…”)
- Simplify instructions (break into smaller steps)
- Test with different model (Opus more instruction-following)
Permission errors in chat
Problem: “Permission denied” or tool calls fail Solutions:- Check permissions in agent config match needed operations
- Change permission mode to
defaultto see approval requests - Verify sandbox mode isn’t blocking needed operations
- Review file/directory paths are within allowed directories
Responses too long or too short
Problem: Agent output length doesn’t match needs Solutions: Too long:- Reduce max tokens
- Add length constraint to system prompt (“Keep under 200 words”)
- Lower temperature (more focused)
- Increase max tokens
- Request more detail in system prompt (“Provide comprehensive analysis”)
- Raise temperature slightly (more expansive)
Next Steps
Learn about other node types:- Skills Node - Add capabilities to your agent
- Memory Node - Give your agent persistent knowledge
- Sub-agents Node - Delegate to specialist agents
- Testing Agents - Use chat interface effectively
- Exporting Agents - Deploy to production
Ready to add capabilities to your agent?Add Skills → | Add Memory → | Add Sub-agents →