工具接入与请求路由

Tokenhush 是一个本地、仅回环的 HTTP 网关：在 AI 编程工具的请求 body 到达模型之前，把它里面的密钥与 PII 脱敏，并在响应回来时还原。任何允许覆盖其 OpenAI 兼容或 Anthropic base URL 的工具，都能放在它之后：把那个 URL 指向回环网关，工具就照常工作。

网关默认监听 http://127.0.0.1:8787，tokenhush env <tool> 会为 14 个客户端打印现成片段。

唯一的规则

两条客户端风格，两种 URL 形态。你只需要匹配自己工具的那一种：

Anthropic 风格客户端用裸源站： http://127.0.0.1:8787。
OpenAI 兼容客户端用 /v1： http://127.0.0.1:8787/v1。

tokenhush env <tool> 会按你的 shell 方言，为你指定的工具打印对应的那一种。下面的小节展示同样的片段。如果你用 --port 或 listen.port 改了端口，把 8787 换成你的端口。

工具

顺序就是 tokenhush env 列出它们的顺序。

claude

export ANTHROPIC_BASE_URL="http://127.0.0.1:8787"

codex

加入 ~/.codex/config.toml：

model_providers.tokenhush = { name = "Tokenhush", base_url = "http://127.0.0.1:8787/v1" }

只有 API key 模式能经过网关。ChatGPT 订阅登录不行。

aider

export OPENAI_API_BASE="http://127.0.0.1:8787/v1"
export ANTHROPIC_API_BASE="http://127.0.0.1:8787"

cline

在 VS Code 中：Settings，然后是 API Provider，再是 “OpenAI Compatible”，然后把 Base URL 设为：

http://127.0.0.1:8787/v1

roo

Roo Code 使用与 Cline 相同的 VS Code 设置路径：Settings，然后是 API Provider，再是 “OpenAI Compatible”，最后是 Base URL：

http://127.0.0.1:8787/v1

opencode

在 opencode.json 中加入一个名为 tokenhush 的 provider：

{
  "provider": {
    "tokenhush": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Tokenhush",
      "options": {
        "baseURL": "http://127.0.0.1:8787/v1"
      }
    }
  }
}

qwen

export OPENAI_BASE_URL="http://127.0.0.1:8787/v1"
export ANTHROPIC_BASE_URL="http://127.0.0.1:8787"

crush

在 crush.json 中加入一个名为 tokenhush 的 provider：

{
  "providers": {
    "tokenhush": {
      "type": "openai",
      "base_url": "http://127.0.0.1:8787/v1"
    }
  }
}

zed

在 settings.json 中：

{
  "language_models": {
    "openai_compatible": {
      "tokenhush": {
        "api_url": "http://127.0.0.1:8787/v1"
      }
    }
  }
}

continue

在 ~/.continue/config.yaml 中加入一个名为 tokenhush 的模型：

models:
  - name: tokenhush
    provider: openai
    apiBase: "http://127.0.0.1:8787/v1"

openwebui

启动服务前导出 base URL：

export OPENAI_API_BASE_URL="http://127.0.0.1:8787/v1"

goose

export OPENAI_HOST="http://127.0.0.1:8787"
export OPENAI_BASE_PATH="v1"

注意 Goose 把源站（OPENAI_HOST）与路径前缀（OPENAI_BASE_PATH）分开，所以它的 host 值不带 /v1。

openhands

export LLM_BASE_URL="http://127.0.0.1:8787/v1"

同一个值也可以放到 [llm].base_url 设置里。

kilo

Kilo Code 使用与 Cline 相同的 VS Code 设置路径：Settings，然后是 API Provider，再是 “OpenAI Compatible”，最后是 Base URL：

http://127.0.0.1:8787/v1

其它工具

如果你的工具不在列表里，不需要片段。设置下面两个值之一：

把它的 OpenAI 兼容 base URL 设为 http://127.0.0.1:8787/v1，或
把它的 Anthropic base URL 设为 http://127.0.0.1:8787。

然后用 verify.zh-CN.md 里的本地检查确认整个往返。

配置

Tokenhush 读取 tokenhush.yaml。完整参考 —— 每个键及其默认值、文件位置，以及如何把请求路由到你自己的厂商 —— 见 configuration.zh-CN.md。

使用中转站前唯一必须设置的是 upstreams 条目。它是 {match, target} 条目的列表：match 是请求路径前缀，target 是厂商源站（加上 /v1 之前的任何前缀），不带结尾斜杠且不带 /v1。

upstreams:
  - match: /v1/chat/completions
    target: https://your-provider.example.com

没有 upstreams 时，应用内置表：/v1/messages 去 Anthropic，/v1/chat/completions 与 /v1/responses 去 OpenAI。完整表、匹配规则与优先级、示例与排错见 configuration.zh-CN.md。

另见

deployment.zh-CN.md：安装路径与服务包装。
verify.zh-CN.md：本地 echo 上游检查。
security.zh-CN.md：回环绑定背后的安全模型。

最后更新: 2026-10-10