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 接入 TokenFlux。

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

操作步骤：

1. 按 创建 API Key 教程 生成 API Key。
2. 在密钥列表里点击该 Key 的“更多”，选择“导入到 CCS”，在 CC-Switch 弹窗中确认导入。详细说明见 CC-Switch。
3. 在 CC-Switch 的 Claude Code 页面启用刚导入的 TokenFlux 供应商。
4. 配置完成后，重启 Claude Code。

第一步：设置环境变量

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

macOS / Linux

在终端中运行：

export ANTHROPIC_BASE_URL="https://tokenflux.dev"
export ANTHROPIC_AUTH_TOKEN="YOUR_TOKENFLUX_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

将 YOUR_TOKENFLUX_API_KEY 替换为实际的 API Key。

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://tokenflux.dev"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_TOKENFLUX_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows CMD

set ANTHROPIC_BASE_URL=https://tokenflux.dev
set ANTHROPIC_AUTH_TOKEN=YOUR_TOKENFLUX_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://tokenflux.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_TOKENFLUX_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

将 YOUR_TOKENFLUX_API_KEY 替换为实际的 API Key。

验证接入

完成配置后，运行请求：

claude --version
claude -p "只回复 OK" --model claude-sonnet-5-5 --tools "" --no-session-persistence

所选 Key 需要支持示例中的模型；如果分组支持 claude-opus-5-5，也可以将 --model 的值替换为它。该命令会发起真实请求并计费；收到回复后，在 使用记录 中确认请求。

客户端出现认证错误时，查看后面的服务端消息。例如，余额不足也可能显示为 Failed to authenticate；应按具体错误检查余额、订阅或 Key，见 错误码。

Claude Max 分组

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 分组无需设置。

1 小时缓存的上游写入价高于默认的 5 分钟缓存；TokenFlux 的实际扣费以 模型广场 中的缓存价格为准。缓存 TTL 的其他配置方式见 Claude Code 官方说明。

若通过 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。