> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apigo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Use Claude models in Claude Code through an Anthropic-compatible proxy.

> Use Claude Code with your platform's Anthropic-compatible proxy.

## Install Claude Code

<Tabs>
  <Tab title="Native Install (Recommended)">
    **macOS, Linux, WSL:**

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    **Windows PowerShell:**

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    **Windows CMD:**

    ```bat theme={null}
    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    ```
  </Tab>

  <Tab title="Homebrew">
    **macOS, Linux:**

    ```bash theme={null}
    brew install --cask claude-code
    ```
  </Tab>

  <Tab title="WinGet">
    **Windows:**

    ```powershell theme={null}
    winget install Anthropic.ClaudeCode
    ```
  </Tab>
</Tabs>

For more installation options and version notes, refer to the [official Claude Code setup guide](https://docs.claude.com/en/docs/claude-code/setup).

## Configure your platform API

> **Important:**
> Before configuring, clear the following Anthropic-related environment variables so old values do not override your platform settings:
>
> * `ANTHROPIC_BASE_URL`
> * `ANTHROPIC_AUTH_TOKEN`

## Choose an integration method

<Tabs>
  <Tab title="@apigo/vibe-coding">
    `@apigo/vibe-coding` corresponds to the interactive terminal tool **Agent CLI Switch**. This flow writes Claude Code settings for you directly.

    Follow the flow shown in the screenshots:

    1. Open **Agent CLI Switch v0.1.0**.
    2. In the **Main menu**, choose **Configure tools**.

    <Frame>
      <img src="https://mintcdn.com/apigo/ooezceiFlVzP_oNP/images/coding-plan/vibe-coding/main-menu.png?fit=max&auto=format&n=ooezceiFlVzP_oNP&q=85&s=43f9a32685ab9f5dfa59217798a10ae0" alt="Agent CLI Switch main menu with Configure tools selected." style={{ borderRadius: '0.5rem' }} width="1238" height="956" data-path="images/coding-plan/vibe-coding/main-menu.png" />
    </Frame>

    3. In **Select tool**, choose **Claude Code**.

    <Frame>
      <img src="https://mintcdn.com/apigo/ooezceiFlVzP_oNP/images/coding-plan/vibe-coding/select-tool.png?fit=max&auto=format&n=ooezceiFlVzP_oNP&q=85&s=d53ff51f4047b809ce1482fec80b7ea1" alt="Agent CLI Switch tool selection screen with Claude Code selected." style={{ borderRadius: '0.5rem' }} width="1354" height="824" data-path="images/coding-plan/vibe-coding/select-tool.png" />
    </Frame>

    4. In **Claude Code edit config**, enter:
       `API URL`: `https://maas.apigo.ai`
       `API Key`: your ApiGo key

    <Frame>
      <img src="https://mintcdn.com/apigo/ooezceiFlVzP_oNP/images/coding-plan/vibe-coding/claude-edit.png?fit=max&auto=format&n=ooezceiFlVzP_oNP&q=85&s=fd4d8e6091d6edade9658c1c52393260" alt="Claude Code edit config screen prompting for API URL and API Key." style={{ borderRadius: '0.5rem' }} width="1340" height="744" data-path="images/coding-plan/vibe-coding/claude-edit.png" />
    </Frame>

    5. After you see the config-saved prompt, choose to apply the configuration immediately.

    <Frame>
      <img src="https://mintcdn.com/apigo/ooezceiFlVzP_oNP/images/coding-plan/vibe-coding/claude-saved.png?fit=max&auto=format&n=ooezceiFlVzP_oNP&q=85&s=5c88828c805d1f573113b9bcbd0eeeea" alt="Claude Code config saved screen asking whether to apply the configuration immediately." style={{ borderRadius: '0.5rem' }} width="1344" height="788" data-path="images/coding-plan/vibe-coding/claude-saved.png" />
    </Frame>

    After that, run `claude` to use Claude through ApiGo.
  </Tab>

  <Tab title="Manual configuration (Current)">
    Edit or create Claude Code's configuration file:

    * macOS & Linux: `~/.claude/settings.json`
    * Windows: `%USERPROFILE%\.claude\settings.json`

    Replace the placeholders below with your platform values:

    * `APIGO_API_KEY`: your platform API key

    ```json theme={null}
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://maas.apigo.ai",
        "ANTHROPIC_AUTH_TOKEN": "APIGO_API_KEY"
      }
    }
    ```

    With those two variables set, Claude Code will send Claude requests through your platform. No extra model-related fields are required.

    Then edit or create `~/.claude.json`:

    ```json theme={null}
    {
      "hasCompletedOnboarding": true
    }
    ```

    > Note: Environment variables `ANTHROPIC_AUTH_TOKEN` and `ANTHROPIC_BASE_URL` take precedence over the configuration file.
  </Tab>
</Tabs>

## Launch Claude Code

After configuration, navigate to your project directory and run the `claude` command in the terminal to launch Claude Code.

## Trust folder

After launching, select **Trust This Folder** to allow Claude Code to access files in that folder, then start using Claude through your platform proxy.
