自动配置工具

一条命令完成 Claude Code / Codex 的安装与配置，即使你的机器还没有 Node.js 也能直接跑。

1. 快速开始

macOS / Linux

curl -fsSL https://relay.upthos.com/auto-config/install.sh | bash

Windows PowerShell

irm https://relay.upthos.com/auto-config/install.ps1 | iex

脚本会自动完成以下动作：

  • 检测系统是否已有可用的 Node.js（>= 20）
  • 如果没有，在用户目录下安装本地 Node.js 运行时
  • 将 npm 镜像切到国内源，降低无代理环境下的下载失败率
  • 安装 Claude Code 和 Codex
  • 写入对应配置文件（Claude Code 和 Codex 共用同一个 API Key）
  • 执行版本检查，确认安装成功

2. 常用参数

非交互式执行（传入 API Key）

macOS / Linux：

curl -fsSL https://relay.upthos.com/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY

Windows PowerShell（管道模式通过环境变量传参）：

$env:UPTHOS_API_KEY='YOUR_API_KEY'; irm https://relay.upthos.com/auto-config/install.ps1 | iex

Windows PowerShell（下载后直接执行）：

.\install.ps1 --api-key YOUR_API_KEY

只配置 Claude Code

curl -fsSL https://relay.upthos.com/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY --tools claude

只配置 Codex

curl -fsSL https://relay.upthos.com/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY --tools codex

自定义 API 地址

如果你使用了自定义域名：

curl -fsSL https://relay.upthos.com/auto-config/install.sh | bash -s -- --api-key YOUR_API_KEY --base-url https://your-domain.example.com

3. 脚本会写哪些文件

Claude Code

~/.claude/settings.json

核心字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.upthos.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Codex

~/.codex/auth.json
~/.codex/config.toml

auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

config.toml：

model_provider = "upthos"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 272000
model_auto_compact_token_limit = 272000
effective_context_window_percent = 95

[model_providers.upthos]
name = "upthos"
base_url = "https://relay.upthos.com"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

[features]
goals = true

4. 需要管理员权限吗

不需要。

脚本优先使用系统已有的 Node.js；如果没有，把 Node.js 安装到用户目录：

  • macOS / Linux：~/.upthosrelay/node
  • Windows：%USERPROFILE%\.upthosrelay\node

客户端也安装在用户目录，不影响系统全局环境。

5. 安装后要做什么

macOS / Linux

脚本结束后执行：

source ~/.zshrc

如果你不是 zsh，按脚本最后输出的 profile 文件执行 source。

Windows

重新打开一个 PowerShell 窗口即可。

6. 如何确认安装成功

claude --version
codex --version

能输出版本号就说明安装链路已打通。

7. 备份与回滚

如果你的机器上已有旧配置，脚本会在首次覆盖前自动生成 .bak 备份：

  • ~/.claude/settings.json.bak
  • ~/.codex/auth.json.bak
  • ~/.codex/config.toml.bak

需要回滚时，把对应 .bak 文件恢复回来即可。

8. 常见问题

Windows 上提示需要 git-bash

Claude Code 在 Windows 上依赖 git-bash 运行。脚本会自动检测并安装 Git for Windows（优先从国内镜像下载），无需手动操作。

Windows 管道模式怎么传参数

irm ... | iex 后面不能直接跟参数，需要通过环境变量传入：

$env:UPTHOS_API_KEY='YOUR_KEY'; irm https://relay.upthos.com/auto-config/install.ps1 | iex

不传环境变量时，脚本会交互式提示输入 API Key。

没有代理，脚本还能跑吗

可以。脚本默认优先使用国内镜像：

  • Node.js 优先从 npmmirror 拉取
  • npm registry 默认切到 https://registry.npmmirror.com

如果镜像失败，脚本会再尝试官方源。

只想写配置，不想安装客户端

加上 --skip-client-install：

curl -fsSL https://relay.upthos.com/auto-config/install.sh | bash -s -- --api-key YOUR_KEY --skip-client-install

适合你已经装好 claude 或 codex，只想重新写配置文件的情况。

原来的配置被覆盖了怎么办

检查同目录下的 .bak 备份文件。脚本在首次覆盖前就已经创建了备份。

9. 下一步