Claude Code 配置
步骤 1: 验证是否安装 Node.js
Claude Code 基于 Node.js 运行，请先确认已安装 Node.js（建议 LTS 版本）。
打开终端
windows用户（win+R）输入 cmd 回车
分别执行
node -v
npm -v
查看是否有版本号，如果没有显示版本号的可以参考 node 安装教程 进行安装
如果你是Windows用户，还需要额外安装Git for Windows
验证git是否安装
# 屏幕显示类似 git version 2.52.0.windows.1 的版本号
git --version如果没有正常显示版本号，你可以访问 https://git-scm.com/install/windows 下载安装程序，按默认选项安装即可。安装完后重启电脑，然后再安装Claude Code。
步骤 2：安装 Claude Code
Windows（PowerShell，无需 sudo）
npm install -g @anthropic-ai/claude-codemacOS / Linux / WSL2
sudo npm install -g @anthropic-ai/claude-code验证安装：
claude --version步骤 3：配置环境变量
如果使用CC Switch的可以跳转 CC Switch 配置
将下方变量中的占位符替换为你的实际信息：
YOUR_API_KEY→ 你的 API Key
Windows（PowerShell）
临时生效（仅当前终端会话有效）：
$env:ANTHROPIC_BASE_URL = "https://token.firstpy.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"永久生效（推荐，写入系统环境变量）：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://token.firstpy.com", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")设置后需重新打开终端窗口。
macOS / Linux / WSL2
将以下内容追加到 ~/.bashrc 或 ~/.zshrc（zsh 用户）：
export ANTHROPIC_BASE_URL="https://token.firstpy.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"然后使配置立即生效：
source ~/.bashrc
# 或 source ~/.zshrc步骤 4：验证环境变量
Windows
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKENmacOS / Linux / WSL2
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN步骤 5：开始使用
在任意项目目录下运行：
claude步骤 6：确认配置已生效
进入 Claude Code 交互界面后，输入以下命令查看当前配置状态：
/status执行后会显示如下信息，逐项确认是否正确：
| 字段 | 说明 | 期望值 |
|---|---|---|
Anthropic base URL | 当前使用的接入地址 | 应显示 https://token.firstpy.com |
Model | 当前模型 | 显示正在使用的模型名称 |
示例输出（正常）：
╭─────────────────────────────────────────────────╮
│ Status │
│ │
│ Anthropic base URL: https://token.firstpy.com │
│ Model: claude-sonnet-4-5 │
│ │
╰─────────────────────────────────────────────────╯如果
API endpoint显示的是 Anthropic 官方地址（https://api.anthropic.com），说明ANTHROPIC_BASE_URL环境变量未生效，请退出后重新检查步骤 3。
可选：全局配置文件
Claude Code 的全局设置文件路径如下，可用于配置主题、快捷键等选项：
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\你的用户名\.claude\settings.json |
| macOS / Linux | ~/.claude/settings.json |
常见问题
Q：环境变量设置后不生效？
重新打开一个终端窗口，或执行 source ~/.bashrc。
Q：macOS / Linux 安装时提示权限错误？
命令前加 sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo）。