agentleFS
tkbk-onlinetkbk-online/skills/skills/tkbk/tkbk-setup/SKILL.md

tkbk-setup

Skill0 starsChanged 31 days agoMITView on GitHub

Подключение любого инструмента к шлюзу TKBK (api.tkbk.online, один ключ cr_… для Claude, GPT, DeepSeek, GLM, Grok) — Claude Code, Codex CLI, Cursor, Cline, Kilo Code, Zed, JetBrains/Continue, Aider, n8n, Dify, Open WebUI, OpenCode, Chatbox, SDK Anthropic/OpenAI, curl; выбор base URL по формату API, проверка ключа скриптом scripts/tkbk-check.mjs, разбор ошибок 401/402/404/429. Применяй, когда просят «подключи TKBK», «настрой Claude Code / Cursor / Codex на TKBK», «какой base URL», «не работает ключ cr_».

  • Reads credentials

The file

Files
SKILL.md

Подключение инструментов к TKBK

TKBK — единый API-шлюз: один ключ cr_… и один хост https://api.tkbk.online для Claude, GPT, DeepSeek, GLM и Grok. Клиент не меняется — меняются base URL и ключ. Скил подбирает правильный адрес под инструмент, прописывает настройки и проверяет, что запросы ходят.

Когда применять

  • «Подключи Claude Code / Cursor / Codex / n8n к TKBK», «какой base URL указать».
  • «Ключ не работает», «401», «404 model not found», «запросы уходят на api.anthropic.com».
  • «Какую модель выбрать» — направь на каталог, не выбирай за пользователя.

Три формата — три адреса

Формат APIBase URLКто его используетКлюч в
Anthropic Messageshttps://api.tkbk.online (без /v1 — клиент добавит /v1/messages сам)Claude Code, Anthropic SDK, Cline/Kilo в режиме Anthropic, ZedANTHROPIC_AUTH_TOKEN или x-api-key
OpenAI Chat Completionshttps://api.tkbk.online/v1OpenAI SDK, n8n, Dify, Open WebUI, Cursor, Cline/Kilo в режиме OpenAI Compatible, Aider, JetBrains/ContinueOPENAI_API_KEY / Authorization: Bearer
OpenAI Responseshttps://api.tkbk.online/openai/v1Codex CLI, OpenCode, Cursor (Override OpenAI Base URL)OPENAI_API_KEY

Оба способа передачи ключа работают на всех путях: Authorization: Bearer cr_… или x-api-key: cr_…. Список моделей — GET https://api.tkbk.online/v1/models с ключом или https://tkbk.online/models. Алиасы tkbk-smart, tkbk-fast, tkbk-cheap — шлюз сам выберет доступную модель уровня.

Порядок работы

  1. Узнай инструмент и ОС. Если ключа у пользователя ещё нет — https://tkbk.online/account (пробный ключ после входа) или https://tkbk.online/buy. Сам ключ в чат просить не нужно: пользователь вставляет его в конфиг или переменную окружения.
  2. Проверь связь без ключа: curl -s https://api.tkbk.online/health → {"status":"ok"}.
  3. Пропиши настройки из таблицы ниже. Не ставь одновременно ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN — только второй. На Windows переменные уровня User применяются после перезапуска терминала.
  4. Проверь ключ: node scripts/tkbk-check.mjs (читает TKBK_API_KEY, иначе ANTHROPIC_AUTH_TOKEN, иначе OPENAI_API_KEY; печатает только маску ключа). С --chat отправит одно короткое сообщение модели tkbk-cheap и покажет ответ и расход токенов.
  5. Первый запрос в самом инструменте и проверка расхода в кабинете https://tkbk.online/dashboard/usage.

Настройки по инструментам

Claude Code — переменные окружения или ~/.claude/settings.json:

export ANTHROPIC_BASE_URL="https://api.tkbk.online"
export ANTHROPIC_AUTH_TOKEN="cr_xxx"
export ANTHROPIC_MODEL="claude-sonnet-5"        # опционально
{ "env": { "ANTHROPIC_BASE_URL": "https://api.tkbk.online", "ANTHROPIC_AUTH_TOKEN": "cr_xxx" }, "model": "claude-sonnet-5" }

