К основному содержанию
команда CX Codex

setup · fcakyon — команда для Claude Code: что делает и как установить

Команда setup настраивает ключ API для MCP-сервера Tavily в Claude Code и сохраняет его в конфигурационном файле плагина.

Apache-2.0 ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install tavily-tools@claude-settings
Открыть на GitHub

Что делает setup

Команда проверяет файл ${CLAUDE_PLUGIN_ROOT}/.mcp.json. Если в поле tavily.env.TAVILY_API_KEY всё ещё стоит плейсхолдер REPLACE_WITH_TAVILY_API_KEY, сценарий запрашивает ключ у пользователя через интерфейс AskUserQuestion. Если ключ уже начинается с префикса tvly-, инструмент сообщает, что настройка уже выполнена.

Перед записью введённый ключ проходит валидацию: длина должна быть не менее 20 символов с обязательным префиксом tvly-. Затем создаётся резервная копия ${CLAUDE_PLUGIN_ROOT}/.mcp.json.backup, и только после этого обновляется основной конфиг.

Без перезапуска Claude Code новые параметры не вступят в силу. После завершения работы команды нужно выйти из сессии, запустить claude снова и проверить статус сервера через /mcp.

Какие задачи решает

  • подключить Tavily MCP к Claude Code без ручного редактирования JSON
  • проверить формат и длину ключа Tavily перед сохранением в конфиг
  • создать резервную копию конфигурации .mcp.json перед изменением параметров

Примеры запросов агенту

  • /tavily-tools:setup
  • Запусти команду /tavily-tools:setup, чтобы настроить ключ для поиска Tavily

Как установить setup

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install tavily-tools@claude-settings

2Вручную: положить файлы

.claude/commands/setup.md

Вызов — /setup. Для всех проектов — ~/.claude/commands/

Вопросы о setup

Как установить setup в Claude Code?

Выполните обе команды маркетплейса по порядку: /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install tavily-tools@claude-settings.

Что делает команда setup?

Она проверяет статус Tavily MCP, запрашивает и валидирует API-ключ, делает бэкап .mcp.json и прописывает значение в конфигурацию.

Почему после сохранения ключа поиск Tavily не начинает работать сразу?

Claude Code считывает переменные окружения MCP только при запуске. Нужно полностью перезапустить сессию claude и проверить подключение через /mcp.

Исходный текст

setup.md · Apache-2.0
---
description: Configure Tavily MCP server credentials
---

# Tavily Tools Setup

