🔧 free-claude-code → opencode go API Setup

Route Claude Code (CLI + Desktop) through free-claude-code proxy using opencode go API (/zen/go/v1) and deepseek-v4-flash model — no Anthropic credits needed.

Features

Feature	Description
Zero-cost coding	Uses free-tier opencode go API instead of paid Anthropic API
CLI + Desktop	Both claude CLI and Claude Code Desktop app work transparently
Model routing	All Claude model requests map to deepseek-v4-flash
Model discovery	Desktop app auto-discovers available models from proxy
No auth friction	Proxy auth disabled for Desktop compatibility

Architecture

┌─────────────────┐     ┌──────────────────────┐     ┌─────────────────┐
│  Claude Code    │────▶│  free-claude-code    │────▶│  opencode go    │
│  (CLI/Desktop)  │     │  (localhost:15721)   │     │  /zen/go/v1     │
└─────────────────┘     └──────────────────────┘     └────────┬────────┘
                      ┌──────────────────────┐               │
                      │  Patches applied:    │               ▼
                      │  • +claude-*-4-5     │     ┌─────────────────┐
                      │  • /claude-desktop   │     │ deepseek-v4-    │
                      │  • auth disabled     │     │ flash           │
                      └──────────────────────┘     └─────────────────┘

Quick Start

# 1. Install free-claude-code
uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
fcc-init

# 2. Apply patches (see SKILL.md for details)
#    - Add claude-*-4-5 models to routes.py
#    - Mount /claude-desktop prefix in app.py
#    - Disable auth in dependencies.py

# 3. Configure .env
#    Set OPENCODE_API_KEY, MODEL=opencode/deepseek-v4-flash

# 4. Configure ~/.claude/settings.json
#    Add env block with ANTHROPIC_BASE_URL + model discovery

# 5. Start
fcc-server

See SKILL.md for the complete step-by-step instructions.

Repo Structure

free-claude-code-opencode-setup/
├── SKILL.md          # Complete setup instructions (Hermes skill format)
├── README.md         # This file
├── README.zh-TW.md   # Traditional Chinese
├── LICENSE           # MIT
└── .gitignore

Prerequisites

• macOS (tested on Apple Silicon)
• uv package manager
• opencode.ai account with API key
• Claude Code (CLI or Desktop) installed

Related

• free-claude-code — The proxy that makes this possible
• openclaw — Alternative gateway for Claude Code
• Hermes Agent — The agent orchestration framework this skill runs on

License

MIT