> 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/connect-claude-code-to-maas.md). # Connect Claude Code to GreenNode MaaS > Route Claude Code CLI requests through GreenNode MaaS instead of the Anthropic API directly — all traffic goes through GreenNode infrastructure and is billed via internal credit-tokens. *** ## Prerequisites * An active [AI Platform](https://aiplatform.console.vngcloud.vn/) account * Claude Code CLI installed {% hint style="info" %} Claude Code uses the **Anthropic API protocol**. The LLM URL is `https://maas-llm-aiplatform-hcm.api.vngcloud.vn` (no `/v1`). {% endhint %} *** ## Step 1 — Get an API key from AI Platform 1. Log in to [AI Platform Console](https://aiplatform.console.vngcloud.vn/) 2. Go to **API Keys** → **Create API Key** 3. Name the key using the format `claude-code-` (5–50 chars, lowercase letters, numbers, and hyphens) 4. Copy the API key — it is shown only once {% hint style="warning" %} A newly created API key has status `pending`. Poll `api-keys get ` until the status is `ACTIVE` before using it. {% endhint %} *** ## Step 2 — Select a model List available Claude models: ```bash bash .claude/skills/agentbase/scripts/aip.sh models list --providers anthropic --status ENABLED ``` Note the `path` value for the model you want (e.g., `claude-sonnet-4-6`, `claude-opus-4-8`). This value is used in the model mapping environment variables in the next step. *** ## Step 3 — Configure Choose one of two options: **Option A — Shell profile (system-wide)** Add to `~/.zshrc` or `~/.bashrc`: ```bash # GreenNode MaaS — Claude Code Integration export ANTHROPIC_BASE_URL="https://maas-llm-aiplatform-hcm.api.vngcloud.vn" export ANTHROPIC_AUTH_TOKEN="" export ANTHROPIC_API_KEY="" # Must be empty — avoids routing to Anthropic directly # Model mapping (use the path from Step 2) export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6" export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001" export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6" ``` Reload without restarting the terminal: ```bash source ~/.zshrc ```

ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL configured in shell profile

**Option B — Project settings (per-project)** Create `.claude/settings.local.json` at the project root: ```json { "env": { "ANTHROPIC_BASE_URL": "https://maas-llm-aiplatform-hcm.api.vngcloud.vn", "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_API_KEY": "", "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6", "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001", "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6" } } ``` {% hint style="warning" %} Claude Code does not read standard `.env` files. Use `settings.local.json` or a shell profile instead. {% endhint %} *** ## Step 4 — Verify the connection Open Claude Code and run: ``` /status ``` Expected result: * Base URL points to `maas-llm-aiplatform-hcm.api.vngcloud.vn` * Model matches your configuration Confirm requests are recorded in [AI Platform Console → Usage](https://aiplatform.console.vngcloud.vn/). *** ## Environment Variables Reference | Variable | Purpose | Example value | | -------------------------------- | ----------------------------------- | ------------------------------------------------- | | `ANTHROPIC_BASE_URL` | Redirect API calls to GreenNode | `https://maas-llm-aiplatform-hcm.api.vngcloud.vn` | | `ANTHROPIC_AUTH_TOKEN` | Authentication API key | `` | | `ANTHROPIC_API_KEY` | Must be empty (avoid conflict) | `""` | | `ANTHROPIC_DEFAULT_SONNET_MODEL` | Model for everyday coding | `claude-sonnet-4-6` | | `ANTHROPIC_DEFAULT_OPUS_MODEL` | Model for complex reasoning | `claude-opus-4-8` | | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Model for fast completions | `claude-haiku-4-5-20251001` | | `CLAUDE_CODE_SUBAGENT_MODEL` | Model used when spawning sub-agents | `claude-sonnet-4-6` | *** ## Billing & Usage * Requests through GreenNode MaaS are billed in credit-tokens (1 credit = 1 VND) * View real-time usage on [AI Platform Console → Usage](https://aiplatform.console.vngcloud.vn/) * **Prepaid:** credits are deducted every 5-minute collection cycle — when credits run out, the model is automatically disabled * **Postpaid:** usage is recorded as a debt with no quota limit *** ## Troubleshooting | Symptom | Cause | Fix | | --------------------------------- | --------------------------------- | ------------------------------------------------- | | `401 Unauthorized` | Wrong or inactive API key | Verify the key; create a new one if needed | | `403 Forbidden` | API key not yet ACTIVE | Poll `api-keys get ` until status = ACTIVE | | Model not responding | Credits exhausted, model disabled | Add credits in AI Platform Console | | Requests still going to Anthropic | `ANTHROPIC_API_KEY` is not empty | Set `ANTHROPIC_API_KEY=""` | | Wrong model used | Incorrect model path | Verify the `path` field with `aip.sh models list` | | `/status` reports URL error | Base URL has a trailing slash | Remove trailing `/` from `ANTHROPIC_BASE_URL` | *** ## Result After completing setup, Claude Code CLI routes all requests through GreenNode MaaS. Usage is recorded in AI Platform Console and billed via internal credit-tokens.

Claude Code running successfully through GreenNode MaaS endpoint

| I want to... | Go to | | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | Use an OpenAI-compatible tool with MaaS | [Connect OpenAI-compatible Clients to GreenNode MaaS](/vng-cloud-document/ai-stack/agent-base/ai-coding/connect-openai-compatible-to-maas.md) | | View usage and billing | [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, and the optional `goal` query parameter: ``` GET https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/ai-coding/connect-claude-code-to-maas.md?ask=&goal= ``` `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.