Claude Code 快速开始指南

前置条件：安装 Node.js 环境

Claude Code 依赖 Node.js 运行环境，请先参考 Node.js 环境安装指南 完成安装并验证。

更省事的方式：自动配置

如果你不想手动安装和逐项写配置，推荐直接使用 自动配置工具。

macOS / Linux：

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

Windows PowerShell：

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

1. 配置 Claude Code

第一步：安装 Claude Code

打开终端「Terminal」并运行：

curl -fsSL https://claude.ai/install.sh | sh

此安装脚本会自动处理所有依赖项——无需预先安装 Node.js 或 npm。

macOS / Linux 遇到权限问题时加 sudo：

sudo curl -fsSL https://claude.ai/install.sh | sh

验证安装：

claude --version

第二步：创建 API Key

登录 Upthos Relay 控制台，进入 API 密钥 页面，点击 创建密钥。

填写密钥名称，选择分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。

新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

第三步：导入密钥到 Claude Code

推荐使用 CC Switch 工具进行一键配置，也可手动设置环境变量。

方式一：CC Switch（推荐）

CC Switch 是一个 Claude Code 供应商切换工具，提供图形化界面来管理多个 API 供应商配置，安装方法请参考仓库说明。

前往 CC Switch Release 下载安装后

点击 使用密钥 ：

点击「导入到CCS」：

CCS 弹窗点击确认导入：

导入后点击 启用 即可。

方式二：手动配置环境变量

点击密钥旁的 复制 按钮获取 API Key。

需要设置以下两个环境变量：

临时设置（当前终端会话有效）

Windows (PowerShell)：

$env:ANTHROPIC_BASE_URL = "https://relay.upthos.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

macOS / Linux：

export ANTHROPIC_BASE_URL="https://relay.upthos.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

永久设置（重启后依然有效）

Windows (PowerShell)：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://relay.upthos.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", [System.EnvironmentVariableTarget]::User)

macOS (Zsh)：

echo 'export ANTHROPIC_BASE_URL="https://relay.upthos.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux (Bash)：

echo 'export ANTHROPIC_BASE_URL="https://relay.upthos.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

第四步：开始使用

进入任意项目目录，运行：

claude

Claude Code 会自动分析当前目录的代码并提供智能编程辅助。

常见问题（FAQ）

Q：安装脚本执行失败或提示权限不足？
A：macOS / Linux 在命令前加 sudo；Windows 使用管理员权限运行 PowerShell。

Q：claude --version 提示命令不存在？
A：安装脚本默认会把 claude 放在 ~/.local/bin（macOS / Linux），请确认该路径已加入系统 $PATH，然后重启终端或执行 source ~/.zshrc / source ~/.bashrc 使其生效。

Q：连接失败或返回 401 错误？
A：检查 ANTHROPIC_BASE_URL 是否为 https://relay.upthos.com，以及 ANTHROPIC_AUTH_TOKEN 是否填写正确且未过期。

Q：如何切换不同模型或倍率？
A：在 Upthos Relay 控制台 创建不同分组的密钥，通过 CC Switch 在多个配置间快速切换。