Maru Code 接入指南
编程 Agent

Claude Code

在 Claude Code（终端 / VS Code 插件）中使用 Maru Code

使用哪个分组的密钥？

使用 Anthropic 分组 的密钥。Base URL 填 https://api.muteki.site，不要带 /v1。

安装 Claude Code

在 PowerShell 中运行：

irm https://claude.ai/install.ps1 | iex

也可以用 WinGet：winget install Anthropic.ClaudeCode（这种方式不会自动更新）。

已经装了 Node.js 的话，也可以用 npm 安装：npm install -g @anthropic-ai/claude-code。

安装完成后运行 claude --version 确认安装成功。

配置

编辑用户级配置文件，没有就新建：

系统路径
Windows%USERPROFILE%\.claude\settings.json
macOS / Linux~/.claude/settings.json

写入以下内容（已有其他配置的话，把 env 里的三项合并进去）：

settings.json
{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.muteki.site",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

配置文件对所有终端窗口永久生效，并且优先级高于环境变量。

密钥不要写进项目目录

项目里的 .claude/settings.json 通常会提交到 Git 仓库。密钥只写在用户目录下的 ~/.claude/settings.json。

各配置项的含义

配置项说明
ANTHROPIC_BASE_URL网关地址，不带 /v1
ANTHROPIC_AUTH_TOKEN你的密钥，以 Authorization: Bearer 方式发送
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关闭遥测、错误上报等非必要请求。同时会关闭自动更新，需要时手动运行 claude update

请用 ANTHROPIC_AUTH_TOKEN，不要用 ANTHROPIC_API_KEY。后者在交互模式下需要手动确认一次，拒绝过一次就会被静默忽略。

启动并验证

在项目目录下运行 claude，然后输入 /status，确认 Anthropic base URL 显示的是 https://api.muteki.site，再随便问一句测试即可。

指定模型（可选）

默认不需要配置模型，Claude Code 会自动使用 Opus / Sonnet / Haiku。在会话中可以用 /model 切换。

如果想固定使用某个模型，在 env 里加上（模型名以模型广场为准）：

"ANTHROPIC_MODEL": "claude-sonnet-5-5"

想按档位分别指定，可以用 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL（Haiku 档位也用于后台小任务）。

新模型需要较新版本的 Claude Code 才能识别，用不了新模型时先运行 claude update。

VS Code 插件

Claude Code 的 VS Code 插件与终端版共用 ~/.claude/settings.json，但插件自身的登录检查不读取这个文件。为了避免插件弹出登录，建议在 VS Code 的用户设置（Ctrl/Cmd + Shift + P → Preferences: Open User Settings (JSON)）中再加上：

VS Code settings.json
{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.muteki.site" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的密钥" }
  ]
}

修改后重新加载 VS Code 窗口。

使用限制

通过网关使用时，Remote Control、语音输入等依赖 Anthropic 官方账号的功能不可用。

接口地址与协议

Base URL 带不带 /v1、支持哪些协议、怎么测试连通性

Codex

在 Codex CLI 和 Codex IDE 插件中使用 Maru Code

本页目录

安装 Claude Code配置各配置项的含义启动并验证指定模型（可选）VS Code 插件使用限制