Windows PowerShell: [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.tkbk.online", "User") и так же для ANTHROPIC_AUTH_TOKEN, затем перезапустить терминал.

Codex CLI — ~/.codex/config.toml (суффикс /openai/v1 обязателен):

model = "gpt-5.6-sol"
model_provider = "tkbk"

[model_providers.tkbk]
name = "TKBK"
base_url = "https://api.tkbk.online/openai/v1"
env_key = "OPENAI_API_KEY"

и export OPENAI_API_KEY="cr_xxx".

Cursor — Settings → Models: включить Override OpenAI Base URL = https://api.tkbk.online/openai/v1, в поле OpenAI API Key вставить cr_xxx, нажать Verify, оставить включёнными только модели из каталога TKBK (добавить кастомную модель по id, например gpt-6.1-sol).

Cline / Kilo Code / Roo — провайдер Anthropic: base URL https://api.tkbk.online, ключ cr_xxx, модель claude-sonnet-5; или провайдер OpenAI Compatible: base URL https://api.tkbk.online/v1, ключ, id модели.

Zed — settings.json → language_models.anthropic.api_url: "https://api.tkbk.online", ключ через ANTHROPIC_API_KEY (у Zed это имя переменной ключа) или в настройках ассистента.

JetBrains / VS Code через Continue — ~/.continue/config.yaml: провайдер anthropic с apiBase: https://api.tkbk.online/v1 и apiKey: cr_xxx; провайдер openai с тем же apiBase для GPT/DeepSeek/GLM.

Aider — OPENAI_API_BASE=https://api.tkbk.online/v1, OPENAI_API_KEY=cr_xxx, модель --model openai/gpt-5.6-sol (префикс openai/ обязателен для совместимого провайдера); для Claude — ANTHROPIC_BASE_URL и --model claude-sonnet-5.

n8n — Credentials → OpenAI API: API Key cr_xxx, Base URL https://api.tkbk.online/v1; в ноде OpenAI / AI Agent выбрать модель по id. Для Anthropic Chat Model — credential Anthropic с Base URL https://api.tkbk.online.

Dify / Open WebUI / LibreChat — провайдер OpenAI-API-compatible: base https://api.tkbk.online/v1, ключ, список моделей — вручную по id.

OpenCode — opencode.json, провайдер @ai-sdk/openai-compatible с baseURL: "https://api.tkbk.online/openai/v1".

Chatbox — Custom Provider: API Host https://api.tkbk.online/openai (путь /v1/chat/completions добавится сам).

NextChat — BASE_URL=https://api.tkbk.online/openai; LobeChat — OPENAI_PROXY_URL=https://api.tkbk.online/openai/v1; список моделей через CUSTOM_MODELS / OPENAI_MODEL_LIST с префиксом +.

SDK

from anthropic import Anthropic
client = Anthropic(base_url="https://api.tkbk.online", api_key=os.environ["TKBK_API_KEY"])

from openai import OpenAI
client = OpenAI(base_url="https://api.tkbk.online/v1", api_key=os.environ["TKBK_API_KEY"])
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ baseURL: "https://api.tkbk.online", apiKey: process.env.TKBK_API_KEY });

curl

curl https://api.tkbk.online/v1/messages -H "Authorization: Bearer $TKBK_API_KEY" -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

MCP-серверы для маркетплейсов и CRM (Wildberries, Ozon, Яндекс Маркет, Авито, Битрикс24, amoCRM) — отдельно: https://tkbk.online/mcp и скилы wb-reviews, ozon-questions, yandex-market-stock, avito-replies, bitrix24-leads, amocrm-followup этого хаба.

Ошибки

СимптомПричинаРешение
401 invalid api keyключ с опечаткой, лишний Bearer в значении переменной, или задан старый ANTHROPIC_API_KEYключ ровно cr_…; убрать лишние переменные; перезапустить терминал
402баланс ключа исчерпанпополнить https://tkbk.online/dashboard/billing
404 model not foundid модели не из каталога или лишний/недостающий /v1 в base URLсверить id с /v1/models; адрес по таблице выше
404 на любой запросв Anthropic-клиент прописан адрес с /v1убрать /v1 из ANTHROPIC_BASE_URL
429дневной лимит ключа или частотаподождать Retry-After; лимит — в кабинете
запросы уходят на api.anthropic.comпеременная не подхваченаecho $ANTHROPIC_BASE_URL, перезапуск
Cursor: Verify красныйне тот адресдолжно быть ровно https://api.tkbk.online/openai/v1

Ссылки

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.