Claude Code CLI 与桌面端配置

Claude Code CLI 和 Claude Desktop 都可以接入 TokenFlash，但当前版本使用两种不同的配置入口：CLI 修改 ~/.claude/settings.json，桌面端使用内置的 Configure Third-Party Inference 界面。

如果你不熟悉下载安装包、PowerShell、终端、命令或配置文件，请先阅读 电脑基础操作。

先分清两套配置

第一步：安装 Node.js

如果你已经按照 OpenCode 或 Codex 教程安装了 Node.js 24，执行 node -v 和 npm -v 能显示版本号，可以直接跳到下一步。

node -v
npm -v

node -v
npm -v

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo dnf install -y nodejs

需要使用 NVM 或其他架构安装包时，请参考 OpenCode 安装教程中的 Node.js 章节。

第二步：安装 Claude Code CLI

Windows、macOS 和 Linux 都可以使用同一条 npm 命令：

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

安装完成后验证：

claude --version

看到 Claude Code 版本号即表示安装成功。

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

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

第三步：安装 Claude Desktop

桌面端是可选项。只使用 CLI 的用户可以直接跳到“创建 settings.json”。

建议访问 Claude 官方下载页面 获取最新版本，也可以使用下方官方入口：

• macOS：打开 DMG，将 Claude 拖入 Applications 文件夹。
• Windows：打开安装程序，按照界面提示完成安装。
• Linux：按照官方页面选择 apt 或 DEB 安装方式。

安装后打开 Claude Desktop。Code 标签首次运行时可能提示安装本地依赖：

公开教程中的 Claude Desktop Code 初始化界面，实际布局可能随版本更新。查看截图来源

第四步：在桌面端配置 TokenFlash

Claude Desktop 的第三方 API 配置需要从登录页面进入开发者模式。不要先登录普通 Claude 账号。

1. 启用 Developer Mode

启用后，应用菜单中会出现 Developer。

2. 打开第三方推理配置

在应用菜单中依次点击：

Developer > Configure Third-Party Inference…

如果没有看到该菜单，请完全退出 Claude Desktop，重新打开后再次检查 Developer Mode 是否已经启用。

3. 填写 Gateway 信息

在配置窗口左侧选择 Connection，然后填写：

4. 配置模型

如果桌面端能从 TokenFlash 的 /v1/models 自动读取模型，模型列表会自动出现。如果没有出现，请在配置窗口的 Models 区域手动添加当前可用的 Claude 模型 ID，例如：

• claude-sonnet-5
• claude-opus-4-8
• claude-fable-5

模型 ID 以 TokenFlash 模型定价页面 的当前列表为准。

5. 应用到本机

检查配置无误后，点击 Apply locally。Claude Desktop 会把第三方推理配置写入本机并重新启动。

配置成功后进入 Code 标签，可以创建 Local 会话：

公开教程中的 Claude Desktop Code 会话界面。接入 TokenFlash 后请选择本地项目和 Local 会话。查看截图来源

第五步：为 CLI 创建 settings.json

New-Item -ItemType Directory -Force "$HOME\.claude"
notepad "$HOME\.claude\settings.json"

mkdir -p ~/.claude
nano ~/.claude/settings.json

第六步：写入 CLI 的 TokenFlash 配置

将下面内容完整粘贴到 settings.json，把 在这里填写你的APIKey 替换为你的 TokenFlash API Key：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenflash.cn",
    "ANTHROPIC_AUTH_TOKEN": "在这里填写你的APIKey",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5"
  }
}

每个配置项有什么作用

模型 ID 必须与 TokenFlash 模型定价页面 中显示的 ID 完全一致。可用模型变化时，请同步修改对应值。

第七步：启动并验证 CLI

保存 settings.json 后，完全退出之前打开的 Claude Code，再重新打开 PowerShell 或终端。

进入你的项目目录并启动：

cd /path/to/your-project
claude

如果出现“使用检测到的 API Key”之类的提示，请确认使用该 Key。进入 Claude Code 后输入：

请告诉我当前使用的模型，并分析这个项目的目录结构，不要修改任何文件。

也可以输入 /status，检查当前 API provider、Base URL 和模型信息。

第八步：启动并验证桌面端

1. 完全退出 Claude Desktop。
2. 重新打开 Claude Desktop，确认第三方推理配置仍处于已应用状态。
3. 点击 Code 标签。
4. 新建会话时将 Environment 选择为 Local。
5. 选择一个测试项目文件夹。
6. 输入“分析这个项目，不要修改文件”。

能正常返回内容，说明 Claude Desktop 已通过 TokenFlash Gateway 工作。

如何切换模型

Claude Code CLI

修改 settings.json 中的默认模型：

"ANTHROPIC_MODEL": "其他模型ID"

保存后重新打开 CLI。也可以在 CLI 中输入 /model，选择已映射的 Sonnet、Opus、Fable 等模型。

Claude Desktop

重新打开 Developer > Configure Third-Party Inference…，在 Models 区域调整模型列表，然后点击 Apply locally。应用重启后，在模型选择器中选择需要使用的模型。

更新 Claude Code

通过 npm 安装时，三个平台都执行：

npm update -g @anthropic-ai/claude-code
claude --version

原生安装版本会在后台自动更新。桌面端可以使用应用内更新，或重新访问 官方下载页面。

常见问题

claude 命令不存在

关闭并重新打开 PowerShell 或终端，再执行：

node -v
npm -v
npm install -g @anthropic-ai/claude-code
claude --version

桌面端找不到 Third-Party Inference 菜单

1. 退出当前登录，返回 Claude Desktop 登录页面。
2. 打开 Help > Troubleshooting。
3. 点击 Enable Developer Mode。
4. 完全退出并重新打开应用。
5. 在应用菜单中查找 Developer > Configure Third-Party Inference…。

Claude Desktop 无法连接 TokenFlash

确认：

1. Inference provider 是 Gateway。
2. Gateway base URL 没有 /v1。
3. Credential kind 是 Static API key。
4. Gateway auth scheme 是 Bearer。
5. API Key 没有前后空格，并且账户有可用额度。
6. 修改后点击了 Apply locally，并等待应用重新启动。

Claude Code CLI 提示未授权

1. ANTHROPIC_AUTH_TOKEN 没有前后空格。
2. API Key 仍然有效且账户有可用额度。
3. ANTHROPIC_BASE_URL 没有 /v1。
4. JSON 使用英文双引号，最后一项后面没有逗号。

以前使用过切换工具或本地代理

本教程不需要任何本地代理。CLI 的 ANTHROPIC_BASE_URL 和桌面端的 Gateway base URL 都不要使用 127.0.0.1 或 localhost。默认配置应直接指向：

"ANTHROPIC_BASE_URL": "https://tokenflash.cn"

模型不存在或无法使用

前往 模型定价页面 检查模型 ID。模型名称必须完全一致，不能有多余空格。

官方资源

• Claude Code 官方文档
• Claude Desktop 官方下载
• Claude Code 设置说明
• Claude Desktop Gateway 官方配置
• 带截图的 Claude Desktop 安装教程
• TokenFlash API Key