coding-gateway is a lightweight launcher for running Codex, Claude Code, and Gemini CLI through Databricks.
- Python 3.12+ — install with
uv(uv.astral.sh) npmif tool CLIs need to be installed automatically
uv tool install git+https://github.com/databricks/coding-gatewaycoding-gateway configureEnter your Databricks workspace URL. coding-gateway automatically detects whether Databricks AI Gateway is available and configures tool endpoints accordingly.
This writes managed config files for all three tools (~/.codex/config.toml, ~/.claude/settings.json, ~/.gemini/.env).
coding-gateway configure mcpAdd Databricks MCP servers to Claude Code. Supported server types:
- External — e.g. confluence-mcp, jira-mcp
- UC Functions — Unity Catalog AI functions
- Genie — AI/BI dashboards
- Custom — any MCP server URL
You will be prompted for OAuth credentials (client ID and secret) that are reused for all servers added in the session.
coding-gateway # launches Codex (default)
coding-gateway --tool claude
coding-gateway --tool geminiYou can override the model at launch time:
coding-gateway --tool claude --model databricks-claude-opus-4-7
coding-gateway --tool gemini --model databricks-gemini-2-5-pro| Command | Description |
|---|---|
coding-gateway status |
Show current workspace, base URLs, managed config files, and selected models |
coding-gateway usage |
Show AI Gateway usage summary |
coding-gateway logout |
Clear saved state and restore backed-up config files |
coding-gateway configure --dry-run |
Preview config files without writing them |
coding-gateway usageRequires Databricks AI Gateway. Queries system.ai_gateway.usage and shows:
- Token totals for today, last 7 days, and last 30 days
- Active tools and top models this week
- 7-day breakdown per tool (Codex, Claude Code, Gemini CLI)
coding-gateway manages these files:
| File | Tool |
|---|---|
~/.codex/config.toml |
Codex |
~/.claude/settings.json |
Claude Code |
~/.gemini/.env |
Gemini CLI |
Existing files are backed up before being overwritten. coding-gateway logout restores backups.
- Databricks authentication uses OAuth via
databricks auth login - Codex and Claude use a Databricks token helper (no fixed token stored)
- Gemini refreshes its bearer token automatically while running through
coding-gateway
- Databricks AI Gateway overview
- Databricks AI Gateway coding agent integration
- Databricks CLI authentication
- Monitor AI Gateway usage
Contributions are welcome. Fork the repo, create a feature branch, and open a pull request against main.
Please report security vulnerabilities to security@databricks.com rather than opening a public issue.
See LICENSE.md and NOTICE.md.