Back to guides

Amp CLI Setup Guide [KorProxy]

Configure Amp CLI and Amp VS Code extension to use your own AI subscriptions through KorProxy

Overview

Amp CLI is a powerful AI coding assistant from Sourcegraph that helps you write, understand, and modify code directly from your terminal or IDE.

KorProxy integrates with Amp by acting as a proxy that routes provider requests through your OAuth-authenticated subscriptions (Google, ChatGPT Plus/Pro, Claude Pro/Max) while forwarding management requests to Amp's control plane.

This setup works with both Amp CLI and Amp IDE extensions (VS Code, Cursor, Windsurf, etc.).

Prerequisites

  • KorProxy app installed and running
  • Amp CLI installed (brew install amp or via npm)
  • An Amp account (free tier available at ampcode.com)
  • At least one provider authenticated in KorProxy (Gemini, Claude, or Codex)

Configuration Steps

Option A: Settings File (Recommended)

Edit ~/.config/amp/settings.json:

{
  "amp.url": "http://localhost:1337"
}

Option B: Environment Variable

Add to your shell profile (.bashrc, .zshrc, etc.):

export AMP_URL=http://localhost:1337

Login Through Proxy

After configuring the proxy URL, authenticate with your Amp account:

amp login

This authenticates with Amp's servers through KorProxy. Management requests (login, threads, user data) are proxied to ampcode.com while provider requests use your OAuth subscriptions.

Usage

Start using Amp with your proxied AI providers:

amp "Write a hello world in Python"

How It Works

Provider authenticated: Requests use your OAuth subscription (ChatGPT Plus/Pro, Claude Pro/Max, Google account) - no Amp credits consumed

Provider NOT authenticated: Requests automatically forward to ampcode.com and use your Amp credits

Recommendation: Authenticate all providers you have subscriptions for to maximize value and minimize Amp credit usage

Which Providers to Authenticate

Amp uses different models for various agent modes and subagents. Authenticate the providers you have subscriptions for:

Smart Mode

Anthropic/Claude (Claude Opus 4.5)

Rush Mode

Anthropic/Claude (Claude Haiku 4.5)

Oracle Subagent

OpenAI/GPT (GPT-5.1 medium reasoning)

Librarian Subagent

Anthropic/Claude (Claude Sonnet 4.5)

Search Subagent

Anthropic/Claude (Claude Haiku 4.5)

Review Feature

Google/Gemini (Gemini 2.5 Flash-Lite)

See current Amp models

Amp IDE Extension

The proxy also works with Amp IDE extensions for VS Code, Cursor, Windsurf, and other editors:

  1. Open Amp extension settings in your IDE
  2. Set Amp URL to http://localhost:1337
  3. Login with your Amp account
  4. Start using Amp in your IDE

Both CLI and IDE can use the proxy simultaneously.

Troubleshooting

"401 Unauthorized" or "403 Forbidden"

Re-authenticate the provider in KorProxy for the model being used

"Connection refused"

Make sure KorProxy is running on port 1337

Models not using proxy

Verify the Amp URL setting or AMP_URL environment variable is set correctly

Verify configuration

# Check Amp URL setting
amp config get amp.url

# Or check environment variable
echo $AMP_URL

Note: This is Different from BYOK

While Amp removed their "Isolated Mode" (BYOK) feature in May 2025, KorProxy works differently. It acts as a proxy server that routes Amp's provider requests through your OAuth-authenticated subscriptions, while still using Amp's control plane for account management and threads. You still need an Amp account, but provider calls use your own subscriptions.