💡 Prerequisites
Before you begin, please ensure your environment meets the following requirements:
Operating System: Windows 10/11,macOS 10.15+, Ubuntu 20.04+, or Debian 10+
Node.js: Version 18 or higher

Claude Code Installation and Usage Guide

1️⃣ Install Node.js (Skip if already installed)

Note: Please ensure your Node.js version is ≥ 18.0

For windows users

For Ubuntu / Debian Users

For macOS Users

2️⃣ Install Claude Code

3️⃣ Start Using

Step 1: Get Configuration Info

Auth Token (ANTHROPIC_AUTH_TOKEN)

After registering, go to the API Tokens page and click Create Token to get your key (it starts with sk-).

You can name it anything. It's recommended to set the credit limit to unlimited. Other settings can be left as default.

API Endpoint (ANTHROPIC_BASE_URL)

https://api.cometapi.com is our API service endpoint, same as the main site's address.

Step 2: Run Claude Code (Temporary Session)

Run the following commands in your project directory. This method is only effective for the current terminal session.

After running it for the first time, complete the initial setup as prompted:

Choose your preferred theme + Enter

Confirm the safety notice + Enter

Use the default terminal configuration + Enter

Trust the working directory + Enter

Now, start coding with your AI pair programmer right in the terminal! 🚀

4️⃣ Configure Environment Variables (Recommended)

To avoid re-entering the export command every time you open a new terminal, it is recommended to permanently add the environment variables to your shell configuration file.

Step 1: Write to Configuration File

Run the following commands. They will automatically append the configuration to ~/.bash_profile, ~/.bashrc (for Bash), and ~/.zshrc (for Zsh).

Step 2: Use After Restarting Terminal

Completely close and reopen your terminal for the changes to take effect. Afterwards, you can simply navigate to your project directory and run claude.

❓ FAQ

Important Note: Our service acts only as a proxy for the official Claude Code and cannot process API requests for other services.

Q: What should I do if I encounter an API error?
A: This might be due to temporary instability in the proxy network. You can try quitting Claude Code (/quit or Ctrl+C) and retrying a few times.

Q: What if I encounter a login error on the website?
A: Try clearing the cookies for our site in your browser and log in again.

Q: How to fix the Invalid API Key · Please run /login error?
A: This error indicates that Claude Code did not detect the ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL environment variables. Please go back to Step 4 and double-check if the variables are configured correctly and that you have restarted your terminal.

Q: Why does the status show offline?
A: Claude Code checks its network status by trying to connect to Google. The offline status simply means it couldn't reach Google. This does not affect your ability to use the core features of Claude Code through our proxy.

Q: Why does the web browsing (Fetch) feature fail?
A: This is because before fetching a webpage, Claude Code calls a native Claude service to determine if the page is accessible. This native service requires an international internet connection (often via a global proxy) to function correctly.

Q: Why do my requests always show fetch failed?
A: This could be due to network environment issues in your region, preventing a stable connection to our proxy server. Try using a system-wide proxy tool.

Q: Claude Code doesn't work after I logged into the official Anthropic website?
A: If you previously logged into your account on the official Anthropic website, Claude Code may fail to work with third-party API providers like CometAPI. This happens because Claude Code prioritizes the cached official authentication credentials, causing a conflict with third-party API keys.

Solution:

Run /logout in the Claude Code command line to sign out of the official account

Close Claude Code completely

Restart and configure your third-party API key

If the issue persists, you can completely clear the authentication cache by running:

Claude Code Installation and Usage Guide

💡 Prerequisites#

Claude Code Installation and Usage Guide#

1️⃣ Install Node.js (Skip if already installed)#

For windows users#

For Ubuntu / Debian Users#

For macOS Users#

2️⃣ Install Claude Code#

3️⃣ Start Using#

Step 1: Get Configuration Info#

Step 2: Run Claude Code (Temporary Session)#

4️⃣ Configure Environment Variables (Recommended)#

Step 1: Write to Configuration File#

Step 2: Use After Restarting Terminal#

❓ FAQ#

💡 Prerequisites

Claude Code Installation and Usage Guide

1️⃣ Install Node.js (Skip if already installed)

For windows users

For Ubuntu / Debian Users

For macOS Users

2️⃣ Install Claude Code

3️⃣ Start Using

Step 1: Get Configuration Info

Step 2: Run Claude Code (Temporary Session)

4️⃣ Configure Environment Variables (Recommended)

Step 1: Write to Configuration File

Step 2: Use After Restarting Terminal

❓ FAQ