# Claude Code 設定指南

> 安裝 Claude Code，透過 CC Switch 或環境變數接入 LLMoxy，在終端機裡用 Claude 模型寫程式。

Claude Code 是 Anthropic 推出的終端機 Agent：可以直接讀取儲存庫、修改檔案、執行指令。預設連接官方 API，把閘道指向 LLMoxy 即可。

開始前請準備一把 [LLMoxy 權杖](https://tw.llmoxy.com/docs/get-started/get-token)，建議使用 **auto** 分組。

## 安裝

優先使用官方腳本（已不再推薦 npm）：

```bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```

也可以使用：

```bash
brew install --cask claude-code          # macOS
winget install Anthropic.ClaudeCode      # Windows
```

驗證：

```bash
claude --version
```

## 接入 LLMoxy

Claude Code 走 Anthropic 相容介面，位址 **不帶** `/v1`。

| 變數 | 值 |
| --- | --- |
| `ANTHROPIC_BASE_URL` | `https://llmoxy.com` |
| `ANTHROPIC_AUTH_TOKEN` | 您的 LLMoxy API Key |

### 方式一：CC Switch（推薦）

使用圖形介面切換供應商，不必手動修改環境變數。下載與逐步截圖見 [CC Switch 設定教學](https://tw.llmoxy.com/docs/code-tutorials/cc-switch)。

- 供應商名稱：LLMoxy
- API Key：站點權杖
- 請求位址：`https://llmoxy.com`
- 主模型：`claude-opus-5-5`

### 方式二：環境變數

**macOS / Linux**（Zsh 使用 `~/.zshrc`，Bash 使用 `~/.bashrc`）：

```bash
{
echo ''
echo '# LLMoxy'
echo 'export ANTHROPIC_BASE_URL="https://llmoxy.com"'
echo 'export ANTHROPIC_AUTH_TOKEN="您的LLMoxy API Key"'
} >> ~/.zshrc
source ~/.zshrc
```

**Windows PowerShell**（設定後必須重新開啟新的視窗）：

```powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://llmoxy.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","您的LLMoxy API Key","User")
```

驗證：`echo "$ANTHROPIC_BASE_URL"` 應輸出 `https://llmoxy.com`。

## 啟動

進入專案目錄：

```bash
claude
```

輸入 `/model`，選擇剛設定的模型名稱（例如 `claude-opus-5-5`）。輸入 `/` 可查看全部指令。

![歡迎介面](https://tw.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/welcome.png)

![斜線指令](https://tw.llmoxy.com/docs-assets/migrated/tutorial-claudecode-runoob/slash.png)

可選：執行 `claude doctor` 做一次環境檢查。

## 常見問題

**`claude: command not found`**
確認 `claude --version` 有輸出，然後重新開啟終端機。

**仍要求登入 Claude 帳號**
確認 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 已生效。設定了自訂閘道後會走 API Key，不必登入 claude.ai。

**npm 全域安裝權限錯誤**
不要使用 `sudo npm install -g`。改用官方腳本、Homebrew 或 nvm。

**連不上**
使用 `curl -I https://llmoxy.com` 測試網路；需要代理時設定 `HTTPS_PROXY`。

本文是 https://tw.llmoxy.com/docs/code-tutorials/claude-code 的 markdown 版本。
