实操篇一:Claude Code + Token173 国内直连 Anthropic Fable 5 完整接入教程
2026/6/12 2:18:54 网站建设 项目流程

承接上一篇理论总纲,本文正式进入工具实操环节。作为四款CLI工具中使用人数最多、工程编码场景最常用的Claude Code,也是国内用户接入时最容易出现链路问题的工具。

本篇将基于Token173合规中转平台,手把手完成全流程配置,实现国内无特殊网络环境下稳定调用 Anthropic Fable 5(claude-fable-5)。内容分为基础原生配置、CC Switch 线路统一管理、OpenClaw 本地网关三层方案,从个人临时使用到工程级长期运维全覆盖,所有命令、配置均可直接复制复用。

一、本篇目标与前置说明

1.1 实操目标

  1. 完成 Claude Code 安装与基础配置,依托 Token173 中转链路直连claude-fable-5
  2. 吃透「API Key + Base URL + 模型ID」三大核心配置逻辑(呼应上篇理论);
  3. 掌握两种进阶架构:CC Switch 多密钥一键切换、OpenClaw 本地网关统一转发;
  4. 学会快速定位 401、404、请求超时、流式断连等常见故障。

1.2 必备前置准备

在开始操作前,请确认以下条件全部就绪,避免中途踩坑:

(1)Token173 账号准备(核心)
  1. 已注册并完成 Token173 官网实名认证:https://token173.com
  2. 进入后台API令牌页面,新建并复制有效API Key(格式:sk-xxxx);
  3. 确认账号已开通Anthropic Fable 5调用额度与对应模型分组权限;
  4. 记录平台标准接口地址:https://gw.token173.com/v1(全文统一使用该 Base URL);
  5. 确认目标模型唯一标识:claude-fable-5(不可修改、简写)。
(2)系统运行环境

Claude Code 依赖 Node.js 运行环境,全平台统一要求:Node.js ≥ 18.x 稳定版

  • Windows:PowerShell / CMD 终端;
  • macOS / Linux:系统原生终端;
    执行以下命令校验环境:
node-vnpm-v

若未输出版本号,请先前往 Node.js 官网安装 LTS 长期支持版本。

(3)工具清单
  • 基础版:仅需 终端 + Token173 账号密钥;
  • 进阶版:额外准备CC Switch(线路管理)、OpenClaw(本地网关),两款工具安装方式参考前文。

二、第一步:安装 Claude Code(全平台通用)

Claude Code 采用 npm 全局安装,一条命令即可完成部署,全系统操作一致。

2.1 执行安装命令

npminstall-g@anthropic-ai/claude-code

国内网络若 npm 下载缓慢,可临时切换国内镜像源后再执行安装:

# 临时切换淘宝镜像npmconfigsetregistry shturl.cc/SDHDptQaSO1mfvEcAqr3# 重新执行安装npminstall-g@anthropic-ai/claude-code

2.2 校验安装结果

安装完成后,执行版本查询命令,验证程序是否正常生效:

claude--version

正常返回版本号即代表安装成功。


三、第二步:基础配置 —— 环境变量指向 Token173 中转链路

Claude Code 原生通过环境变量读取鉴权密钥与接口地址,这也是上篇提到的两大核心要素:API Key+Base URL
我们分**临时生效(临时测试)永久生效(长期使用)**两种方式,区分不同操作系统配置。

3.1 核心环境变量说明

环境变量名填写内容作用
ANTHROPIC_API_KEY你的 Token173 API Key接口鉴权凭证,对应中转平台密钥
ANTHROPIC_BASE_URLhttps://gw.token173.com/v1请求转发地址,将流量导向 Token173 而非官方接口

关键提醒:两个变量缺一不可,只填密钥不修改地址,请求依然会直连海外官方接口,中转完全失效。

3.2 Windows 系统配置

方式1:终端临时环境变量(当前会话有效,重启终端失效)

PowerShell 执行:

$env:ANTHROPIC_API_KEY="你的Token173密钥"$env:ANTHROPIC_BASE_URL="https://gw.token173.com/v1"

CMD 执行:

