通过 Tokios 将 Claude Code 与本地模型搭配使用

Claude Code 会读取两个环境变量来决定请求发送的目标地址。将 ANTHROPIC_BASE_URL 指向 Tokios 并填入您的 Tokios API 令牌后，Claude Code 即可借助 Ollama、LM Studio、llama.cpp 或 vLLM 中的本地模型运行，且不受运行模型的机器限制。所有请求都会经由专属通道传输至您的本地硬件。

前置条件

已启动的 Tokios 连接器且与本地模型成功配对——详情参见连接器安装
已注册的模型部署名称——详情参见注册模型
有效的 Tokios API 令牌——详情参见 API 密钥管理
已安装 Claude Code

环境变量设置方法

Windows 命令行
macOS 与 Linux

claude-code-windows.cmd

set ANTHROPIC_BASE_URL=https://api.tokios.com
set ANTHROPIC_API_KEY=sk-tok-YOUR_KEY
claude --model gemma-tunnel

claude-code-unix.sh

export ANTHROPIC_BASE_URL=https://api.tokios.com
export ANTHROPIC_API_KEY=sk-tok-YOUR_KEY
claude --model gemma-tunnel

务必将 --model 参数设为你注册的模型名称。Claude Code 的模型选择器仅显示 claude* 格式的 ID，因此无法列出你的 Tokios 模型；明确指定名称即可将请求定向至对应的部署实例。

保存相关配置

为避免每次开启新终端会话时都要重新设置变量，可将其添加至 Claude Code 自身的配置文件、Shell 配置文件或 .env 格式文件中。 ~/.claude/settings.json 该方案通用性最强，因为配置内容会随 Claude Code 配置一同迁移，而非仅绑定于特定 Shell。若需将配置限定于特定项目使用，可在项目内创建 .claude/settings.json 文件即可。

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokios.com",
    "ANTHROPIC_API_KEY": "sk-tok-YOUR_KEY"
  }
}

Claude Code 启动时会读取该配置文件，因此已开启的会话无法即时识别修改内容，必须重启后方可生效。若此处设置的令牌无法被识别，可将 ANTHROPIC_API_KEY 替换为 ANTHROPIC_AUTH_TOKEN，这样即可设置原始 Authorization: Bearer 格式的值，这也是各类令牌发放网关所要求的格式。

~/.bashrc 或 ~/.zshrc 打开你的 Shell 配置文件并添加如下内容：

export ANTHROPIC_BASE_URL=https://api.tokios.com
export ANTHROPIC_API_KEY=sk-tok-YOUR_KEY

随后重新加载该配置文件：

source ~/.bashrc   # or source ~/.zshrc

.env 文件 若你的工作流支持 .env 格式文件（例如通过 direnv 或特定 Shell 插件实现），可在项目根目录下创建 .env 文件。

.env

ANTHROPIC_BASE_URL=https://api.tokios.com
ANTHROPIC_API_KEY=sk-tok-YOUR_KEY

启动 Claude Code 前先加载该文件即可。

export $(cat .env | xargs) && claude --model gemma-tunnel

验证连接是否正常

执行一条简单的单次提示，以此确认 Claude Code 能够通过 Tokios 与您本地的上游模型进行通信：

claude --model gemma-tunnel -p "Say hello"

预期的输出结果如下：

Hello! How can I help you today?

若能看到响应内容，说明您的请求已顺利经由 Tokios 网关传递至本地模型。

Claude Code 会以 Anthropic 消息格式发送请求，随后 Tokios 会将其转换为本地后端所需的格式并将响应结果实时返回。

硬件与适配

服务与连接运行时

连接客户端或应用

对比

通过 Tokios 将 Claude Code 与本地模型搭配使用

前置条件

环境变量设置方法

保存相关配置

验证连接是否正常

​前置条件

​环境变量设置方法

​保存相关配置

​验证连接是否正常

前置条件

环境变量设置方法

保存相关配置

验证连接是否正常