ModelServer — AI model proxy logoModelServer

安装 Claude Code

Claude Code 是 Anthropic 官方的命令行 AI 编程助手。本文教你在终端里把它接到 ModelServer,5 分钟内跑起来,顺带享受国内更稳的访问和多家模型自由切换。macOS、Linux、 Windows 三种系统的步骤都在下面。

安装 CLI

Claude Code 是一个 npm 包,任何系统装法都一样,只需要先有 Node.js ≥ 18。如果你还没装 Node.js,去 nodejs.org 下载 LTS 版本一路 Next 即可。然后在终端跑:

任意系统
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

看到版本号说明 CLI 安装成功了。先**不要**急着跑 claude — 默认它会去连 Anthropic 官方 API,在国内大概率失败。下一步把它指到 ModelServer。

指向 ModelServer

登录 ModelServer 控制台,进入 API Keys 页面创建一把以 sk- 开头的密钥。然后通过**三个**环境变量告诉 Claude Code 走 ModelServer:

  • ANTHROPIC_BASE_URL = https://modelserver.dev
  • ANTHROPIC_AUTH_TOKEN = 你刚才创建的 API Key
  • ANTHROPIC_MODEL = 想用的默认模型 ID,例如 claude-opus-4-6 或 claude-sonnet-4-6
一定要用 ANTHROPIC_AUTH_TOKEN,不要用 ANTHROPIC_API_KEY
这两个变量名长得像但行为完全不同。ANTHROPIC_API_KEY 是 Anthropic 官方密钥专用的,设置它会让 Claude Code 启动时强制走 OAuth 校验、 访问 api.anthropic.com,在国内直接连接失败。第三方代理必须用 ANTHROPIC_AUTH_TOKEN。如果你之前设过 API_KEY,先把它清掉(下面 FAQ 有说怎么清)。

下面分系统讲怎么把这三个变量持久化下来 — 找到你用的系统直接照抄就行。

macOS / Linux

macOS 默认 shell 是 zsh,Linux 多数发行版是 bash。把下面三行写进你的 shell 配置文件 (zsh 用 ~/.zshrc,bash 用 ~/.bashrc), 以后开任何新终端都自动生效:

macOS / Linux (bash · zsh)
echo 'export ANTHROPIC_BASE_URL="https://modelserver.dev"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-opus-4-6"' >> ~/.zshrc

# 让当前窗口立即生效
source ~/.zshrc

# 验证
echo $ANTHROPIC_BASE_URL

如果 echo $ANTHROPIC_BASE_URL 输出 了 modelserver.dev 就成功了。注意复制粘贴时引号一定要是英文半角 ",如果是中文全角 \u201c\u201d 终端会卡在 dquote> 不动。

Windows(图形界面 · 推荐)

Windows 上**强烈推荐**用系统自带的环境变量编辑器,不要折腾命令行 — 既稳又永久, 每次开新窗口自动生效:

  1. 按 Win + R,输入 sysdm.cpl,回车
  2. 切到「高级」选项卡 → 点右下角「环境变量」按钮
  3. 在上半部分「用户变量」区域,点「新建」,依次添加这三个:
    变量名变量值
    ANTHROPIC_BASE_URLhttps://modelserver.dev
    ANTHROPIC_AUTH_TOKENsk-xxxxxxxxxxxx
    ANTHROPIC_MODELclaude-opus-4-6
  4. 三个都加完之后,一路点「确定」保存退出
  5. 关掉所有打开的 PowerShell / CMD / Windows Terminal 窗口(已经 打开的窗口拿不到新变量),再重新打开一个新窗口
  6. 在新窗口里跑 echo $env:ANTHROPIC_BASE_URL, 看到 modelserver.dev 就成功了

Windows(PowerShell 替代)

如果你坚持走命令行,也可以用 PowerShell 写入用户级环境变量(等价于上面 GUI 的效果):

Windows (PowerShell)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://modelserver.dev", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxxxxxxxxx", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-opus-4-6", "User")

# 关掉本窗口,新开一个 PowerShell,验证
echo $env:ANTHROPIC_BASE_URL

验证

三个变量都设好之后,任选一个目录运行下面的命令。如果 Claude 用中文回了一句话, 说明已经全部接通:

terminal
claude "你好,请用一句话介绍你自己"

接下来打开任意代码仓库,试着对 Claude 说「读一下 src/app/page.tsx,告诉我它做了什么」 — 体验真正的命令行式 AI 编程。如果跑不起来,翻一下下面的常见问题。

常见问题

Claude Code Integration — Setup Guide | ModelServer