> For the complete documentation index, see [llms.txt](https://docs.vngcloud.vn/vng-cloud-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/ai-coding.md).

# AI Coding

AI Coding lets you connect popular AI coding tools — Claude Code, OpenAI SDK, IDE extensions — directly to GreenNode MaaS, using cloud models without managing API keys from external providers.

***

## Architecture

Requests from your tool are redirected to the GreenNode MaaS endpoint. MaaS exposes two protocols in parallel to support all existing clients:

<figure><img src="/files/F1jYxW8ERJ7Rh3sLVRgi" alt=""><figcaption><p>Both API protocols connect to a single MaaS endpoint sharing the same Model Pool</p></figcaption></figure>

A single AI Platform API key works for both protocols.

{% hint style="warning" %}
The LLM URL differs by protocol — see the table below. Using the wrong URL causes 404 errors or malformed request parsing.
{% endhint %}

***

## Protocol and LLM URL

| Client                                    | Protocol               | LLM URL                                              |
| ----------------------------------------- | ---------------------- | ---------------------------------------------------- |
| Claude Code, Anthropic SDK                | Anthropic Messages API | `https://maas-llm-aiplatform-hcm.api.vngcloud.vn`    |
| OpenAI SDK, LiteLLM, Cursor, Continue.dev | OpenAI-compatible      | `https://maas-llm-aiplatform-hcm.api.vngcloud.vn/v1` |

***

## Supported Tools

### Claude Code

Claude Code CLI supports overriding `ANTHROPIC_BASE_URL` — pointing to GreenNode MaaS instead of Anthropic directly. All sessions, tool calls, and sub-agents route through the GreenNode endpoint, with usage visible in AI Platform Console.

### OpenAI-compatible clients

Any tool that allows setting a custom `base_url` in OpenAI SDK format works out of the box — OpenAI Python/Node.js SDK, LiteLLM, Cursor, Continue.dev, and other IDE extensions. Change the base URL and API key; no logic changes needed.

***

## Billing

* **Credit-token:** 1 credit = 1 VND
* **Prepaid:** credits deducted every 5-minute collection cycle — model automatically disabled when credits run out
* **Postpaid:** usage recorded as debt with no quota limit
* View real-time usage at [AI Platform Console → Usage](https://aiplatform.console.vngcloud.vn/)

***

## Getting Started

| I want to...                              | Go to                                                                                                                                         |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Connect Claude Code to MaaS               | [Connect Claude Code to GreenNode MaaS](/vng-cloud-document/ai-stack/agent-base/ai-coding/connect-claude-code-to-maas.md)                     |
| Connect an OpenAI-compatible tool to MaaS | [Connect OpenAI-compatible Clients to GreenNode MaaS](/vng-cloud-document/ai-stack/agent-base/ai-coding/connect-openai-compatible-to-maas.md) |
| Get an API key                            | [AI Platform Console](https://aiplatform.console.vngcloud.vn/)                                                                                |


---

# 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:

```
GET https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/ai-coding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.