Claude Code 使用指南

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

安装

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

macOS / Linux

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

Windows PowerShell

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

Windows CMD

需要先安装 Git for Windows，然后运行：

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

macOS / Linux

brew install --cask claude-code

Windows

winget install Anthropic.ClaudeCode

全局安装 Claude Code：

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

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

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

npx @anthropic-ai/claude-code

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

导入

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

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

操作步骤：

1. 按 创建 API Key 教程 生成 API Key。
2. 按 CC-Switch 完成统一供应商配置。
3. 配置完成后，重启 Claude Code。

第一步：设置环境变量

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

macOS / Linux

在终端中运行：

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

$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

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 路径

~/.claude/settings.json

Windows 路径

%userprofile%\.claude\settings.json

settings.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。

Claude Max 分组

WARNING

Claude Max 分组只接受 Claude Code 客户端，无法在 Claude 应用（Claude app）中使用。用其他客户端会返回 403 this group only allows Claude Code clients，见 错误码。

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

若通过 CC-Switch 管理 Claude Code，请参考 CC-Switch 的 Claude Max 环境变量说明。

终端启动

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

macOS / Linux

export ENABLE_PROMPT_CACHING_1H=1

Windows PowerShell

$env:ENABLE_PROMPT_CACHING_1H=1

Windows CMD

set ENABLE_PROMPT_CACHING_1H=1

VSCode / Zed

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

{
  "env": {
    "ENABLE_PROMPT_CACHING_1H": "1"
  }
}

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