set ANTHROPIC_API_KEY=你的Token173密钥 set ANTHROPIC_BASE_URL=https://gw.token173.com/v1
方式2:系统永久环境变量(全局永久生效)
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」;
  2. 用户变量中新建两条变量,按上表填写名称与对应值;
  3. 保存后重启终端,新环境变量即可加载生效。

3.3 macOS / Linux 系统配置

方式1:终端临时环境变量(当前会话有效)
exportANTHROPIC_API_KEY="你的Token173密钥"exportANTHROPIC_BASE_URL="https://gw.token173.com/v1"
方式2:永久环境变量(全局生效)
  1. 编辑 Shell 配置文件(主流分为zsh/bash):
# zsh 用户(macOS 新版默认)nano~/.zshrc# bash 用户(Linux/旧版macOS)nano~/.bashrc
  1. 在文件末尾追加两行配置:
exportANTHROPIC_API_KEY="你的Token173密钥"exportANTHROPIC_BASE_URL="https://gw.token173.com/v1"
  1. 保存退出,加载配置使其立即生效:
# zshsource~/.zshrc# bashsource~/.bashrc

3.4 验证环境变量是否生效

任意终端执行查询命令,核对输出内容:

# macOS/Linuxecho$ANTHROPIC_BASE_URL# Windows PowerShell$env:ANTHROPIC_BASE_URL

输出https://gw.token173.com/v1代表配置正常。


四、第三步:基础调用测试 —— 验证 Anthropic Fable 5 连通性

环境变量配置完成后,直接在终端启动 Claude Code,指定claude-fable-5模型进行实测。

4.1 交互式对话测试(推荐,验证流式输出)

执行命令进入交互模式:

claude

程序启动后,终端会提示选择模型,手动输入/选择:claude-fable-5
输入测试指令:

简述 Anthropic Fable 5 在代码工程领域的核心优势
预期效果:
  1. 无超时、无 401/404 报错;
  2. 内容流式实时输出(逐字返回),无卡顿、断流;
  3. 正常返回模型回答,代表基础链路完全打通。

4.2 单条指令快速测试(非流式,极简验证)

若仅需快速核验连通性,可使用单行指令直接调用:

claude query--modelclaude-fable-5"写一个Python单例模式实现"

命令执行完毕并返回结果,即调用正常。

重点复盘:本环节完整落地了上篇三大核心要素:Token173密钥(Key)+ 中转地址(Base URL)+ 模型ID(claude-fable-5)


五、进阶方案一:搭配 CC Switch 实现多线路/多密钥统一管理

如果你的场景需要多组 Token173 密钥备用、多线路一键切换、不频繁修改环境变量,推荐搭配 CC Switch 管理渠道,也是团队/高并发场景的首选方案。

5.1 前置要求

  1. CC Switch 已完成安装并后台常驻运行;
  2. 已在 CC Switch「供应商管理」中添加多条 Token173 渠道(不同密钥,统一 Base URL),并绑定claude-fable-5模型分组。

5.2 关联 CC Switch 与 Claude Code

  1. 清空本地手动配置的环境变量(避免冲突);
  2. 打开 CC Switch,将目标 Token173 渠道设为默认线路
  3. 在 CC Switch 内置关联功能中,选择「绑定 Claude Code」,工具会自动接管环境变量注入;
  4. 回到终端,直接执行claude启动程序。

5.3 核心优势

  1. 线路切换:主链路波动时,在 CC Switch 点击「启用备用渠道」,无需改代码、无需改环境变量、无需重启终端
  2. 密钥隔离:密钥统一托管在 CC Switch 本地,不暴露在系统环境变量中,提升安全性;
  3. 批量管理:支持几十组 Token173 密钥分组管理,适合多账号负载均衡。

六、进阶方案二:搭配 OpenClaw(小龙虾)搭建本地网关

面向项目集成、统一日志监控、多工具共用链路的场景,使用OpenClaw + CC Switch + Token173三层架构,构建本地统一AI网关,也是之前整套方案的标准形态。

6.1 架构回顾

Claude CodeOpenClaw 本地网关CC Switch 渠道调度Token173 中转Anthropic Fable 5

