Getting Started
Author: goswitch
Updated: 2026-06-13T10:02:01.000Z
Let's start here!
Your GoSwitch journey from zero~
Follow the steps and you'll be fine!
Step 1: Register an Account
- Registration link: https://goswitch.online/sign-up
- Open the registration link, then click "Register" in the upper right corner of the page.
- If you are on the login page, you can also click "No account? Register" at the bottom to enter the registration process.
Method 1 (Recommended): Register with GitHub Account
- Click "Continue with GitHub".
- Select the GitHub account you want to bind in the popup and complete authorization.
- After successful authorization, the system will automatically create your account and log you in.
Registering with GitHub doesn't require a separate password. For future logins, just select the same GitHub account.
Method 2: Register with Email
- Click "Register with Username".
- Fill in your email, username, and password.
- Follow the page prompts to submit and complete registration.
Note
Your email will be used for verification and notifications. We recommend using a combination of letters, numbers, and special characters for your password. Keep your login credentials safe to prevent account theft.
Step 2: Login
- Login link: https://goswitch.online/sign-in
Login with GitHub Account
- Click "Continue with GitHub".
- Select the GitHub account you used during registration.
- After successful authorization, you'll be automatically logged in.
Login with Email/Username
- Enter your email address or username.
- Enter your account password.
- Click "Continue" to complete login.
Step 3: Purchase Quota
After logging into the console, go to the "Wallet Management" page on the left side to purchase quota.
- Select a fixed quota amount in "Select recharge quota", or enter a custom amount in "Custom quota".
- Confirm the "Actual payment amount" at the bottom of the page, then click "Pay Now".
Payment Notes
The current exchange rate is 1:1, meaning 1 USDT equals 1 USD quota. If the payment page doesn't appear when using Alipay or WeChat Pay, please disable your proxy and try again.
Step 4: Create an API Token
After logging in, go to the console panel and select "Token Management" from the left side.
Enter Token Management
- Click "Token Management" in the left menu.
- Click "Add Token" at the top of the page.
Create a New Token
Fill in the token information in the popup:
- Token Name: Used to distinguish different purposes, e.g.,
Claude Code,Codex,Gemini. - Token Group: Must be selected. The group determines which models this token can use.
- Expiration Time: Default is "Never expire", or you can set a validity period as needed.
- Quantity: Generally keep
1. - Quota Setting: When "Unlimited quota" is enabled, the token's actual available quota is still limited by your account balance.
- Access Restriction: If you're not familiar with this, it's recommended to keep the default settings. Don't enable model restrictions or IP whitelist.
Choose the correct token group
The token group directly affects available models. For example, Claude Code, Codex, and Gemini CLI need to select their corresponding groups. If you select the wrong group, you may encounter "model not found" errors or unable to call models during CLI configuration.
If you're unsure which group fits your scenario, please read the GoSwitch Group Introduction first.
After filling in, click "Submit" at the bottom right to complete the creation.
View Group Available Models
You can view the models supported by each token group in "Model Plaza".
- Click "Model Plaza" in the upper right corner of the page.
- Select a group from "Available token groups" on the left.
Step 5: Environment Check
Before configuring Claude Code, Codex, or Gemini CLI, please confirm that Node.js is properly installed on your machine.
Execute the following in a Windows, macOS, or Linux terminal:
npm list -g --depth-0If the command runs successfully, Node.js and npm are available. Even if no global packages are shown in the output, it doesn't affect subsequent configuration.
If you see "command not found" or similar errors, it means Node.js isn't installed or hasn't been properly added to the system PATH. Please install Node.js first, then re-run the command to confirm.
Environment check must be completed first
CLI tools depend on Node.js and npm. If the environment isn't ready, subsequent installations of Claude Code, Codex, or Gemini CLI may fail.
Step 6: Configure CLI Tools
GoSwitch supports using Claude Code, Codex, and Gemini CLI in the command line
Prerequisites
Before configuring CLI, please complete the following steps:
- Complete Environment Check, ensuring Node.js and npm are working properly.
- Complete Install CLI, installing Claude Code, Codex, and Gemini CLI.
Recommended Configuration
To make the configuration process simpler and easier, we strongly recommend using the open-source GitHub project CC-Switch to configure your environment.
CC-Switch Configuration Tutorial for CC, Codex, Gemini
If you're experienced or prefer not to use this tool, you can refer to the CLI manual configuration tutorials below. But we still strongly recommend using this tool to save time!
CLI Manual Configuration Tutorial Links
Note: Regardless of which CLI you use, please complete the prerequisites above first, ensuring Node.js, npm, and the corresponding CLI are all working properly.