Gemini CLI

Introduction

Gemini CLI is a local coding agent that runs in your terminal. It understands, modifies, and executes against your codebase, and offers both an interactive TUI and scripted (headless) usage. This section explains how to connect the AI models provided by Poixe to Gemini CLI (without changing any of your usage habits; only the authentication and request target address are replaced).

Gemini CLI documentation

Reference for installation, commands, configuration, and usage

Gemini CLI GitHub repository

Source code, releases, and contribution guide

Prerequisites

Make sure you have:

An open terminal or command prompt
A code project to work on (a Git repository is recommended)
An API token that supports the Google Gemini Content protocol (how to create a token)

Also confirm that your machine meets the Gemini CLI runtime requirements (refer to the official documentation for the Node.js version).

Install Gemini CLI

Install globally with NPM (provided by both the official repository and documentation):

npm install -g @google/gemini-cli

Verify the installation:

gemini -v
gemini --help

Configure environment variables

macOS / Linux / WSL
Windows PowerShell

# Route Gemini CLI through the Poixe gateway
export GOOGLE_GEMINI_BASE_URL="https://api.poixe.com"
# Use your Poixe API Key (manage it with your own environment variable approach)
export GEMINI_API_KEY="$POIXE_API_KEY"

# Optional: write to your shell profile to persist (zsh example)
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.poixe.com"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="$POIXE_API_KEY"' >> ~/.zshrc
# Reload the configuration after saving
source ~/.zshrc

setx GOOGLE_GEMINI_BASE_URL "https://api.poixe.com"
setx GEMINI_API_KEY "$env:POIXE_API_KEY"

Initial setup

Start Gemini CLI

gemini

Authenticate for the first time

In the interactive interface, enter:

/auth

Prompt: How would you like to authenticate for this project?Select: Use Gemini API Key

Test the connection

# Type directly in interactive mode
"hi"

# Or run directly in the terminal
gemini "hi"

Get started

Go to your project directory and start it:

cd /path/to/your/project
gemini

You can give it a task directly (then continue with follow-up questions or execution interactively):

gemini "scan this repo, explain what it does, then propose a minimal plan to add a health check endpoint"

Notes

1. Permissions and execution risks

Gemini CLI can read, write, and execute. Use it only in repositories you trust, and approve operations involving deletion, bulk changes, or script execution with caution.

2. Behavior differences under the Poixe gateway

Poixe is a relay layer and makes certain engineering trade-offs in stability, risk control, billing, and tool capabilities. If some capability is unavailable or behaves differently, first consult the relevant sections of Poixe’s compatibility and differences documentation.

FAQ

Q1: It asks me to log in / says I lack permission after starting?

We recommend using the API Key environment variable approach first:

Confirm that GEMINI_API_KEY="$POIXE_API_KEY" is set
Confirm that GOOGLE_GEMINI_BASE_URL="https://api.poixe.com" is set
Restart your terminal so the environment variables take effect

Also, if you previously went through the official login flow, that login state may not match the current gateway target. We recommend switching to the API Key approach.

Q2: Why can't it write to a directory or run certain commands?

This is usually caused by permission/execution policies:

First confirm that the current working directory is writable
For dangerous commands (delete/install/run scripts), review them manually and approve step by step
If necessary, break the task into smaller pieces: have it output a plan and diff first, then decide whether to execute

(Refer to the official documentation for details on permissions and modes.)

Use cases

Chat

Coding

Introduction

Gemini CLI documentation

Gemini CLI GitHub repository

Prerequisites

Install Gemini CLI

Configure environment variables

Initial setup

Get started

Notes

1. Permissions and execution risks

2. Behavior differences under the Poixe gateway

FAQ

​Introduction

Gemini CLI documentation

Gemini CLI GitHub repository

​Prerequisites

​Install Gemini CLI

​Configure environment variables

​Initial setup

​Get started

​Notes

​1. Permissions and execution risks

​2. Behavior differences under the Poixe gateway

​FAQ

Introduction

Prerequisites

Install Gemini CLI

Configure environment variables

Initial setup

Get started

Notes

1. Permissions and execution risks

2. Behavior differences under the Poixe gateway

FAQ