Search Documentation

Find and navigate to documentation pages and their content

Account & Subscription Setup

Create your account, subscribe, and start using Codistry.

Before You Start

This guide covers creating your Codistry account and managing your subscription.

Already have an account? See the Quick Start Guide for AI provider setup and your first conversation.

Step 1: Setting up your Account

  1. Open Codistry Settings

    Select the gear icon from the Codistry panel to navigate to the Codistry settings.

  2. Log in with Codistry

    Select the “Account” option, and click “Log in with Codistry”.

  3. Create Your Account

    Click “Create a new Account” and sign up with an email and new password, or use Sign in with Google or Sign in with GitHub for one-click OAuth.

    Important

    Use a valid email address for account verification and important updates.

  4. Secure Your Account (Recommended)

    Enable two-factor authentication (2FA) from your account security settings. Codistry supports both an authenticator app (TOTP) and 6-digit email verification codes.

Step 2: Your Plan

Free to start

When you create an account, you are on the Free plan. No credit card is required.

The Free plan lets you use Codistry with your own models — local or cloud, with your own API keys (OpenAI, Anthropic, or custom models). With local models it is fully offline capable.

Two more plans are available from the Plans page in your dashboard:

  • Developer ($10/month): adds a Codistry API key for Codistry-hosted models, with $10 of usage credits included every month. Included credits are used first and expire at the end of each billing month; the next month brings a fresh $10. Credit top-ups are available, and auto top-up is on by default: $10 of credits is added automatically when your balance drops below $5 (adjust it or turn it off on the Billing page).
  • Teams / Enterprise: on-prem or air-gapped deployment, SSO/SAML, SCIM, and audit export. Contact sales from the Plans page.

  1. Access Your Dashboard

    After account creation, the dashboard opens automatically. Your Free plan is already active.

  2. Authenticate Your VS Code Extension

    The easiest path is from the editor: click “Sign In” in the Codistry panel. Your browser opens a connect page (after signing in to your Codistry account if needed) with a single “Connect VS Code” button — click it to approve. Alternatively, click “Connect extension” on the dashboard Overview page.

    When your browser prompts you to confirm opening VS Code, click “Open” to complete authentication.

    Success!

    A “Licensed” badge appears in Codistry settings. You're ready to configure your AI provider.

Codistry-Hosted Models & Usage Credits

Bringing your own API keys is free. Codistry-hosted models instead run through the Codistry managed proxy: no provider keys to manage, with usage billed per token from your usage credits. Hosted models come with the Developer plan, which includes $10 of credits every month.

Included monthly credits

The Developer plan includes $10 of credits each month. They are consumed before purchased top-ups and expire at the end of the billing month; a fresh $10 arrives with the next cycle.

Add credits

On the Developer plan, pre-load your balance from the Billing page in your dashboard. Payment runs through Stripe Checkout, and the credits appear on your balance right after payment.

Pay per token

Hosted-model usage is metered per token and drawn from your balance. If your credits run out, hosted-model requests pause until you add more. Your own API keys keep working either way. The Usage page in your dashboard shows daily token usage, a per-model breakdown for the current billing cycle, and your credit history.

Auto top-up

On by default when you subscribe to the Developer plan: $10 of credits is added automatically when your balance drops below $5, charged to your saved card. Adjust the amounts, set a monthly spending cap, or turn it off on the Billing page alongside your saved cards.

What hosted models look like in the extension

The Codistry hosted card in Settings → Models lists ready-to-use models: no API keys, usage billed from your credit balance. See Models: Codistry hosted.

The Account tab shows a status-only Usage credits card (credits available or exhausted, auto top-up on or off). Credits and auto top-up are managed from your dashboard's Billing page, not the extension.

Step 3: Configure Your AI Model

Codistry can be configured to work with common cloud-based models, or a custom model, including one running on your local machine!

Using hosted models? You may be done already

With credits on your balance you can skip this step: pick a model from the Codistry hosted card in Settings → Models and start chatting. The options below are for your own keys or a local model.

Option A: Using a Cloud Model

To use Codistry with OpenAI or Anthropic cloud models:

  1. Click the Settings (gear) icon in the Codistry panel
  2. Navigate to the Models section
  3. Configure your preferred provider(s):

For Anthropic Claude:

  • Enable the Anthropic toggle
  • Paste your API Key from console.anthropic.com
  • Custom API URL (Optional): Leave empty for standard use, or specify a custom endpoint
  • Check Enable Streaming for real-time responses (recommended)

For OpenAI:

  • Enable the OpenAI toggle
  • Paste your API Key from platform.openai.com
  • Custom API URL (Optional): Leave empty for standard use, or specify a custom endpoint
  • Check Enable Streaming for real-time responses (recommended)

Then Select Your Model:

  • Go to the General section
  • Choose Model Provider: Anthropic or OpenAI
  • Choose Model: Select from available models

Option B: Using a Custom Model

Custom models are perfect for local LLMs (Ollama, LM Studio) or corporate endpoints.

  1. In Settings → Models, enable the Custom Models toggle
  2. Click the + Add Model button
  3. Configure your model:

Required Fields:

  • Display Name: Friendly name (e.g., “Local-Gpt-Oss”)
  • URL: Your endpoint (e.g., http://localhost:1234/v1)
  • Max Tokens: Model's context window (e.g., 32000)

Capabilities (checkboxes):

  • Reasoning: Extended thinking capability
  • Tools: Function calling support (required for Codistry)
  • Images: Vision/image understanding
  • Temp: Temperature control
  • Stream: Streaming responses

After adding, your custom model appears in the General → Model dropdown with its capabilities displayed (e.g., “32000 tokens • Reasoning ✓ • Tools ✓”).

Important

Tools support is required. Codistry needs function calling to work properly. Make sure your model supports tools and the checkbox is enabled.

Test Your Setup

Send a question about your code to the agent to ensure everything is configured correctly.

Configuration complete. Codistry is ready for AI-powered coding assistance.

Troubleshooting

Common Issues

Extension not connecting after login

You do not need a paid subscription to connect. The Free plan is active from the moment you create an account. Connecting requires a verified account and an issued license, so confirm your email is verified, your extension is authenticated (a “Licensed” badge appears in settings), and retry. Check that browser popups are not blocked.

Model not responding

Verify your API keys are correct and that you have sufficient credits/quota with your AI provider. Check your internet connection.

Settings not taking effect

Click “Save” after making changes to settings. Restart VS Code if settings don't take effect.

Need more help?

Reach out to the Adronite team for help with troubleshooting configuration issues.

Previous← Quick StartNextModels →