claude-code-env: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Claude Code Environment Switcher (CCE) is a lightweight Go CLI tool that manages multiple Claude Code API endpoint configurations, allowing seamless switching between different environments (production, staging, custom API providers, etc.). The tool acts as a wrapper around Claude Code, injecting appropriate environment variables before launching.

Commands

Build and Test

# Build binary
make build              # or: go build -o cce .

# Run all tests
make test               # or: go test -v ./...

# Run specific test
go test -v -run TestValidateName ./...      # Run single test by name
go test -v -run "TestSecurity" ./...        # Run all security tests
go test -v -run "TestFlagPassthrough" ./...  # Run flag passthrough tests

# Test coverage
make test-coverage      # Generate HTML coverage report
go test -coverprofile=coverage.out ./...    # Generate coverage profile

# Performance benchmarks
make bench              # or: go test -bench=. -benchmem ./...

# Code quality
make quality            # Runs fmt + vet + test
make fmt                # Format all Go files
make vet                # Run static analysis

# Security tests
make test-security      # or: go test -v -run TestSecurity ./...

# Clean build artifacts
make clean              # Remove cce binary and coverage files

Installation

# Install to system PATH
make install            # Builds and moves to /usr/local/bin/

# Development build
go build -o cce .       # Build binary in current directory

Architecture

The project uses a minimalist 4-file architecture following KISS principles:

Core Components

main.go (580+ lines)

• CLI entry point and command routing
• Two-phase argument parser for flag passthrough system
• Model validation with configurable patterns
• Environment validation (name, URL, API key)
• Help text generation with flag passthrough examples