在 Claude Code 中使用 OminiGate

概览

Claude Code 是 Anthropic 推出的 AI 编码助手 —— 一款能够读取代码库、跨文件编辑、执行命令、与开发者工具协同的 Agentic 编码工具。它同时支持终端、VS Code / JetBrains IDE、桌面应用和浏览器，底层都走同一套 Anthropic Messages API。

所有平台都识别 ANTHROPIC_BASE_URL 环境变量，任何暴露 Anthropic 兼容 /v1/messages 端点的网关都可以替换 api.anthropic.com。OminiGate 提供的正是这个端点 —— 指向我们后 Claude Code 即刻可用。

• 真正的 drop-in 替换 —— 无需修改配置文件、无需重新编译。
• 覆盖所有 Claude 模型以及经由 OminiGate 路由的第三方模型。
• 一个 API Key，一个余额池，统一的用量面板。

前置条件

开始之前，请确保已安装 Claude Code 并拥有一把 OminiGate API Key。

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

配置 Claude Code

官方 LLM Gateway 文档只要求两个必填值：ANTHROPIC_BASE_URL（端点）和 ANTHROPIC_AUTH_TOKEN（Bearer Token）。可以写进 Claude Code 自己的配置文件，也可以临时 export 到 shell，按你的习惯选。

unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

方式一 —— settings.json（推荐）

把配置写进 Claude Code 自己的 settings 文件。不污染 shell、开新终端也有效，是官方 llm-gateway 指南推荐的持久化写法。API_TIMEOUT_MS（毫秒）防止长时间 Agent 循环触发默认超时；CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 关闭遥测等非核心请求。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ominigate.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-omg-your-api-key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

文件不存在时自己新建即可。Claude Code 启动时会读取 ~/.claude/settings.json —— 不需要重启其它 shell。

"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5"

方式二 —— 在当前 shell export

最快的临时写法。变量只对当前终端生效，其它地方的 Claude Code 配置不受影响。

export ANTHROPIC_BASE_URL="https://api.ominigate.ai"
export ANTHROPIC_AUTH_TOKEN="sk-omg-your-api-key"

claude

想让它在每个新 shell 都生效，就把这两行 export 写进 ~/.zshrc 或 ~/.bashrc。

验证配置

1. 先看 TUI 状态

在任意目录启动 claude，然后在 TUI 里依次敲 /status 和 /model。这是确认 Claude Code 是否真正读到你配置的最快办法 —— 一眼就能看出 env var 还是 settings.json 生效了。

/status   # expect ANTHROPIC_BASE_URL pointing at api.ominigate.ai
/model    # expect an anthropic/... slug

2. 跑一个真实任务

启动时带 --model，或者在会话里用 /model 切换。不需要设 ANTHROPIC_MODEL 环境变量。

# One-shot with an explicit model
claude --model anthropic/claude-opus-4.6 "Write a hello world in Rust"

# Or inside an existing session
> /model anthropic/claude-sonnet-4.6

用量会在数秒内出现在 OminiGate Dashboard 中。如果 Usage 没有记录，请再次检查 ANTHROPIC_BASE_URL 以及你选的 slug 是不是 OminiGate 能识别的。

推荐模型

Claude Code 采用 Anthropic Messages 协议，因此 Anthropic 模型兼容性最好。任何支持 Messages 格式的模型都可以调用。

完整模型列表： /models.

常见问题