What is Claude Code?
Claude Code is Anthropic’s agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster through natural language commands. It serves as an intelligent pair programming partner that can read, analyze, and work with your entire project structure.Model Configuration
Claude Code supports model aliases (opus
, sonnet
, haiku
, opusplan
) that provide convenient shortcuts for different use cases. When integrating with TrueFoundry, you can configure these aliases to use your specific TrueFoundry models through environment variables.
Model aliases allow you to switch between different Claude models during your coding session using simple commands like
/model opus
or /model sonnet
.Prerequisites
Before integrating Claude Code with TrueFoundry, ensure you have:- TrueFoundry Account: Create a Truefoundry account with atleast one model provider and generate a Personal Access Token by following the instructions in Generating Tokens
- Claude Code Installation: Install Claude Code following the official documentation
- Configure models in Truefoundry for each provider you want to use
Integrate Truefoundry with Claude Code
Claude Code uses a settings.json file for configuration. You’ll need to modify the environment variables to route requests through Truefoundry. First, get the base URL and model name from your TrueFoundry AI Gateway playground using the unified code snippet (ensure you use the same model name as written):
Get Base URL and Model Name from Unified Code Snippet
- Global:
~/.claude/settings.json
- Project-specific:
.claude/settings.json
in your project directory
your-truefoundry-api-key
with your TrueFoundry API keycontrolPlaneUrl
with your Control Plane URLprojectId
with your Google Project Idregion
with Region of the Model- Update the model name to match your configured TrueFoundry models
Model Alias Configuration
The following environment variables map Claude Code’s built-in aliases to your TrueFoundry models:ANTHROPIC_DEFAULT_OPUS_MODEL
: Mapsopus
alias to your TrueFoundry Opus modelANTHROPIC_DEFAULT_SONNET_MODEL
: Mapssonnet
alias to your TrueFoundry Sonnet modelANTHROPIC_DEFAULT_HAIKU_MODEL
: Mapshaiku
alias to your TrueFoundry Haiku model
/model opus
or /model sonnet
, and optimized workflows by choosing the right model for each task.