Claude Code 配置教程

获取 API Key 后，按照你的操作系统选择对应步骤完成配置。

步骤 1：验证是否安装 Node.js

Claude Code 基于 Node.js 运行，请先确认已安装 Node.js（建议 v18+ LTS 版本）。

打开终端（Windows 用户按 Win+R 输入 cmd 回车）：

如果没有显示版本号，请参考「Node.js 安装教程」进行安装。

Windows 用户还需额外安装 Git for Windows：

如果没有正常显示版本号，请访问 https://git-scm.com/install/windows 下载安装。安装完后重启电脑。

Git for Windows 提供的 Git Bash 是 Claude Code 在 Windows 原生环境下运行命令的基础工具。macOS 和 Linux 已有原生 Bash，无需额外安装。

步骤 2：安装 Claude Code

Windows（PowerShell，无需 sudo）

npm install -g @anthropic-ai/claude-code

macOS / Linux / WSL2

如果使用 nvm 管理 Node.js，可以不加 sudo。

验证安装：

步骤 3：配置环境变量

如果使用 CC Switch，可以跳转「CC Switch 配置教程」，通过图形界面完成配置。

将下方变量中的占位符替换为你的实际信息：

YOUR_API_KEY → 你在平台创建的令牌

Windows（PowerShell）

临时生效（仅当前终端会话有效）：

$env:ANTHROPIC_BASE_URL = "https://jiniu.ai"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"

永久生效（推荐，写入系统环境变量）：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://jiniu.ai", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")

设置后需重新打开终端窗口。

macOS / Linux / WSL2

将以下内容追加到 ~/.bashrc 或 ~/.zshrc（zsh 用户）：

然后使配置立即生效：

步骤 4：验证环境变量

Windows

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

macOS / Linux / WSL2

确认输出与你设置的值一致。

步骤 5：开始使用

在任意项目目录下运行：

步骤 6：确认配置已生效

进入 Claude Code 交互界面后，输入以下命令查看当前配置状态：

/status

执行后逐项确认：

字段	说明	期望值
`Anthropic base URL`	当前使用的接入地址	应显示 `https://jiniu.ai`
`Model`	当前模型	显示正在使用的模型名称

示例输出（正常）：

╭──────────────────────────────────────────────────╮
│  Status                                          │
│                                                  │
│  Anthropic base URL:  https://jiniu.ai    │
│  Model:         claude-sonnet-4-5                │
│                                                  │
╰──────────────────────────────────────────────────╯

如果 Anthropic base URL 显示的是 https://api.anthropic.com，说明环境变量未生效，请退出后重新检查步骤 3。

可选：全局配置文件

Claude Code 的全局设置文件路径：

系统	路径
Windows	`C:\Users\你的用户名\.claude\settings.json`
macOS / Linux	`~/.claude/settings.json`

常见问题

Q：环境变量设置后不生效？
A：重新打开一个终端窗口，或执行 source ~/.bashrc。

Q：Windows 安装时提示权限错误？
A：以管理员身份运行 PowerShell 后重试。

Q：macOS / Linux 安装时提示权限错误？
A：命令前加 sudo，或使用 nvm 安装 Node.js（nvm 安装的 npm 无需 sudo）。

Q：启动后提示需要登录？
A：确认 ANTHROPIC_AUTH_TOKEN 环境变量已正确设置，且重启了终端。如果使用 CC Switch，可开启「跳过 Claude Code 初次安装确认」选项。

Claude Code 配置教程

步骤 1：验证是否安装 Node.js#

步骤 2：安装 Claude Code#

Windows（PowerShell，无需 sudo）#

macOS / Linux / WSL2#

步骤 3：配置环境变量#

Windows（PowerShell）#

macOS / Linux / WSL2#

步骤 4：验证环境变量#

Windows#

macOS / Linux / WSL2#

步骤 5：开始使用#

步骤 6：确认配置已生效#

可选：全局配置文件#

常见问题#

步骤 1：验证是否安装 Node.js

步骤 2：安装 Claude Code

Windows（PowerShell，无需 sudo）

macOS / Linux / WSL2

步骤 3：配置环境变量

Windows（PowerShell）

macOS / Linux / WSL2

步骤 4：验证环境变量

Windows

macOS / Linux / WSL2

步骤 5：开始使用

步骤 6：确认配置已生效

可选：全局配置文件

常见问题