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

# Claude Code

> Integrate GBOX with Claude Code for seamless Android app testing and development workflow.

If you have not installed Claude Code, please check  the [installation](https://docs.anthropic.com/en/docs/claude-code/overview) instructions before proceeding.

## Getting Started

<Steps>
  <Step title="Install GBOX CLI">
    Install the GBOX CLI tool to manage your GBOX configuration.

    ```bash theme={null}
    # Install GBOX CLI
    brew install gbox

    # Update GBOX if already installed
    brew update && brew upgrade gbox
    ```
  </Step>

  <Step title="Login and Configure GBOX">
    Authenticate with your GBOX account and set up the configuration.

    ```bash theme={null}
    gbox login
    ```

    This command will prompt you to enter your GBOX API key and configure your account.
  </Step>

  <Step title="Configure the GBOX Android MCP Server for Claude Code using the GBOX CLI">
    Enter the command in the command line

    ```bash theme={null}
    #Using GBOX CLI

    #scope param: MCP server scope for claude-code (local|project|user) (default "user")
    gbox mcp export --merge-to claude-code --scope user

    #Check merging result
    claude mcp list
    #Expected Output: gbox-android: npx -y @gbox.ai/mcp-server
    ```
  </Step>

  <Step title="Develop and Test Your Android App">
    If the installation is correct, you will see the gbox-android mcp server when you type **/mcp** in Claude.

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/claude-code/cc-1.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=9d29bf8aa9ed67eeb1e66fbb03b24fa4" alt="Claude Code Interface 1" width="1952" height="1128" data-path="images/integrations/ide/claude-code/cc-1.png" />

    Then you can **give Claude Code instructions** using **natural language**, for example:

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/claude-code/cc-2.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=453ca09a04c3f9d3a7d4c8d6e55ed12d" alt="Claude Code Interface 1" width="1952" height="2414" data-path="images/integrations/ide/claude-code/cc-2.png" />

    <img src="https://mintcdn.com/gbox-551f8aad/jd9idhpJM54nI41-/images/integrations/ide/claude-code/cc-3.png?fit=max&auto=format&n=jd9idhpJM54nI41-&q=85&s=fab2b1df17a5862ea526064aaec297df" alt="Claude Code Interface 1" width="1952" height="2414" data-path="images/integrations/ide/claude-code/cc-3.png" />

    By default, GBOX MCP uses a cloud android VM. To connect GBOX to your own Android devices, see [Register Local Devices](https://docs.gbox.ai/cli/register-local-device).

    Demo

    <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/IzlZFsqC4CY" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />
  </Step>
</Steps>