Перейти к основному содержанию

​
Короткий ответ

Claude Code — это coding agent для разработки. Это не просто чат. Он может читать кодовую базу, редактировать файлы, запускать команды и помогать с задачами разработки из терминала, IDE, desktop app или браузера. Обычный workflow такой: Claude Code читает контекст проекта, планирует задачу, вызывает инструменты, меняет файлы и при необходимости запускает проверки. Он подходит для изменений в нескольких файлах, исправления тестов, code review, скриптов и длинных инженерных задач. Model API отвечает только за inference. Локальные права, доступ к файлам, выполнение команд, hooks и MCP tools по-прежнему контролируются Claude Code и настройками проекта.

​
Когда это важно

  • Вы впервые устанавливаете Claude Code
  • Вы хотите, чтобы Claude Code менял локальный репозиторий
  • Вы не понимаете, почему он читает файлы или расходует много tokens
  • Вы планируете подключить custom API Key и Base URL
  • Вы выбираете между Claude Code, Claude Desktop, Cursor и Codex CLI

​
Ключевые понятия

​
Рекомендуемый workflow

  1. Запускайте Claude Code из реального каталога проекта.
  2. Сначала попросите его прочитать релевантные файлы, а не менять весь проект сразу.
  3. Для сложных задач сначала запросите план.
  4. Давайте менять небольшой набор файлов и запускать быстрые проверки.
  5. Стабильные правила проекта храните в CLAUDE.md; одноразовые инструкции оставляйте в текущем диалоге.
Если вы подключаете Claude Code через API gateway, убедитесь, что endpoint Anthropic-compatible. В этой документации для Claude Code используется https://www.bettertoken.ai. Не используйте OpenAI-compatible https://www.bettertoken.ai/v1 в Anthropic-настройке Claude Code.

​
Частые ошибки

  • Считать Claude Code обычным чатом и забывать, что он может работать с локальными файлами.
  • Ожидать, что он автоматически знает весь репозиторий без чтения файлов и project instructions.
  • Считать MCP model API. MCP добавляет tools; API Key, Base URL и Model ID настраивают inference.
  • Смешивать Claude.ai login, Claude Console API и third-party API gateway.
  • Разрешать широкое выполнение локальных команд без review, tests и ограничений.

​
О BetterToken

Когда Claude Code использует custom API Key и Base URL, model requests можно отправлять через Anthropic-compatible API gateway. BetterToken находится на этом model API layer и помогает управлять API Keys, балансом и usage history. BetterToken не заменяет permissions Claude Code, file access controls, hooks, MCP config или project rules.

​
References