OminiApi 文档

Claude Code

手动配置 Claude Code CLI / VS Code 插件使用 OminiApi

OminiApi TeamCLI 配置约 17 分钟

更省事的方式是用 CC Switch 一键导入。手动配置前请先完成 环境检查。

配置步骤

按 Win + R,输入下面的路径后回车,打开 Claude Code 配置目录:

%USERPROFILE%\.claude

目录里没有 settings.json 的话,手动新建一个,然后写入下方 settings.json 的内容。

把 你的 API Key 换成在控制台 API 密钥 页面创建的 Key。

打开一个新的终端运行 claude,发一句话,能正常回复就说明配置成功。

settings.json

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://omini.ominiapi.top",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
    "DISABLE_AUTOUPDATER": "1",
    "DISABLE_TELEMETRY": "1",
    "DISABLE_BUG_COMMAND": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS": "1"
  },
  "includeCoAuthoredBy": false,
  "language": "Chinese-simplified"
}

最小可用配置

只想先跑通的话,env 里保留 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两项就够了,其余都是推荐项。已经有 settings.json 的,把这些项合并进去,不要整个覆盖。

必填项

配置项说明
ANTHROPIC_BASE_URL固定填 https://omini.ominiapi.top,不要加 /v1
ANTHROPIC_AUTH_TOKEN你的 OminiApi API Key(sk- 开头)

模型设置

Claude Code 在不同场景会调用 Opus / Sonnet / Haiku 三档模型(例如对话用主模型,起标题、压缩上下文用 Haiku 档),三档都填上平台上存在的模型名,可以避免请求到不存在的模型。

配置项推荐值可选
ANTHROPIC_MODELclaude-opus-5-5主模型,启动时默认使用
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5-5claude-opus-5、claude-opus-4-8、claude-opus-4-7、claude-opus-4-6、claude-fable-5-1、claude-fable-5
ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-5-5claude-sonnet-5、claude-sonnet-4-6、claude-sonnet-4-5
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5-20251001—

上表是平台上架的 Claude 模型,你的密钥能用哪些取决于它选的分组,以 模型广场 为准。Claude 系列只能通过 Claude Code 使用的 Messages 接口调用。

推荐的 env 项

环境变量推荐值作用
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"1"关闭非必要网络请求
CLAUDE_CODE_DISABLE_TERMINAL_TITLE"1"不修改终端标题
DISABLE_AUTOUPDATER"1"关闭自动更新,需要时手动 claude update
DISABLE_TELEMETRY"1"关闭遥测上报
DISABLE_BUG_COMMAND"1"禁用内置 bug 反馈命令
DISABLE_ERROR_REPORTING"1"关闭错误自动上报
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS"1"不把 git 状态塞进系统提示词,缓存更稳定、更省钱,原因见 常见问题
CLAUDE_CODE_DISABLE_1M_CONTEXT"1"可选,切回 200K 上下文

其它顶层配置

配置项推荐值作用
includeCoAuthoredByfalse提交信息里不自动附加 Claude 共同作者标记
language"Chinese-simplified"界面和回复偏向简体中文

切换模型

  • 会话里输入 /model,选 Opus / Sonnet / Haiku 档,或直接输入模型名,例如 /model claude-sonnet-5-5;
  • 启动时指定:claude --model claude-sonnet-5-5;
  • 长期更换:改 settings.json 里的 ANTHROPIC_MODEL 后重开终端。

除了 Claude 系列,deepseek-v4-pro、kimi-k3、gemini-3.8-flash 等支持 Messages 接口的模型也可以填进上面的模型项,在 Claude Code 里使用(前提是你的密钥分组包含它们)。

VS Code 插件

先按上面的步骤配好 settings.json,并确认终端里 claude 能正常对话。

在 VS Code 扩展中心搜索 Claude Code 安装 Anthropic 官方插件。

在 Claude Code 配置目录(%USERPROFILE%\.claude 或 ~/.claude)里新建或编辑 config.json:

~/.claude/config.json
{
  "primaryApiKey": "OminiApi"
}

这里的值随便填一个非空字符串即可,作用是让插件跳过 Anthropic 账号登录,实际使用的 Key 仍然来自 settings.json。

重启 VS Code,打开 Claude Code 插件发一句话测试。

遇到问题

启动要求登录、401、模型不存在、账单里出现别的模型等问题,见 Claude Code 常见问题。

本页目录