CLI 中使用

本页整理了原客户端里的 CLI 配置说明，聚焦三个常用工具：Claude Code、Codex、Gemini CLI。如果你已经完成 API 联调，下一步通常就是把命令行工具切到 APIPIG 网关。

推荐路径

  1. 先确认本机已安装 Node.js 18 或更高版本。
  2. 选择目标工具并完成全局安装。
  3. 填写对应环境变量或配置文件。
  4. 重新打开终端后执行版本命令或启动命令验证。

Claude Code

安装

npm install -g @anthropic-ai/claude-code
claude --version

环境变量

Windows
# 临时设置
$env:ANTHROPIC_BASE_URL="https://your-domain.com"
$env:ANTHROPIC_AUTH_TOKEN="你的API密钥"
# 或使用 ANTHROPIC_API_KEY
$env:ANTHROPIC_API_KEY="你的API密钥"

# 永久设置
setx ANTHROPIC_BASE_URL "https://your-domain.com"
setx ANTHROPIC_AUTH_TOKEN "你的API密钥"
setx ANTHROPIC_API_KEY "你的API密钥"

验证

claude

提示

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 两种配置方式都支持，任选其一即可。

Codex

安装

npm install -g @openai/codex
codex --help

环境变量

Windows
setx TAG_OAI_KEY "你的API密钥"

配置文件

路径：~/.codex/config.toml

model_provider = "tag"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.tag]
name = "tag"
base_url = "https://your-domain.com"
wire_api = "responses"
requires_openai_auth = true
env_key = "TAG_OAI_KEY"

路径：~/.codex/auth.json

{
  "OPENAI_API_KEY": null
}

注意

base_url 使用网关根地址，不要再额外拼 /v1/chat/completions。

Gemini CLI

安装

npm install -g @google/gemini-cli
gemini --help

配置文件

路径：~/.gemini/.env

GOOGLE_GEMINI_BASE_URL=https://your-domain.com
GEMINI_API_KEY=你的API密钥
GEMINI_MODEL=gemini-2.5-flash

路径：~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

常见问题

版本命令找不到

  • 确认安装命令执行成功。
  • Windows 建议重开 PowerShell。
  • macOS / Linux 需要重新加载 shell 配置文件。

连不上网关

  • 检查环境变量或配置文件中的域名是否正确。
  • 确认 API Key 仍然有效。
  • 确认没有把完整接口路径误填到 base_url。

需要配置哪些地址

  • Claude Code：ANTHROPIC_BASE_URL=https://your-domain.com
  • Codex：base_url = "https://your-domain.com"
  • Gemini CLI：GOOGLE_GEMINI_BASE_URL=https://your-domain.com

相关页面