---
verifiedAt: '2026-08-22'
---

# Claude Code 使用指南

`Claude Code` 是 Anthropic 推出的 AI 编程助手，支持代码生成、修改和审查。

## 安装

根据使用习惯选择安装方式。

<DocsTabs default-tab="native">
  <DocsTab title="脚本安装" 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**

需要先安装 [Git for Windows](https://git-scm.com/download/win)，然后运行：

```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 安装" name="npm">

全局安装 `Claude Code`：

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

安装完成后，可运行 `claude --version` 验证安装，在终端运行 `claude` 即可启动。

  </DocsTab>

  <DocsTab title="npx 启动" name="npx">

无需全局安装，可直接使用 `npx` 按需调用 `Claude Code`：

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

第一次运行时，`npx` 会自动下载并执行 `Claude Code`。

  </DocsTab>
</DocsTabs>

## 导入

安装完成后，选择以下两种方式之一将 `Claude Code` 接入 `Flux`。

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

推荐使用 `CC-Switch` 统一管理配置。

操作步骤：

1. 按 [创建 API Key 教程](https://docs.tryflux.net/docs/flux/create-apikey.md) 生成 API Key。
2. 按 [CC-Switch](https://docs.tryflux.net/docs/agents/cc-switch.md) 完成统一供应商配置。
3. 配置完成后，重启 `Claude Code`。

  </DocsTab>

  <DocsTab title="手动填写" name="manual-setup">

**第一步：设置环境变量**

VS Code 扩展与 CLI 共享 `~/.claude/settings.json`。终端中临时设置的环境变量不一定会被编辑器继承；未生效时按第二步写入 `settings.json`。Zed 的配置行为取决于所安装的外部 Agent。

**macOS / Linux**

在终端中运行：

```bash
export ANTHROPIC_BASE_URL="https://api.tryflux.net"
export ANTHROPIC_AUTH_TOKEN="YOUR_FLUX_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

将 `YOUR_FLUX_API_KEY` 替换为实际的 API Key。

**Windows PowerShell**

```powershell
$env:ANTHROPIC_BASE_URL="https://api.tryflux.net"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_FLUX_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

**Windows CMD**

```cmd
set ANTHROPIC_BASE_URL=https://api.tryflux.net
set ANTHROPIC_AUTH_TOKEN=YOUR_FLUX_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

**第二步：配置 VSCode Claude Code（可选）**

如果 VSCode 中的 Claude Code 扩展未读取到 shell 环境变量，还可以通过 `settings.json` 显式配置：

**macOS / Linux 路径**

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

**Windows 路径**

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

**settings.json 内容**

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tryflux.net",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_FLUX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
```

将 `YOUR_FLUX_API_KEY` 替换为实际的 API Key。

  </DocsTab>
</DocsTabs>

## Claude Max 分组

::: warning
`Claude Max` 分组只接受 `Claude Code` 客户端，无法在 Claude 应用（Claude app）中使用。用其他客户端会返回 403 `this group only allows Claude Code clients`，见 [错误码](https://docs.tryflux.net/docs/errors.md#分组能力限制)。
:::

使用 `Claude Max` 分组时，可以在完成上方基础配置后额外开启 `ENABLE_PROMPT_CACHING_1H=1`。该选项会启用 1 小时 prompt cache，适合重复携带较长上下文的 Claude Code 会话。其他 Claude 分组无需设置。

若通过 `CC-Switch` 管理 Claude Code，请参考 [CC-Switch 的 Claude Max 环境变量说明](https://docs.tryflux.net/docs/agents/cc-switch.md#claude-max-环境变量)。

### 终端启动

按系统设置一次环境变量后，再启动 `Claude Code`。

**macOS / Linux**

```bash
export ENABLE_PROMPT_CACHING_1H=1
```

**Windows PowerShell**

```powershell
$env:ENABLE_PROMPT_CACHING_1H=1
```

**Windows CMD**

```cmd
set ENABLE_PROMPT_CACHING_1H=1
```

### VSCode / Zed

如果你通过 VSCode 或 Zed 启动 `Claude Code`，可以在 `~/.claude/settings.json` 或 `%userprofile%\.claude\settings.json` 的 `env` 中补充：

```json
{
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}
```

如果文件里已经有 `env`，只需要把 `ENABLE_PROMPT_CACHING_1H` 这一行合并进去，不要重复创建第二个 `env`。