# Claude Code Guide

`Claude Code` is an AI coding assistant from Anthropic that supports code generation, modification, and review.

## Installation

Choose an installation method based on your workflow.

<DocsTabs default-tab="native">
  <DocsTab title="Script Install" name="native">

**macOS / Linux**

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

**Windows PowerShell**

```powershell
irm https://claude.ai/install.ps1 | iex
```

**Windows CMD**

Install [Git for Windows](https://git-scm.com/download/win) first, then run:

```cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
```

  </DocsTab>

  <DocsTab title="Homebrew" name="homebrew">

**macOS / Linux**

```bash
brew install --cask claude-code
```

  </DocsTab>

  <DocsTab title="WinGet" name="winget">

**Windows**

```powershell
winget install Anthropic.ClaudeCode
```

  </DocsTab>

  <DocsTab title="npm Install" name="npm">

Install `Claude Code` globally:

```bash
npm install -g @anthropic-ai/claude-code
```

After installation, run `claude-code` in a terminal to start it.

  </DocsTab>

  <DocsTab title="Run with npx" name="npx">

Without global installation, you can run `Claude Code` on demand with `npx`:

```bash
npx @anthropic-ai/claude-code
```

On first run, `npx` downloads and executes `Claude Code` automatically.

  </DocsTab>
</DocsTabs>

## Connect to GoRouter

After installation, choose one of the following methods to connect `Claude Code` to `GoRouter`.

<DocsTabs default-tab="cc-switch-setup">
  <DocsTab title="Use CC-Switch" name="cc-switch-setup">

Using `CC-Switch` is recommended for centralized configuration.

Steps:

1. Follow [Create API Key](https://docs.gorouter.cc/en/docs/gorouter/create-apikey.md) to generate an API key.
2. Follow [CC-Switch](https://docs.gorouter.cc/en/docs/agents/cc-switch.md) to configure a unified provider.
3. Restart `Claude Code` after configuration is complete.

  </DocsTab>

  <DocsTab title="Manual Setup" name="manual-setup">

**Step 1: Set environment variables**

Choose the method for your operating system.

If you use `Claude Code` inside VSCode or Zed, it usually follows the global `Claude Code` configuration. After configuring it with this section, restart the editor for the changes to take effect.

**macOS / Linux**

Run in a terminal:

```bash
export ANTHROPIC_BASE_URL="https://www.gorouter.cc"
export ANTHROPIC_AUTH_TOKEN="YOUR_GOROUTER_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

Replace `YOUR_GOROUTER_API_KEY` with your real API key.

**Windows PowerShell**

```powershell
$env:ANTHROPIC_BASE_URL="https://www.gorouter.cc"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_GOROUTER_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

**Windows CMD**

```cmd
set ANTHROPIC_BASE_URL=https://www.gorouter.cc
set ANTHROPIC_AUTH_TOKEN=YOUR_GOROUTER_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

**Step 2: Configure VSCode Claude Code (optional)**

If the Claude Code extension in VSCode does not read shell environment variables, configure `settings.json` explicitly:

**macOS / Linux path**

```text
~/.claude/settings.json
```

**Windows path**

```text
%userprofile%\.claude\settings.json
```

**settings.json content**

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.gorouter.cc",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_GOROUTER_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
```

Replace `YOUR_GOROUTER_API_KEY` with your real API key.

  </DocsTab>
</DocsTabs>