# TogetherLink > Run Together AI models in Claude Code and Claude Desktop through the hosted TogetherLink gateway. TogetherLink is a private-beta, self-updating CLI. The public CLI currently supports Claude Code and, on macOS, Claude Desktop/Cowork. It does not install or run a local inference proxy, daemon, listener, or background service. Terminal Codex, ChatGPT Desktop, OpenCode, DeepSeek Harness, Grok, Hermes, Pi, and Prime integrations are not part of the current public CLI. - Website: https://togetherlink.dev - Installer: https://install.togetherlink.dev - Current version manifest: https://gateway.togetherlink.dev/latest.json - This guide: https://togetherlink.dev/llms.txt ## Install Run the Bash installer: ```bash curl -fsSL https://install.togetherlink.dev/install | bash ``` The installer downloads the TogetherLink bundle to `~/.togetherlink/bin/`, installs Bun when needed, and creates these commands: - `togetherlink` - `tclaude` - `tclaude-desktop` Verify the installation with: ```bash togetherlink --version ``` If the command is not available in the current shell, open a new shell or load the startup file the installer updated (`source ~/.zshrc` for Zsh, `source ~/.bashrc` for Bash), then retry. TogetherLink does not install Claude Code or Claude Desktop. If either is missing, the CLI prints the official installation or download instructions and exits. ## Configure Create a Together API key at https://api.together.ai/settings/api-keys, then run: ```bash togetherlink configure ``` TogetherLink validates the key before saving it locally. An optional Anthropic API key enables the Claude-backed complex route in Auto; without it, Auto remains on Together-hosted models. You may provide the Together key for a single invocation instead of saving it: ```bash TOGETHER_API_KEY="..." tclaude ``` Do not put API keys in prompts, repositories, scripts, or command history. ## Commands ```text togetherlink open the interactive launcher togetherlink configure configure API keys togetherlink usage [--last 7d] show gateway-recorded usage and spend togetherlink models show models, context, and pricing togetherlink update update immediately togetherlink --version show the installed version togetherlink claude [...] launch Claude Code tclaude [...] convenience alias for Claude Code togetherlink claude-desktop enable Claude Desktop/Cowork on macOS togetherlink claude-desktop off restore the previous Desktop profile tclaude-desktop convenience alias for Desktop setup ``` Arguments after `claude` are passed to Claude Code. For a one-shot headless task: ```bash tclaude -p "Explain this repository" --output-format json < /dev/null ``` Select a Together model with the TogetherLink flag before the `claude` subcommand: ```bash togetherlink --main zai-org/GLM-5.3-Flash claude -p "Run the tests" < /dev/null ``` Claude's own `--model` flag selects a Claude picker tier; it is not the TogetherLink model selector. ## Models The public Claude experience exposes Auto plus four Claude picker mappings: | Claude selection | Routed model | | --- | --- | | Default / Auto | TogetherLink Auto | | Opus 5 | `moonshotai/Kimi-K3` | | Fable 5.1 | `zai-org/GLM-5.3-Flash` | | Sonnet 5 | `zai-org/GLM-5.3` | | Haiku 4.5 | `deepseek-ai/DeepSeek-V4.1-Flash` | Auto classifies each request. With a configured Anthropic key it may route complex work to Claude Opus 5; otherwise it uses Together-hosted models. Utility requests such as compaction and token counting stay on Together-hosted models. Use `togetherlink models` for the current catalog, limits, and prices. Do not rely on copied model prices for billing-critical decisions because provider pricing can change. Qwen 3.8 is an experimental explicit opt-in and is not part of the default picker or supported customer path. ## Claude Desktop and Cowork Claude Desktop support is beta and macOS-only. Claude Desktop must already be installed in `/Applications` or `~/Applications`. ```bash togetherlink claude-desktop ``` TogetherLink creates one reversible third-party profile, connects it directly to the hosted gateway, and keeps a backup of the previous configuration. It does not start a local proxy or daemon. The profile stores the Together API key locally in a user-only file and permits Cowork tools to reach arbitrary network hosts. Restore the previous profile with: ```bash togetherlink claude-desktop off ``` ## Architecture and data handling ```text Claude Code or Claude Desktop -> gateway.togetherlink.dev -> TogetherLink credential edge -> LiteLLM translation and routing -> Together AI, or Anthropic for an authorized Auto route ``` The caller's Together key authenticates the gateway. TogetherLink derives an internal identity and uses a short-lived provider-credential handle after routing; raw provider keys are not written into LiteLLM request bodies or its Postgres database. The gateway records usage and spend in Postgres. Current operator tracing also stores request prompts and responses, with no automatic retention cutoff. Do not send secrets or regulated/customer data unless your organization has approved this beta's data handling. ## Troubleshooting - `togetherlink: command not found`: open a new shell or source the startup file updated by the installer. - Claude Code is missing: install it from https://code.claude.com/docs/en/quickstart, then retry. - Claude Desktop is missing: install it from https://claude.com/download, then retry. - Together key is missing or rejected: run `togetherlink configure` and use a current key from Together AI. - Gateway preflight fails: retry after checking https://gateway.togetherlink.dev/healthz; the CLI deliberately stops before launching Claude when the authenticated catalog is unavailable. - To leave the Desktop beta: run `togetherlink claude-desktop off`. TogetherLink is a beta. Report failures with the TogetherLink version, Claude version, selected model, UTC time, and the safe request/session ID shown by the CLI. Never include API keys or full sensitive prompts in a report.