Use any model. Extend with plugins. Let AI agents build your project.
Website | Live Demo | User Guide | Discord | 中文
Axon is a free, open-source AI coding assistant with a built-in Web IDE, multi-agent task system, and self-evolution capabilities. It gives you full control — choose your AI provider, extend functionality through plugins and MCP servers, and even let the AI modify its own source code.
# Install
npm install -g axon
# Set your API key (Anthropic, OpenRouter, DeepSeek, or any OpenAI-compatible provider)
# No API key? Get one at https://api.chatbi.site (Claude Sonnet & Opus, OpenAI-compatible)
export ANTHROPIC_API_KEY="sk-..."
# Terminal mode
axon
# Web IDE mode (opens at http://localhost:3456)
axon-webOne-click installer (no Node.js required)
Windows: Download install.bat and double-click.
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/install.sh | bashChina mirror:
curl -fsSL https://gitee.com/lubanbbs/claude-code-open/raw/private_web_ui/install.sh | bashDocker
# Web IDE
docker run -it \
-e ANTHROPIC_API_KEY=your-api-key \
-p 3456:3456 \
-v $(pwd):/workspace \
-v ~/.axon:/root/.axon \
wbj66/axon node /app/dist/web-cli.js --host 0.0.0.0
# Terminal only
docker run -it \
-e ANTHROPIC_API_KEY=your-api-key \
-v $(pwd):/workspace \
-v ~/.axon:/root/.axon \
wbj66/axonBuild from source
git clone https://github.com/kill136/claude-code-open.git
cd claude-code-open
npm install && npm run build
node dist/cli.js # Terminal
node dist/web-cli.js # Web IDEUninstall
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/uninstall.sh | bashChina mirror:
curl -fsSL https://gitee.com/lubanbbs/claude-code-open/raw/private_web_ui/uninstall.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/uninstall.ps1 | iexWindows (cmd):
curl -fsSL https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/uninstall.bat -o uninstall.bat && uninstall.batA full browser-based IDE — not just a chat window.
- Monaco Editor with multi-tab, syntax highlighting, and AI-powered hover tips
- File tree with right-click context menus, just like VS Code
- AI-enhanced editing — select code, ask AI, get inline changes
- Real-time streaming via WebSocket
- Session management — create, resume, fork, and export conversations
- Checkpoint & Rewind — snapshot files and time-travel through your session
 |
 |
Give Axon a complex task and it breaks it down across multiple AI agents working in parallel.
- Planner decomposes the task into an execution graph
- Lead Agent coordinates workers and tracks progress
- Workers execute independently with full tool access
- Task Queue with priority scheduling and persistence
- Auto-review validates output before marking complete
Axon can modify its own source code, compile, and hot-reload — adding new tools and capabilities on the fly.
You: "Add a tool that queries weather data"
Axon: *writes the tool code, compiles TypeScript, restarts, tool is ready*
| Category | Tools |
|---|---|
| File ops | Read, Write, Edit, MultiEdit, Glob, Grep |
| Execution | Bash, background tasks, scheduled jobs |
| Web | Fetch pages, search the web |
| Code | Jupyter notebooks, LSP, Tree-sitter parsing |
| Browser | Playwright-based full browser automation |
| Planning | Plan mode, Blueprint, sub-agents |
| Memory | Long-term memory with semantic search, vector store, BM25 |
| Integration | MCP protocol, Skills marketplace, plugins |
| Perception | Camera (Eye), Microphone (Ear), Speech (Mouth) |
- MCP Protocol — connect any Model Context Protocol server
- Skills — community-contributed prompt-based capabilities (PDF, DOCX, XLSX, PPTX, and more)
- Plugins — write custom JavaScript/TypeScript extensions
- Hooks — pre/post tool execution callbacks
- Custom tools — create tools at runtime that persist across sessions
| Provider | Setup |
|---|---|
| Anthropic | ANTHROPIC_API_KEY=sk-ant-... |
| OpenRouter | ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1 |
| AWS Bedrock | CLAUDE_CODE_USE_BEDROCK=1 |
| Google Vertex AI | CLAUDE_CODE_USE_VERTEX=1 |
| Any OpenAI-compatible | Set ANTHROPIC_BASE_URL to your endpoint |
Share your API key or Claude subscription with other devices on your network.
# On the host (has the API key)
axon-proxy -k my-secret
# On client machines
export ANTHROPIC_API_KEY="my-secret"
export ANTHROPIC_BASE_URL="http://<host-ip>:8082"
axonProxy options
| Flag | Default | Description |
|---|---|---|
-k, --proxy-key |
auto-generated | Key clients use to authenticate |
-p, --port |
8082 |
Port to listen on |
-H, --host |
0.0.0.0 |
Bind address |
--anthropic-key |
auto-detect | Override Anthropic API key |
--auth-token |
auto-detect | Override OAuth access token |
--target |
https://api.anthropic.com |
Upstream API URL |
The proxy auto-detects credentials: ANTHROPIC_API_KEY env var > ~/.axon/.credentials.json (OAuth).
| Variable | Description | Default |
|---|---|---|
ANTHROPIC_API_KEY |
API key (required) | - |
ANTHROPIC_BASE_URL |
Custom API endpoint | https://api.anthropic.com |
AXON_LANG |
Language (en/zh) |
auto-detect |
AXON_CONFIG_DIR |
Config/data directory | ~/.axon |
Add external tool servers in .axon/settings.json:
{
"mcpServers": {
"filesystem": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
}
}
}axon # Interactive mode
axon "Analyze this project" # With initial prompt
axon -p "Explain this code" # Print mode (non-interactive)
axon -m opus "Complex task" # Specify model
axon --resume # Resume last session
axon-web # Web IDE
axon-web -p 8080 -H 0.0.0.0 # Custom port and host
axon-web --ngrok # Public tunnel
axon-web --evolve # Self-evolution mode- Website: chatbi.site
- Live Demo: voicegpt.site
- Discord: Join us
- X (Twitter): @wangbingjie1989
PRs and issues are welcome! See CONTRIBUTING.md for guidelines.
The fastest way to extend Axon is to write a Skill (a prompt file with structured instructions) or a Plugin (a JS/TS module with lifecycle hooks). Both are auto-loaded from ~/.axon/skills/ and ~/.axon/plugins/.
Axon is free and open-source. Sponsorships keep development going. See sponsor tiers →
- Jack Darcy — jack@jackdarcy.com.au
Your name/logo here — become a sponsor
Axon is dual-licensed:
- Open Source — AGPL-3.0. Free for personal use, academic research, and open-source projects. If you modify Axon or use it to provide a network service, you must release your complete source code under AGPL-3.0.
- Commercial — For proprietary/closed-source usage, SaaS deployment, or any scenario where AGPL compliance is not feasible, a commercial license is required. See COMMERCIAL-LICENSE.md for details, or contact kill.136@163.com.