6.2 操作步骤

  1. 确保 OpenClaw、CC Switch 全部正常运行,CC Switch 已配置好 Token173 渠道;
  2. 执行 OpenClaw 初始化,自动关联本机 CC Switch:
openclaw onboard
  1. 启动本地网关(示例端口 18789):
openclaw gateway--port18789
  1. 重新配置 Claude Code 环境变量,指向本地网关地址:
# 示例(macOS/Linux)exportANTHROPIC_API_KEY="任意字符"exportANTHROPIC_BASE_URL="http://127.0.0.1:18789/v1"
  1. 终端执行claude启动工具,所有请求将统一经过 OpenClaw 转发。

6.3 附加能力

  1. 可视化日志:浏览器打开http://127.0.0.1:18789/,查看每一条 Fable 5 调用记录、延迟、Token 消耗;
  2. 全工具复用:后续 OpenCode、Codex 等工具可全部对接该本地网关,一套链路全终端共用;
  3. 流量管控:支持请求限流、超时自定义,适配生产环境。

七、高频问题排查(对应上篇理论,精准定位故障)

结合 Claude Code + Token173 实操场景,汇总出现概率最高的报错,按现象、根因、解决方案整理,快速排错。

问题1:返回 401 Unauthorized 鉴权失败

  • 可能原因:API Key 填写错误、复制带入空格/换行、密钥无 Fable 5 权限、密钥过期;
  • 解决方案:重新在 Token173 后台复制密钥,清理多余空白字符;核对账号额度与模型权限;过期密钥直接重新生成。

问题2:返回 404 Not Found 模型不存在

  • 可能原因:模型ID填写错误、Token173 分组未开通claude-fable-5、Base URL 地址错误;
  • 解决方案:严格使用模型名claude-fable-5;进入 Token173 模型广场核对分组权限;检查 Base URL 是否为https://gw.token173.com/v1

问题3:请求超时、连接失败

  • 可能原因:Base URL 仍为官方地址、本地防火墙拦截、Token173 节点网络波动;
  • 解决方案:重新核对环境变量;关闭本地代理/防火墙;切换 CC Switch 内备用 Token173 线路。

问题4:单次请求正常,流式输出断断续续/中途卡死

  • 可能原因:网络链路不稳定、终端长连接被限制;
  • 解决方案:优先使用 Token173 专线节点;改用 CC Switch 切换低延迟通道;降低单次请求max_tokens长度。

问题5:环境变量配置后不生效

  • 可能原因:未重启终端、配置文件未执行source加载、多套环境变量互相覆盖;
  • 解决方案:重启终端重新加载配置;临时环境变量与永久环境变量只保留一套。

八、最佳实践与使用技巧

  1. 密钥安全:个人临时使用建议用环境变量;长期商用优先 CC Switch 托管密钥,禁止代码硬编码 Key;
  2. 线路冗余:至少在 CC Switch 中配置 2~3 组 Token173 备用密钥,应对临时限流与节点波动;
  3. 额度监控:定期登录 Token173 后台查看 Token 消耗,Fable 5 计价较高,合理控制长文本请求;
  4. 版本维护:定期更新 Claude Code、CC Switch、OpenClaw 至最新版,兼容模型新特性。

九、本篇小结 & 下篇预告

本篇总结

本文完成了Claude Code 对接 Token173 调用 Anthropic Fable 5的全流程落地:

  1. 基础版通过系统环境变量,直接打通中转链路,适合个人临时使用;
  2. 进阶版结合 CC Switch 实现多密钥/多线路管理,提升可用性与安全性;
  3. 高阶版搭配 OpenClaw 搭建本地网关,实现多工具统一转发、日志监控,适配团队与项目场景。

整套流程始终围绕上篇提出的「Key + Base URL + 模型ID」三大核心,吃透这套逻辑,其余三款CLI工具的接入思路完全通用。

下篇预告

下一篇实操篇二,我们将讲解OpenCode + Token173部署教程,重点讲解:

  • OpenCode 多模型自由切换配置;
  • 多层级本地配置文件优先级规则;
  • 结合现有 CC Switch + OpenClaw 网关实现一键复用链路。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询