Skip to main content
TogetherLink is currently in beta. Commands, routing behavior, and the available model list may change. Report issues or give feedback on GitHub.
TogetherLink connects your existing coding tools and desktop apps to models hosted by Together AI. Launch an app through TogetherLink, and it configures the connection for you. By default, sessions use the auto router, which sends straightforward requests to Together AI models and more difficult requests to Claude Opus. When the session ends, your normal configuration is untouched.

​
Requirements

  • A Together AI API key.
  • The coding tool or desktop app you want to use, already installed.
  • Bash and curl to run the installer. On Linux, installing Bun also requires unzip.
  • macOS for the Claude Desktop and ChatGPT Desktop integrations.
  • Optional: an Anthropic API key. The auto router uses it to send difficult requests to Claude Opus, billed to the Anthropic account behind the key. Without one, every request is served by a Together AI model.

​
Get started

Install TogetherLink:
The installer also installs Bun if needed. Follow any PATH instructions printed at the end of installation. Open the interactive launcher:
The tlink alias runs the same command. Choose the tool to launch: Claude Code, Claude Desktop, ChatGPT Desktop, or Codex. If no Together API key is configured, the launcher prompts you for one. Arguments after the tool name pass through to the harness. For example, togetherlink claude -p "hello" runs Claude Code in print mode. Every session starts with a routing banner, such as togetherlink ▸ Claude Code → Auto router., so you can confirm which route is serving the session. You can also launch an app directly:

​
Configure your API key

Save your Together API key:
TogetherLink validates the key before saving it. You can also provide the key through your shell environment:
Configuration optionally asks for an Anthropic API key for auto router sessions. Skip it to use Together AI models only.
To override the stored key for a single run, pass --api-key <YOUR_KEY> before the tool name.

​
How the auto router works

Sessions use the virtual auto model by default. For each request, TogetherLink’s cloud gateway classifies the prompt and routes it to the model best suited to handle it:
  • Straightforward requests: Served by Together AI models such as GLM 5.3, billed at standard serverless rates.
  • More difficult requests: Served by Claude Opus through Anthropic, billed to the Anthropic account behind your ANTHROPIC_API_KEY.
Without an Anthropic API key configured, every request is served by a Together AI model.

​
Choose a model

List available models, context limits, and pricing:
To pin a session to a single model instead of the auto router, use the full togetherlink command and pass --main with the model ID before the tool name:
Always select a model with the full togetherlink command, with the flag before the tool name. TogetherLink refuses a --model flag placed after the tool name, because the model aliases in some harnesses don’t select gateway routes. The tclaude shortcut expands with the tool name first, so it can’t be used to select a model.
TogetherLink currently offers these models: You can also switch models during a session with your harness’s /model command. The menu maps the harness’s model tiers to Together AI models. In Claude Code, Opus runs Kimi K3, Fable runs GLM 5.3, Sonnet runs GLM 5.3 Flash, and Haiku runs DeepSeek V4.1 Flash. Desktop apps expose their own model menus, which can differ from the terminal tools. Usage on Together AI models is billed at standard serverless rates for the model that serves each request. See serverless models for current pricing.

​
How it works

TogetherLink configures each app to connect directly to its hosted gateway, which serves each request from a Together AI model or from Anthropic based on the selected route. Your normal configuration files remain unchanged.
  • Claude Code and Codex CLI: Receive launch-specific configuration for each session.
  • Claude Desktop and Cowork: Use a persistent TogetherLink-owned third-party profile, with backups for reversible setup.
  • ChatGPT Desktop: Uses a dedicated profile at ~/.codex-togetherlink. TogetherLink reads but never rewrites your normal ~/.codex home.
Desktop profiles store your Together API key locally.

​
Claude Desktop and Cowork

Enable the integration:
This configures Claude Desktop, Cowork, and Code to use Together AI models. If Claude is running, TogetherLink asks before quitting and restarting it. Switch back to official Claude while keeping your TogetherLink profile available:
Remove the TogetherLink profile and its imported copies:
Reset requires confirmation.

​
ChatGPT Desktop

Launch ChatGPT Desktop with your TogetherLink profile:
Native web search is disabled in the TogetherLink profile. Switch back to your normal profile:
Delete the TogetherLink profile, including its local tasks and settings:
Reset requires confirmation. Your normal ~/.codex home remains untouched.

​
Codex CLI

Launch Codex in your terminal:
Native arguments pass through to Codex:

​
Run headless

TogetherLink works in non-interactive contexts, so scripts and agents can drive a harness. Run it in print mode:
Always append < /dev/null to headless runs. A headless process that inherits an open stdin blocks indefinitely waiting for additional input.

​
Generate images

Sessions launched through TogetherLink include an image generation skill. Ask for an image, and your agent generates or edits it with image models hosted by Together AI:
Image spend appears in togetherlink usage, tracked separately from token usage.

​
View usage

Each session prints a cost summary when it exits. To see spend tracked by the cloud gateway across sessions, run:
TogetherLink periodically checks for updates. You can also update manually:

​
Troubleshooting

  • No API key configured: Run togetherlink configure or export TOGETHER_API_KEY.
  • Claude Code is not installed: TogetherLink does not install Claude Code. Install it with the command printed in the error, then retry.
  • A headless run hangs: Append < /dev/null to close stdin.
  • Restore your original setup: Stop using togetherlink and launch your tool directly. TogetherLink never modifies your normal configuration files.

TogetherLink on GitHub

Source code, issues, and release history.

Together AI models

Browse every model hosted on Together AI.