IDE Integration

Overview

AIone supports two integration methods:

• OpenAI-compatible format: For Cursor, Cline, Continue, and most IDEs or plugins that support a custom OpenAI Base URL
• Anthropic native format: For Claude Code, the Anthropic SDK, and tools that call the Messages API directly

This guide covers how to configure AIone in popular IDEs and coding tools.

Cursor

Cursor is one of the most popular AI code editors.

Setup

1. Open Cursor > Settings > Models
2. Find the OpenAI API Key configuration
3. Enter the following:
   • API Key: sk-nex-your-key-here
   • Base URL: https://api.portal.aiin1.ai/v1
4. All models must use short names (see table below) — do not use model names starting with gpt-, claude-, or gemini-
5. Add short model names manually via Add Models at the bottom of the model list

Cursor Model Short Name Reference

Cursor automatically intercepts model names starting with gpt-, claude-, or gemini- and routes them through Cursor's own channels, bypassing your configured API address. You must use the following short names in Cursor:

GPT Models

Claude Models

Gemini Models

Notes

• You may need to set the Override OpenAI Base URL option in Cursor
• You must turn OFF the "Anthropic API Key" and "Google API Key" toggles in Cursor. When enabled, Cursor sends corresponding model requests directly to the official APIs, bypassing AIone, which causes key validation failures (401 errors). All models should be configured through the OpenAI API Key field above
• Do not use Cursor's built-in model entries — add the short names from the table above via Add Models
• GPT models do not support Thinking mode in Cursor Agent mode. For Agent + Thinking, use opus-4-6 or sonnet-4-6 instead
• If the model list does not include the desired entry, simply type the short model name manually

Cline (VS Code Extension)

Cline is a powerful AI coding assistant for VS Code.

Installation

1. Open VS Code > Extensions (Ctrl+Shift+X / Cmd+Shift+X)
2. Search for Cline and install
3. After installation, the Cline icon appears in the sidebar

Configuration

1. Click the Cline icon > Settings (gear icon)
2. Set API Provider to OpenAI Compatible
3. Enter:
   • Base URL: https://api.portal.aiin1.ai/v1
   • API Key: sk-nex-your-key-here
   • Model ID: claude-sonnet-4-6 (or any other standard model ID)

Claude Code

Claude Code is Anthropic's official CLI tool.

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.portal.aiin1.ai"
export ANTHROPIC_AUTH_TOKEN="sk-nex-your-key-here"

To make these persistent, add them to your shell configuration file.

The variable name is ANTHROPIC_AUTH_TOKEN, NOT ANTHROPIC_API_KEY. ANTHROPIC_API_KEY is used by the Anthropic Python/TypeScript SDK. Claude Code CLI uses ANTHROPIC_AUTH_TOKEN. Using the wrong variable name will result in a 401 Invalid API key error.

Windows (Recommended: Permanent Configuration)

We recommend using Windows User Environment Variables for a one-time setup that persists across sessions.

1. Open the Start menu and search for Environment Variables
2. Select Edit environment variables for your account
3. Under "User variables," click New
4. Add the following two variables:
   • ANTHROPIC_BASE_URL = https://api.portal.aiin1.ai
   • ANTHROPIC_AUTH_TOKEN = sk-nex-your-key-here
5. Save, then close and reopen any CMD, PowerShell, or VS Code terminal windows

Verify the configuration in a new terminal window:

echo %ANTHROPIC_BASE_URL%

If you use PowerShell:

$env:ANTHROPIC_BASE_URL

If it displays https://api.portal.aiin1.ai, the configuration is successful.

Disable Experimental Betas (Important)

Claude Code sends experimental anthropic-beta headers by default. Some of these beta features are incompatible with the AWS Bedrock upstream and may trigger ValidationException errors (a known Claude issue — see the Claude Code LLM Gateway docs).

We recommend all users set this additional environment variable:

macOS / Linux:

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Windows: add another user environment variable the same way as above:

• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = 1

Close and reopen your terminal after setting it.

Launch Claude Code

claude

If Claude Code detects a custom API Key for the first time, follow the prompt to use the key from your environment variables.

You can also configure this in ~/.claude/config.json, but the environment variable approach is more straightforward, especially for Windows users.

Important Notes

Claude Code uses the Anthropic Messages API format (not OpenAI format), so the Base URL should be https://api.portal.aiin1.ai -- do not append /v1 manually.

Claude Code / the Anthropic SDK will automatically request /v1/messages as required by the protocol, so you only need to provide the root URL.

• The variable name must be ANTHROPIC_AUTH_TOKEN — using ANTHROPIC_API_KEY will cause a 401 error
• If you changed environment variables but Claude Code still reads old values, you likely need to reopen the terminal window
• To switch back to the official API, delete both environment variables, reopen the terminal, and run claude login

Continue (VS Code Extension)

1. Install the Continue extension
2. Open the configuration file ~/.continue/config.json
3. Add AIone as a provider:

{
  "models": [
    {
      "title": "AIone Claude Sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "apiBase": "https://api.portal.aiin1.ai/v1",
      "apiKey": "sk-nex-your-key-here"
    }
  ]
}

General Configuration Principles

First determine which protocol your client uses:

All scenarios use the AIone API Key (prefixed with sk-nex-).

How to Determine the Correct Model Name

If you just need to know "what model name should I enter in this client," remember these 3 rules:

• For the authoritative real-time list, check GET https://api.portal.aiin1.ai/v1/models and the Model List
• Only Claude models in Cursor should use short model names
• All other clients should use the standard model ID

For the complete rules, full model table, and Cursor Claude short name mapping, see:

• Model Naming & Compatibility Rules

FAQ

Claude Code Returns 401 Invalid API key

The most common cause is using the wrong environment variable name:

If you used ANTHROPIC_API_KEY, Claude Code won't read it. Change it to ANTHROPIC_AUTH_TOKEN.

Connection Failure / Timeout

• For OpenAI-compatible clients, verify the Base URL is https://api.portal.aiin1.ai/v1
• For Claude Code / Anthropic SDK, verify the Base URL is https://api.portal.aiin1.ai
• Confirm your API Key is valid
• Check whether your network can reach api.portal.aiin1.ai

Model Not Found

• Verify the model ID spelling
• Confirm the model name on the Model List page
• For Claude in Cursor, use short model names like opus-4-6, sonnet-4-6, haiku-4-5
• For all other clients, and for GPT / Gemini, use standard model IDs like claude-sonnet-4-6, gpt-5.4, gpt-5.2, gemini-3.1-pro
• For the full model name reference, see: Model Naming & Compatibility Rules

Unexpected Response Format

• Ensure the Provider type is set to OpenAI Compatible (not Anthropic native format)
• Exception: Claude Code uses the Anthropic format, which AIone also supports