Installation Guide

This guide covers all ways to install go-code on Linux, macOS, and Windows.

Prerequisites

• Go 1.23+ — Only needed for building from source or go install
• An API key — Anthropic, OpenAI, or any compatible provider
• Python 3.x (optional) — Only for the test harness

One-Command Install

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/strings77wzq/claude-code-Go/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/strings77wzq/claude-code-Go/main/install.ps1 | iex

Via go install

go install github.com/strings77wzq/claude-code-Go/cmd/go-code@latest

This installs the binary to $GOPATH/bin (typically ~/go/bin). Ensure this directory is in your PATH.

Build from Source

git clone https://github.com/strings77wzq/claude-code-Go.git
cd claude-code-Go
make build
./bin/go-code

Or build manually:

go build -o bin/go-code ./cmd/go-code

Pre-built Binaries

Download from GitHub Releases:

Platform	Architecture	Binary
Linux	amd64	go-code-linux-amd64
macOS	amd64	go-code-darwin-amd64
macOS	arm64 (M1/M2)	go-code-darwin-arm64
Windows	amd64	go-code-windows-amd64.exe

Linux / macOS

curl -fsSL https://github.com/strings77wzq/claude-code-Go/releases/latest/download/go-code-linux-amd64 -o go-code
chmod +x go-code
sudo mv go-code /usr/local/bin/

Windows

Download go-code-windows-amd64.exe from Releases, rename to go-code.exe, and add to your PATH.

Verify Installation

go-code --help

Supported Platforms

OS	Architecture	Build from Source	Pre-built Binary
Linux	amd64	✅	✅
macOS	amd64	✅	✅
macOS	arm64	✅	✅
Windows	amd64	✅	✅

Next Steps

• Quick Start Guide — Run your first command
• Configuration Guide — Set up API keys and preferences
• Installation Guide for AI Agents — Step-by-step instructions for LLM agents