vertex

One-click AI agent setup through Google Vertex AI Platform. Currently, this launches Claude Code using your Google login¹ configured to use the Claude Sonnet 4.5 model.

Usage

macOS

1. Install Nix using these instructions
2. Run vertex:

nix run github:juspay/vertex

Tip

If you are a Nix veteran, nixos-unified-template is the best way to install vertex. The template already includes vertex (be sure to enable the "work" profile) and is configured to use the latest versions of tools. Once you setup your Nix config, run vertex-claude to launch it.

NixOS

To use this on NixOS, add the following to your flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    vertex = {
      url = "github:juspay/vertex";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { nixpkgs, vertex, ... }: {
    # Your NixOS configuration
    nixosConfigurations.your-hostname = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux"; # or your system
      modules = [
        # Your existing modules
        {
          environment.systemPackages = [
            vertex.packages.x86_64-linux.default # or your system
          ];
        }
      ];
    };
  };
}

Then run sudo nixos-rebuild switch and use vertex-claude command.

Editor support

Zed

Zed supports Claude Code. To have it use our vertex-claude:

• First, sucessfully run vertex-claude using the instructions above
• Export these environment variables in a terminal:

  export ANTHROPIC_VERTEX_PROJECT_ID=dev-ai-gamma  # Or, your project.
  export CLAUDE_CODE_USE_VERTEX=1
  

• Open Zed from the same terminal (important!). On macOS, you can run open -a Zed.

What vertex-claude does

Running vertex-claude (or the nix run ... command above) launches Claude Code after authenticating using your Google account. You can pass custom arguments to it; for example:

vertex-claude --dangerously-skip-permissions

# Or
nix run github:juspay/vertex -- --dangerously-skip-permissions

Note

When you run vertex-claude, it will automatically:

• Use your only project if you have exactly one
• Let you choose interactively if you have multiple projects

Tip

Google authentication / permission issues? Reset your gcloud config (rm -rf ~/.config/gcloud) and try again.

Goals

Combine google-cloud-sdk, gemini-cli, claude-code (from nixpkgs) to provide a seamless entrypoint to getting AI agents working using Claude Sonnet 4.5 through Google Vertex AI platform (provided by your organization).

Footnotes

1. See Claude Code on Google Vertex AI ↩