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

# Quickstart

> In 4 steps, claim credit, create a token, and continue with the right setup guide for your tool.

<Steps>
  <Step title="Create an account and claim your trial credit">
    Visit the BetterToken registration page (`https://www.bettertoken.ai/register`) to create an account.

    You'll automatically receive a **¥5 trial credit** on signup.
  </Step>

  <Step title="Redeem credit or review the top-up entry">
    After you sign in, open **Wallet management** in the left sidebar. If you have a redemption code, redeem it first before you create a token.

    <Tabs>
      <Tab title="Redeem a code">
        On the **Wallet management** page, find the **Redeem code** section. Paste your code, then click **Redeem credit**.

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/quickstart/change_code.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=ce97eec15c05eda649cb40164ddf312c" alt="BetterToken dashboard wallet management page with Wallet management highlighted in the sidebar and the redeem code field and button highlighted." style={{ borderRadius: '0.5rem' }} width="3836" height="1854" data-path="images/quickstart/change_code.png" />
        </Frame>

        Follow the highlighted order in the screenshot:

        1. Click **Wallet management** in the sidebar
        2. Paste the code into the input field
        3. Click **Redeem credit**
      </Tab>

      <Tab title="Top up account">
        Online top-up is not open yet.

        <Note>
          You may still see the **Top up** entry in the dashboard, but for now you should use the trial credit or a redemption code instead.
        </Note>
      </Tab>
    </Tabs>
  </Step>

  <Step title="Open token management and add a token">
    Once you have available credit, open **Token management** in the left sidebar. Then click **Add token**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/Fv_YTOK5PPggmQ0r/images/quickstart/create-api-key-1.png?fit=max&auto=format&n=Fv_YTOK5PPggmQ0r&q=85&s=7827cf6b731d113aa534f3a847662fe8" alt="BetterToken dashboard with Token management highlighted in the sidebar and Add token highlighted at the top." style={{ borderRadius: '0.5rem' }} width="3014" height="1652" data-path="images/quickstart/create-api-key-1.png" />
    </Frame>

    This opens a drawer where you name the group and create the token.

    <Info>
      Think of the group name as the intended use of this token. If you pick the right group first, the rest of the setup is much easier.
    </Info>
  </Step>

  <Step title="Name the group by tool type">
    In the drawer, name the group based on the tool you will connect.

    <Warning>
      Groups that start with `Claude` can only be used with Claude Code.
    </Warning>

    <Warning>
      Groups that start with `Codex` can be used with Codex and external tools such as Cursor, Cline, Zed, and Roo Code.
    </Warning>

    Use a simple naming pattern:

    ```text theme={null}
    Claude-your-name
    Codex-your-name
    ```

    For example: `Claude-main` or `Codex-team`.

    After you create the token, copy the API Key.

    <Warning>
      Keep your API Key safe. Store it as an environment variable instead of hardcoding it into source code or config files.
    </Warning>

    Start with:

    ```bash theme={null}
    export BETTERTOKEN_API_KEY="your-api-key-here"
    ```
  </Step>

  <Step title="Continue with the guide for your tool">
    At this point, you only need to remember one rule: choose the correct group first, then follow the matching tool guide.

    <Check>
      If you are connecting Claude Code, use a group that starts with `Claude`, then continue with the [Claude Code guide](/en/ai-tools/claude-code).
    </Check>

    <Check>
      If you are connecting Codex or any external tool, use a group that starts with `Codex`, then continue with the [Codex guide](/en/ai-tools/codex).
    </Check>

    <Note>
      Different tools use different `Base URL` values, auth fields, and model-group settings. Follow the dedicated tool guide instead of copying one setup into every client.
    </Note>
  </Step>
</Steps>

## Next steps

Continue with the guide that matches your tool:

<Card title="Connect CC Switch" href="/en/ai-tools/cc-switch">
  Start here if you want to manage Claude Code, Codex CLI, OpenCode, and OpenClaw providers in one place.
</Card>

<Columns cols={2}>
  <Card title="Connect Claude Code" icon="terminal" href="/en/ai-tools/claude-code">
    Use a group that starts with `Claude` and follow the full Claude Code setup guide.
  </Card>

  <Card title="Connect Codex" icon="code" href="/en/ai-tools/codex">
    Use a group that starts with `Codex` and follow the full Codex setup guide.
  </Card>
</Columns>