**Source:** [tavily-ai/tavily-mcp](https://github.com/tavily-ai/tavily-mcp)

Configure the Tavily MCP server with your API key.

## Step 1: Check Current Status

Read the MCP configuration from `${CLAUDE_PLUGIN_ROOT}/.mcp.json`.

Check if Tavily is configured:

- If `tavily.env.TAVILY_API_KEY` contains `REPLACE_WITH_TAVILY_API_KEY`, it needs configuration
- If it contains a value starting with `tvly-`, already configured

Report status:

- "Tavily MCP is not configured - needs an API key"
- OR "Tavily MCP is already configured"

## Step 2: Show Setup Guide

Tell the user:

```
To configure Tavily MCP, you need a Tavily API key.

Quick steps:
1. Go to app.tavily.com and sign in
2. Navigate to API Keys
3. Create a new API key
4. Copy the key (starts with tvly-)

Free tier: 1,000 searches/month

Don't need Tavily MCP? Disable it via /mcp command.
```

## Step 3: Ask for Key

Use AskUserQuestion:

- question: "Do you have your Tavily API key ready?"
- header: "Tavily Key"
- options:
  - label: "Yes, I have it"
    description: "I have my Tavily API key ready to paste"
  - label: "No, skip for now"
    description: "I'll configure it later"

If user selects "No, skip for now":

- Tell them they can run `/tavily-tools:setup` again when ready
- Remind them they can disable Tavily MCP via `/mcp` if not needed
- Exit

If user selects "Yes" or provides key via "Other":

- If they provided key in "Other" response, use that
- Otherwise, ask them to paste the key

## Step 4: Validate Key

Validate the provided key:

- Must start with `tvly-`
- Must be at least 20 characters

If invalid:

- Show error: "Invalid key format. Tavily keys start with 'tvly-'"
- Ask if they want to try again or skip

## Step 5: Update Configuration

1. Read current `${CLAUDE_PLUGIN_ROOT}/.mcp.json`
2. Create backup at `${CLAUDE_PLUGIN_ROOT}/.mcp.json.backup`
3. Update `tavily.env.TAVILY_API_KEY` value to the actual key
4. Write updated configuration back to `${CLAUDE_PLUGIN_ROOT}/.mcp.json`

## Step 6: Confirm Success

Tell the user:

```
Tavily MCP configured successfully!

IMPORTANT: Restart Claude Code for changes to take effect.
- Exit Claude Code
- Run `claude` again

To verify after restart, run /mcp and check that 'tavily' server is connected.
```

© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →

Сначала — setup от других авторов.

setup официальный Anthropic Команда setup настройки для Claude Code, проводящая администратора через подключение надстройки Claude Office к облачной инфраструктуре. CX Codex +1 ★ 41 441звёзд репо setup Pranay Yadav Команда setup инициализирует ShipMate в текущем проекте: создаёт каталоги для историй и состояния, затем сканирует кодовую базу. CX Codex +1 ★ 42 780звёзд репо setup Seth Hobson Команда setup инициализирует контекст проекта Conductor через пошаговый опрос и создаёт базовую документацию: стек, требования к продукту, правила кодстайла и рабочий процесс. CX Codex +1 ★ 42 780звёзд репо setup Composio Команда setup настраивает плагин connect-apps от Composio, чтобы Claude Code мог выполнять действия во внешних сервисах вроде Gmail, Slack и GitHub. CX Codex +1 ★ 2 003звёзд репо setup-api-key calesthio Скилл setup-api-key автоматически проверяет, настроен ли ключ ElevenLabs, и проводит пользователя через получение и сохранение нового ключа, если его нет или он не работает. CX Codex +1 1 200установок dd-account-setup datadog-labs Скилл dd-account-setup для Claude Code подключает Datadog и проверяет ключи API и регион. Запускается перед настройкой или инструментированием Datadog, а также при ошибке 403 из-за неверного региона. CX Codex +1 113установок fetcher fetcher-sh Общий скилл оплаты и настройки для fetcher.sh: ключи API, кредиты, микроплатежи x402 и подключение MCP-сервера. Нужен до или вместе с сервисными скиллами. CX Codex +1 4 700установок web-search 101-skills Скилл web-search для Claude Code даёт агенту веб-поиск и извлечение текста через Tavily и Exa. Агент использует его для ресёрча, проверки фактов и RAG-пайплайнов. CX Codex +1 130 800установок tavily-search tavily-ai Скилл tavily-search для Claude Code, который подключает поиск по интернету и извлечение данных с веб-страниц. Используется для проверки фактов, чтения актуальных новостей и сбора информации вне обучающей выборки. CX Codex +1 39 400установок tavily-best-practices tavily-ai Скилл tavily-best-practices даёт агенту справку по интеграции Tavily для поиска, извлечения контента, обхода сайтов и исследований. Нужен при добавлении веб-данных в агентный сценарий или RAG. CX Codex +1 21 100установок

Из того же набора113

Весь набор →
list-performance-item-memo Правило list-performance-item-memo для строк списка в React: отдавать в элемент отдельные примитивы вместо объекта целиком, чтобы memo() сравнивал props и не перерисовывал строку без изменений. CX Codex +1 ★ 1 216звёзд репо react-state-dispatcher Правило react-state-dispatcher требует передавать колбэк-апдейтер в setState, когда новое значение зависит от текущего. Защищает от устаревших замыканий и лишних перерисовок. CX Codex +1 ★ 1 216звёзд репо setup Скилл setup для Claude Code разворачивает интеграционные тесты и пользовательские сценарии тестирования в проекте. Включается при запросах настроить сквозное тестирование или добавить QA-сценарии. CX Codex +1 ★ 1 216звёзд репо list-performance-inline-objects Правило list-performance-inline-objects запрещает создавать объекты внутри renderItem для передачи в пропсы. Встроенные объекты создают новые ссылки на каждом рендере и ломают мемоизацию. CX Codex +1 ★ 1 216звёзд репо bundle-analyzable-paths Правило bundle-analyzable-paths просит оставлять пути импортов и файлов понятными для статического анализа. Это помогает не расширять сборку и трассировку файлов без необходимости. CX Codex +1 ★ 1 216звёзд репо list-performance-item-expensive Правило list-performance-item-expensive запрещает тяжёлые элементы списка: запросы данных, лишние хуки и обращения к React Context прямо в renderItem. CX Codex +1 ★ 1 216звёзд репо ui-image-gallery Правило ui-image-gallery задаёт стандарты для мобильных галерей: заставляет ИИ использовать библиотеку @nandorojo/galeria вместо самодельных модальных окон на Modal. CX Codex +1 ★ 1 216звёзд репо rendering-resource-hints Правило rendering-resource-hints учит агента вставлять в React-компоненты вызовы API React DOM для подсказок браузеру о ресурсах. Встраивается в серверные компоненты, чтобы загрузка файлов стартовала раньше, чем клиент получит HTML. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой