What is AgentX CLAUDE.md?

Chinese project instructions for the AgentX platform. AgentX uses Domain-Driven Design, an approach that separates business rules from application coordination, technical infrastructure, and interfaces.

Use them when developing AgentX's Java Spring Boot backend or Next.js TypeScript frontend, navigating its layers, and following its build and development commands.

They explain the project's architecture, technologies, language requirements, logging conventions, and backend location. This helps coding work match the repository's expected structure and practices.

How lucky-aeon/AgentX configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to lucky-aeon/AgentX. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/lucky-aeon/AgentX/master/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/lucky-aeon/AgentX

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/lucky-aeon/agentx/claude-md/github.svg)](https://agentmods.dev/instructions/lucky-aeon/agentx/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/lucky-aeon/agentx/claude-md"><img src="https://agentmods.dev/badge/instructions/lucky-aeon/agentx/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/lucky-aeon/agentx/claude-md"><img src="https://agentmods.dev/badge/instructions/lucky-aeon/agentx/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 8,543 This file is loaded in full into every session.

When invoked 8,543 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.08543	$0.08543
Opus 5.5	$0.03417	$0.03417
Sonnet 5.5	$0.01709	$0.01709
Haiku 4.5	$0.00854	$0.00854

Measured 2mo ago against content hash cf550aab54c3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

AgentX CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 1,132 lines

How it starts

The opening of the file, as written. The whole thing — 1,132 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

必须使用中文回复我 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. 日志使用中文

Project Architecture

AgentX is an intelligent agent platform built with Domain-Driven Design (DDD) architecture, featuring:

Backend (Java/Spring Boot):

Domain Layer: Core business logic with entities, repositories, and domain services
Application Layer: Business process orchestration and use cases
Infrastructure Layer: Technical implementations (persistence, configs, utilities)
Interface Layer: API controllers and external interfaces

Frontend (Next.js/TypeScript):

Pages: Route-based page components using Next.js App Router
Components: Reusable UI components with Tailwind CSS and Shadcn/ui
Lib: API services, HTTP client, and utility functions
Types: TypeScript type definitions
Contexts: React Context for state management

Key Technologies:

Backend: Spring Boot 3.2.3, MyBatis-Plus, PostgreSQL, JWT
Frontend: Next.js 15, React 19, TypeScript, Tailwind CSS
Infrastructure: Docker, Maven, Gradle

Development Commands

Backend (Java/Spring Boot)

# Navigate to backend directory
cd AgentX

# 使用 mvn的方式运行 maven 命令
./mvn spring-boot:run

# Build backend
./mvn clean compile

# Run tests
./mvn test

# Code formatting (uses Spotless plugin)
./mvn spotless:apply

Frontend (Next.js)

# Navigate to frontend directory  
cd agentx-frontend-plus

# Install dependencies
npm install --legacy-peer-deps

# Run development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

Docker Development (Recommended)

# Start all services in development mode (with hot reload)
./bin/start-dev.sh     # Linux/macOS
bin\start-dev.bat      # Windows

# Start production mode
./bin/start.sh         # Linux/macOS  
bin\start.bat          # Windows

# Stop services
./bin/stop.sh          # Linux/macOS
bin\stop.bat           # Windows

# View service status
docker compose -f docker-compose.dev.yml ps

# View logs
docker compose -f docker-compose.dev.yml logs -f [service-name]

Read the full file on GitHub · 1,132 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 1,132 lines · 8,543 tokens per session scan A cf550aab54c3

Subscribe to this mod's changes

AgentX CLAUDE.md is an instructions file published in the GitHub repository lucky-aeon/AgentX (850 stars, last pushed 4mo ago), licensed Apache-2.0. It adds 8,543 tokens to every session, about $0.0342 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

AgentX CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
AgentX CLAUDE.mdlucky-aeon/AgentX	Instructions file	850	4mo ago	Apache-2.0	A	8,543	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

AgentX: Instructions file for Claude Code