> For the complete documentation index, see [llms.txt](https://docs.nexos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexos.ai/gateway-api/integrations/proxyai.md).

# ProxyAI Integration

Learn how to connect nexos.ai to IntelliJ using the ProxyAI plugin, including installation, provider configuration, and chat and code completion setup.

This guide details how to integrate **ProxyAI** with JetBrains IDEs (IntelliJ, PyCharm, WebStorm) to enable AI-powered chat and code completions using nexos.ai models.

## What is ProxyAI?

ProxyAI is an AI-powered coding assistant that integrates with JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm, and others).

It supports OpenAI API–compatible provider configuration, allowing you to connect to any OpenAI-compatible endpoint by supplying a custom base URL and API key.

## Prerequisites

* You can use any OpenAI compatible model or assistant.
  * To check what models are available for you, call [Gateway API Models](https://docs.nexos.ai/gateway-api/models) You can use either `nexos_model_id`or `id` as model.
  * To check what AI agents are available for you, call [Agent Management](https://docs.nexos.ai/gateway-api/agent-management).
* As an API URL you should use this URL: **<https://api.us.nexos.ai/v1/chat/completions>**

## Install ProxyAI plugin

1. Open Intellij IDE, go to `Settings` -> `Plugins`
2. From top bar choose `Marketplace`
3. Type `ProxyAI` in search bar
4. Click `Install` next to the ProxyAI plugin name and wait till installation ends

   <figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FMdAYZbXo19pIAKYRjgTM%2FScreenshot%202025-11-30%20at%2023.31.05.png?alt=media&amp;token=d5797e73-73e3-4861-b551-52b34b9cd38c" alt="JetBrains IDE Marketplace settings showing ProxyAI plugin search result with Install button."><figcaption></figcaption></figure>
5. Restart IDE

## Configure ProxyAI plugin

1. Open Intellij IDE Settings
2. Go to `Tools` -> `ProxyAI`

   <figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2F4WXzy85XRvtkiWSnBRAE%2FScreenshot%202025-11-30%20at%2023.35.28.png?alt=media&amp;token=27dffa48-d16c-4f92-a98b-3f4f5322719d" alt="ProxyAI settings page under Tools with Display name field set to &#x22;sredni&#x22;."><figcaption></figcaption></figure>
3. Add Nexos provider in `Providers` -> `Custom OpenAI`

* On the right side you can click `+` (Add)
* In Provider setting section choose either OpenAI or OpenRouter
* Put Provider name
* Paste Nexos API key

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FACuSIgiaMSk3CEBjYftP%2FScreenshot%202025-11-30%20at%2023.44.39.png?alt=media&amp;token=fd5146ad-a636-4010-99df-4c07919f804d" alt="Custom OpenAI provider setup screen with Nexos provider name and API key field."><figcaption></figcaption></figure>

4. &#x20;In `Chat Completions` tab

* Paste API URL
* Paste Nexos model id in `Body` tab
* Click `Test Connection` to see if everything works

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2F7xdLGGbm8iwlqg37nMvI%2FScreenshot%202025-11-30%20at%2023.48.53.png?alt=media&amp;token=104a4fee-4264-4d57-a3c1-18795c7d4c49" alt="Chat Completions tab showing Nexos API URL, model ID, and successful test connection."><figcaption></figcaption></figure>

5. In `Code Completions` tab

* Check `Parse response as Chat Completions`
* Choose `Chat-based FIM` as `FIM template`
* Paste API URL
* Paste Nexos model id in `Body` tab
* Click `Test Connection` to see if everything works

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FXJtZfeuz4iDwXk7Smqkn%2FScreenshot%202025-12-01%20at%2000.02.22.png?alt=media&amp;token=8ef65515-60a8-4aef-9141-762934f4c9ea" alt="Code Completions tab with Parse response as Chat Completions enabled and Chat-based FIM selected."><figcaption></figcaption></figure>

6. Choose newly added Nexos model in `Models` for all types of requests (tip: you can add more Nexos providers with different models for different types of requests)

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FJYwpL5NMsVPnOiSsPj5y%2FScreenshot%202025-12-01%20at%2000.05.47.png?alt=media&amp;token=b93aca18-5f52-4683-b82a-99149b25747c" alt="Models settings page showing Nexos provider selected for Chat, Auto apply, Commit messages, Inline edit, and Name lookups."><figcaption></figcaption></figure>

7. Click `Apply` and `OK`
8. Open ProxyAI chat window and ask anything about your code.

<figure><img src="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2Fpv6WskV0FHqXFa07EN7n%2FScreenshot%202025-12-01%20at%2000.11.35.png?alt=media&amp;token=6665a283-98dc-4514-9e32-a2514c91c6e4" alt="ProxyAI chat window in JetBrains IDE showing default welcome message and prompt input field."><figcaption></figcaption></figure>

## FAQ

### Which other integrations are available in nexos.ai Gateway?

nexos.ai Gateway supports integrations with the following coding tools:

* [CrewAI](https://docs.nexos.ai/gateway-api/integrations/crewai)
* [Codex CLI](https://docs.nexos.ai/gateway-api/integrations/codex-cli)
* [OpenCode](https://docs.nexos.ai/gateway-api/integrations/opencode)
* [Claude Code](https://docs.nexos.ai/gateway-api/integrations/claude-code)
* [Claude Cowork](https://docs.nexos.ai/gateway-api/integrations/claude-cowork)
* [Bubble](https://docs.nexos.ai/gateway-api/integrations/bubble)
* [GitLab CI](https://docs.nexos.ai/gateway-api/integrations/gitlab-ci)
* [OpenAI Agents SDK](https://docs.nexos.ai/gateway-api/integrations/openai-agents-sdk)
* [Vercel AI SDK](https://docs.nexos.ai/gateway-api/integrations/vercel-ai-sdk)
* [Streamlit](https://docs.nexos.ai/gateway-api/integrations/streamlit)
* [Langfuse](https://docs.nexos.ai/gateway-api/integrations/langfuse)
* [LangGraph](https://docs.nexos.ai/gateway-api/integrations/langgraph)
* [LangChain](https://docs.nexos.ai/gateway-api/integrations/langchain)
* [Roo Code](https://docs.nexos.ai/gateway-api/integrations/roo-code)
* [n8n](https://docs.nexos.ai/gateway-api/integrations/n8n)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexos.ai/gateway-api/integrations/proxyai.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
