claude-code-GoModel provides intelligence, harness provides reliability.
A production-grade AI coding assistant with full agent loop, tool execution, and permission management — built in pure Go.
Skip to content
82
Source Files
8
Modules
10
Built-in Tools
14,000+
Lines of Code
main.go
Single Binary Deployment
Zero dependencies. One file runs everywhere — Linux, macOS, Windows. No runtime, no virtualenv, no node_modules.
Harness-First Reliability
Permission control, timeout protection, session persistence. The harness ensures safety so the model can focus on intelligence.
Extensible Ecosystem
MCP protocol, Hooks, and Skills — extend with custom tools and integrate with your workflow.
Model Provides Intelligence
The LLM handles: understanding intent, deciding which tool to use, interpreting results, and planning next steps. It's the brain of the system.
Harness Provides Reliability
The runtime handles: permission control, timeout protection, output truncation, session persistence, and error recovery. It's the safety net that makes the system production-ready.
claude-code-Go
Feature Highlights
| Feature | Description |
|---|---|
| 🔄 Agent Loop | Autonomous "think → act → observe" cycle driven by stop_reason dispatch |
| 🛠️ 10 Built-in Tools | Read, Write, Edit, Glob, Grep, Bash, Diff, Tree, WebFetch, TodoWrite |
| 🔒 Permission System | Three-tier model with rule-based matching and session memory |
| 🔌 MCP Integration | Model Context Protocol with stdio transport and JSON-RPC |
| 🌊 SSE Streaming | Real-time token-by-token with custom parser, zero dependencies |
| 🧠 Context Management | Intelligent token estimation and automatic conversation compaction |
Interactive Playground
main.go
1234567891011
Output
Click "Run" to see the output
🚀 5 Minutes to Get Started
Three simple steps to start coding with AI assistance
1
Install
One command installation with
go install. No dependencies needed.2
Configure
Set your API key. Support for Anthropic, OpenAI, and compatible providers.
3
Start Coding
Launch go-code and start building. The agent handles the rest.
Choose Your Role
Full-stack Developer
Build real applications with hands-on guides. From REPL to production, learn by doing.
Quick start guide →
Architect
Deep dive into the agent loop, tool registry, and permission system. Design extensible systems.
Architecture deep dive →
Student
Learn the core principles: how AI agents reason, plan, and execute tools safely.
Learn the principles →
💬 What Users Say
Trusted by developers worldwide
claude-code-Go has completely transformed our workflow. The single binary deployment makes it incredibly easy to distribute across our team. The permission system gives us confidence when running automated tasks.
Why Go?
| Feature | Go | Python | Rust | TypeScript |
|---|---|---|---|---|
| Single binary | ✅ | ❌ | ✅ | ❌ |
| Zero runtime deps | ✅ | ❌ | ✅ | ❌ |
| Concurrency | ✅ Goroutines | ❌ asyncio | ✅ async/await | ✅ event loop |
| Deployment | go install | pip install | cargo build | npm install |
| Learning curve | Moderate | Easy | Steep | Moderate |
Go gives you the best of both worlds: single-binary deployment like Rust, with development speed closer to Python.
Quick Start
bash
go install github.com/strings77wzq/claude-code-Go/cmd/go-code@latestbash
git clone https://github.com/strings77wzq/claude-code-Go.git
cd claude-code-Go
go build -o bin/go-code ./cmd/go-codebash
curl -fsSL https://github.com/strings77wzq/claude-code-Go/releases/latest/download/go-code-linux-amd64 -o go-code
chmod +x go-codeThen set your API key and start:
bash
export ANTHROPIC_API_KEY=sk-ant-...
./go-code