Skip to main content
Methods:

​
Refresh Agent Instructions

  • Writes the current Synth agent instructions into AGENTS.md, replacing the stock placeholder text.
  • Lets your Claude automations read the freshest guidance without forcing a model selection.
  • Safe to run anytime you want to broadcast updated practices to your agents.

​
In your terminal, run:

uvx synth-ai claude

​
Launch Claude Code with Synth

  • Verifies the claude binary exists; if not, the command prints install instructions and exits.
  • Builds environment variables so Claude Code hits Synth infrastructure:
    • ANTHROPIC_BASE_URL = https://api.usesynth.ai/synth-research/<model>
    • ANTHROPIC_AUTH_TOKEN = your SYNTH_API_KEY
  • Runs the Claude desktop app in the current process.
  • Always refreshes AGENTS.md first so your workspace opens with the latest agent briefing.

​
In your terminal, run:

uvx synth-ai claude --model synth-small

​
Example usage:

beck@Jacobs-Laptop my-training % uvx synth-ai claude --model synth-medium

Finding your installed Claude Code...
Found Claude Code at /Applications/Claude.app/Contents/MacOS/claude

​
Refresh Credentials

  • Pass --force to skip cached values and pick or enter a new SYNTH_API_KEY. Use this alongside --model whenever credentials change.
  • Handy after key rotation or when switching organizations.

​
In your terminal, run:

uvx synth-ai claude --model synth-medium --force