① 安装 Node.js
最省心、零前置:直接去 Node.js 官网 下对应系统的安装包(macOS 的 .pkg / Windows 的 .msi),双击安装,不需要任何其他工具。下面的命令行方式更快,但各自有前置(见每条备注)。装好后用 node -v 验证。
macOS · Homebrew
brew install node
前置:需已装 Homebrew。没有就用上面的官网 .pkg(最省事),或先装 brew(见 brew.sh,需能访问 GitHub)。
Windows · winget
winget install OpenJS.NodeJS.LTS
前置:Win10 1709+/Win11 自带 winget。没有就从 Microsoft Store 装「应用安装程序」,或直接用官网 .msi。
Linux · Debian / Ubuntu
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs
基本无前置(系统自带 curl / apt)。其他发行版见官网下载页。
验证
node -v && npm -v
② Claude Code
装好后把端点指向你的网关。把 <BASE_URL> 和 <API_KEY> 换成实际值。
一键脚本 · zsh
# 1) 安装(需 Node.js ≥ 18) npm install -g @anthropic-ai/claude-code # 2) 指向自定义网关并持久化到 shell cat >> ~/.zshrc <<'EOF' export ANTHROPIC_BASE_URL="<BASE_URL>" export ANTHROPIC_AUTH_TOKEN="<API_KEY>" EOF source ~/.zshrc # 3) 启动 claude
bash 用户把 ~/.zshrc 换成 ~/.bashrc。
③ Codex
写入 ~/.codex/config.toml 自定义 provider。同样把 <BASE_URL> 和 <API_KEY> 换成实际值。
一键脚本
# 1) 安装 npm install -g @openai/codex # 2) 写配置 mkdir -p ~/.codex cat > ~/.codex/config.toml <<'EOF' model = "gpt-5-codex" model_provider = "gateway" [model_providers.gateway] name = "Custom Gateway" base_url = "<BASE_URL>" wire_api = "responses" env_key = "CODEX_API_KEY" EOF # 3) 提供 key 并启动 export CODEX_API_KEY="<API_KEY>" codex
把 key 持久化:将 export CODEX_API_KEY=… 也写进 shell 配置。
说明
- 顺序:先 ① 装 Node.js,再 ② / ③ 任选其一或都配。两个 CLI 都依赖 npm。
- 脚本里的
<BASE_URL>/<API_KEY>是占位符,复制后替换成你的网关地址和密钥即可。 - Claude Code 走环境变量(
ANTHROPIC_BASE_URL/ANTHROPIC_AUTH_TOKEN);Codex 走~/.codex/config.toml里的自定义 provider。 - 公司内网网关可能需要先连上对应 VPN / aTrust,再启动 CLI。