客户端集成

Claude Code 终端集成

配置 Anthropic 官方的终端命令行 Agent (Claude Code)，将其 API 路由指向 tflow 网关。

运行机制 (How It Works)

Claude Code 客户端默认使用 Anthropic 消息协议与云端 API 通信。通过合理的变量重定向，可以无缝桥接到 tflow 网关：

直接连接：当设置 ANTHROPIC_BASE_URL 指向 tflow 服务端端点时，Claude Code 将其原生协议直接发送到网关，不需要运行任何本地代理。
端点映射与兼容：tflow 的转发层完全兼容 Anthropic 消息协议，保留了思维链推理（Thinking Block）和原生工具调用（Native Tool Use）等高级特性。
额度结算：Claude Code 生成的所有请求消耗将从您的 tflow 账户额度中扣除，您可以在 tflow 控制台查看实时的 Token 使用数据与调用日志。

快速开始 (Quick Start)

按照以下步骤，在几分钟内完成 Claude Code 到 tflow 的连接配置：

1安装 Claude Code

如果尚未安装客户端，请选择适合您环境的安装方式进行全局安装：

macOS, Linux, WSL:

Bash / Zsh

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

Windows PowerShell:

PowerShell

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

2配置连接到 tflow

通过环境变量将底层 API 重定向。您可以选择将变量写入 Shell 配置文件，或直接写入全局配置文件：

追加到 Shell 配置文件 (如 ~/.zshrc 或 ~/.bashrc)

export ANTHROPIC_BASE_URL="https://tflow.ai-links.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"
export ANTHROPIC_API_KEY="" # 必须显式为空以防止凭据冲突

重要提示：必须将环境变量 ANTHROPIC_API_KEY 显式置为空字符串。否则，Claude Code 会强制调用官方 OAuth 登录逻辑，这会覆盖您的自定义 Base URL 配置。

3清除已缓存的登录凭据

如果您之前已经在客户端中登录过官方 Anthropic 账号，需要执行注销以防配置冲突（未登录过可跳过此步）：

> claude /logout

4启动会话

进入需要协同开发的项目根目录下，在终端直接呼叫：

$ claude

5确认状态验证 (Verify)

可以在 Claude Code 命令行输入交互指令 /status 确认连接是否已切换到 tflow：

> /status
Auth token: ANTHROPIC_AUTH_TOKEN
Anthropic base URL: https://tflow.ai-links.com

配置模型 (Configuring Models)

Claude Code 使用几个不同的环境变量来区分不同层级任务的默认模型。您可以通过在 Shell 配置文件或全局/项目配置文件中声明这些变量，来覆盖各个角色的映射模型：

在您的终端 Shell 配置文件（如 macOS/Linux/WSL 下的 ~/.zshrc 或 ~/.bashrc）中追加以下环境变量定义，并运行 source ~/.zshrc 使其生效：

追加到 ~/.zshrc 或 ~/.bashrc

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-3-5-sonnet" # Opus级复杂任务模型
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-3-5-sonnet" # Sonnet级主力编码模型
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-3-5-haiku" # Haiku级快速补全模型
export CLAUDE_CODE_SUBAGENT_MODEL="claude-3-5-sonnet" # 子Agent任务模型

环境变量名 / 配置项	对应说明
ANTHROPIC_DEFAULT_OPUS_MODEL	用于 Opus 级别的高阶推理任务（如复杂的重构与算法分析）
ANTHROPIC_DEFAULT_SONNET_MODEL	用于 Sonnet 级别的日常主力编码与修改动作
ANTHROPIC_DEFAULT_HAIKU_MODEL	用于 Haiku 级别的极简补全与快速判定逻辑
CLAUDE_CODE_SUBAGENT_MODEL	指定 Claude Code 创建的子任务进程（Sub-agent）运行时所使用的执行模型

配置优先级与建议：

优先级：操作系统级环境变量 (Shell) > 项目级配置文件 (.claude/settings.json) > 全局配置文件 (~/.claude/settings.json)。
动态切换：您也可以在 Claude Code 的交互式命令行会话中，通过输入 /model 命令实时查看或临时切换当前使用的模型。
兼容大模型：虽然客户端本身是针对 Anthropic 官方模型深度优化的，但在通过 tflow 代理时，您也可以指定任何在 tflow 控制台中已上架并启用了的兼容大模型（如主流 OpenAI、Gemini 或 DeepSeek 模型）。但为确保最佳使用体验，强烈建议选用支持思维链推理的主力模型。

故障排查

终端提示授权冲突或无法读取 API Key

这是因为本地缓存了旧的 Anthropic OAuth 会话。请尝试执行一次注销命令：claude /logout。如果仍有异常，检查环境变量 ANTHROPIC_API_KEY 是否已显式设置为空字符串。

报错提示 404 或找不到模型名称

请务必检查您的 ANTHROPIC_BASE_URL 环境变量。为了让 Claude Code 正确拼装接口路径，此处的 Base URL **不应该**以 /v1 或 /v1/ 结尾（例如，若 tflow 网关地址为 https://tflow.ai-links.com，则应配置为 https://tflow.ai-links.com）。此外，还要确认您在 tflow 后台已开通/激活了您在环境变量（如 ANTHROPIC_DEFAULT_SONNET_MODEL）中所指定的模型。

关于 /fast 模式与定价

在官方的 Claude Code 客户端中可以使用 /fast 指令临时切换到快速轻量模型以降低开销。接入 tflow 后，您的所有费用消耗（包括子 Agent 进程以及推理 Token）都由 tflow 扣减并结算，因此请确保您的 tflow API 余额充足。