Ø THE AI SERVER ← Back to Insights
Developer Workflow · Open Source AI

How to Build a 100% Free, Offline AI Coding Agent in VS Code (2026)

A
Written by Akshat
Founder, The AI Server · In collaboration with Codacus AI Labs
Offline AI coding agent running locally inside VS Code

⚡ The Problem: Why Developers Are Ditching 0/Month Cloud IDEs

Tools like Cursor, Windsurf, and Claude Code have transformed programming, but they come with severe caveats: recurring monthly subscriptions, strict token rate limits, and constant transmission of proprietary enterprise source code to third-party cloud servers. Today, you can build a 100% free, completely offline autonomous AI coding agent directly inside regular VS Code using Ollama, Cline, and Qwen 2.5 Coder that runs entirely on your local GPU.

The Architecture: The Offline Power Stack

To recreate an experience matching commercial AI editors without spending a cent, we orchestrate three open-source components:

Step 1: Install and Configure Ollama for Extended Context

By default, Ollama initializes models with a constrained 2,048 or 4,096 token context window. For an autonomous coding agent that inspects multiple source files simultaneously, this is insufficient. We must configure a custom 64k context Modelfile.

First, pull your preferred model based on your available hardware VRAM:

bash — terminal command
# For 8GB - 12GB VRAM (RTX 3060 / 4060 / Apple M2 16GB)
ollama pull qwen2.5-coder:7b

# For 12GB - 16GB VRAM (RTX 3060 12GB / 4070 / Apple M3 18GB)
ollama pull qwen2.5-coder:14b

# For 24GB+ VRAM (RTX 3090 / 4090 / Mac Studio 32GB+)
ollama pull qwen2.5-coder:32b

Now, create a custom Modelfile named Modelfile-coder to expand the context window to 65,536 tokens and set optimal system prompts:

Modelfile — custom model definition
# Modelfile-coder
FROM qwen2.5-coder:14b

# Expand context window to 64k tokens
PARAMETER num_ctx 65536
PARAMETER temperature 0.2
PARAMETER top_p 0.95

SYSTEM """
You are an expert autonomous software engineer working inside VS Code.
When solving tasks:
1. First inspect relevant files and directory structure.
2. Formulate a minimal, elegant implementation plan.
3. Write clean, production-grade code with error handling.
4. Execute tests and verify all changes before completion.
"""

Build your extended context model inside Ollama:

Modelfile — custom model definition
ollama create qwen-coder-64k -f ./Modelfile-coder

Step 2: Install Cline in VS Code

Open VS Code, press Ctrl+Shift+X (or Cmd+Shift+X on Mac), search for Cline (by cline.bot), and click Install.

Cline appears as a dedicated robot icon in your VS Code primary sidebar. Click the icon, then click the Settings (Gear Icon) at the top right of the Cline panel.

Step 3: Point Cline to Your Local Ollama Engine

In the Cline configuration panel, configure the following settings:

Click Done. Cline will now establish an active handshake with your local GPU!

Empirical VRAM & Hardware Requirements

Here is what performance looks like across standard consumer GPUs:

GPU / Hardware VRAM Recommended Model Context Buffer Speed (Tokens/s)
Apple M-Series (16GB RAM) Unified 16GB Qwen 2.5 Coder 7B Q8 32,768 tokens 38 t/s
Nvidia RTX 3060 / 4060 12GB VRAM Qwen 2.5 Coder 14B Q4_K_M 32,768 tokens 26 t/s
Nvidia RTX 4070 Ti / 4080 16GB VRAM Qwen 2.5 Coder 14B Q8_0 65,536 tokens 42 t/s
Nvidia RTX 3090 / 4090 24GB VRAM Qwen 2.5 Coder 32B Q4_K_M 65,536 tokens 35 t/s

3 Secret Optimizations for Maximum Local Coding Speed

  1. Set Infinite Keepalive: By default, Ollama unloads models from VRAM after 5 minutes of inactivity. Set export OLLAMA_KEEP_ALIVE=24h in your ~/.bashrc or Windows environment variables so your coding assistant is always hot and responds instantaneously.
  2. Enable Flash Attention: Add export OLLAMA_FLASH_ATTENTION=1 to reduce KV cache memory consumption by up to 50% during long coding sessions.
  3. Combine with Distributed RPC for Heavy Repos: If your project is massive and requires a 32B model, check out our guide on splitting models across Mac & PC via llama.cpp RPC to combine multiple machines into one unified VRAM pool.

Looking for Custom Local AI Development Workstations?

The AI Server helps enterprise engineering teams set up air-gapped coding clusters, private inference servers, and custom autonomous developer pipelines.

Schedule an Engineering Consultation →

Related Local AI Tutorials

Deepen your local artificial intelligence mastery with our empirical guides: