SSH Good API
登录
教程 登录

Claude Code 配置

分别介绍 macOS 与 Windows 环境下 Claude Code CLI 的安装，以及如何接入 SSH Good API 网关。 Anthropic 风格 Base URL：https://api.sshgoodapi.cc（不要擅自追加 /v1）。

开始之前：请先在 控制台 注册并创建 API Key（占位符 sk-xxx）。流程见 令牌创建。
ANTHROPIC_BASE_URL https://api.sshgoodapi.cc

Mac 安装教程

本章介绍在 macOS（也适用于多数 Linux 发行版）上安装 Claude Code CLI，并接入 SSH Good API 网关。

使用 Brew 安装 Node.js

Claude Code 依赖 Node.js 运行时。推荐用 Homebrew 管理版本，便于后续升级。

1

安装 Homebrew

若尚未安装 Homebrew，在终端执行官方安装脚本：

bash 
# 下载并安装 Homebrew
curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

按终端提示把 brew 加入 PATH（Apple Silicon 通常需追加 /opt/homebrew/bin）。

2

安装 Node.js 并确认版本

bash 
brew install node
node -v
npm -v

也可用 nvm / fnm / 官网 LTS 安装包，只要 node 与 npm 可用即可。

安装 Claude Code

Claude Code 是 Anthropic 官方 AI 编程 CLI，通过 npm 全局安装。

1

全局安装 Claude Code CLI

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

验证安装

bash 
claude --version
# 预期类似：Claude Code x.x.x

若提示权限不足，可为 npm 配置用户级全局目录，或按官方文档谨慎使用 sudo。

3

运行健康检查

bash 
claude doctor

该命令会检查本机环境。若安装阶段网络较慢，可临时切换 npm 镜像：

bash 
npm config set registry https://registry.npmmirror.com
版本提示：请尽量使用较新的 Claude Code 发行版；命令找不到时请新开终端并检查 PATH。

配置 AUTH_TOKEN 与 BASE_URL

将 SSH Good API 入口写入环境，使 Claude Code 通过网关访问模型服务。

说明：开始前请确认已在控制台创建 API Token。尚未创建请先阅读 令牌创建。
1

方式一：环境变量（推荐）

编辑 ~/.zshrc（zsh）或 ~/.bashrc（bash），追加：

bash 
# SSH Good API — Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxx"
export ANTHROPIC_BASE_URL="https://api.sshgoodapi.cc"

保存后重载并核对：

bash 
source ~/.zshrc
# bash 用户改为：source ~/.bashrc
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
2

方式二：交互式登录

直接运行 claude，按提示填写 Key 与 Base URL：

bash 
claude
# 按提示输入：
# API key → sk-xxx（替换为控制台真实 Key）
# API base URL → https://api.sshgoodapi.cc
安全：勿把真实 Key 提交到 Git 或发给他人。泄露后请立即在控制台吊销并重新创建。
3

验证连接

在任意项目目录执行一句提示，确认链路通畅：

bash 
claude "只回复：SSH Good API 已连接"

若返回正常内容，可在控制台核对用量。模型 ID 可在控制台查看，或参考 模型 API。

Windows 安装教程

系统要求：Windows 10（较新内部版本）或 Windows 11；建议以管理员打开 PowerShell 或「终端」。

使用 PowerShell 安装 Node.js

推荐通过 Chocolatey 安装 Node.js，便于版本管理与升级。

1

以管理员身份打开 PowerShell

右键「开始」→ 选择「Windows PowerShell（管理员）」或「终端（管理员）」。

2

安装 Chocolatey 并安装 Node.js

powershell 
# 安装 Chocolatey
Set-ExecutionPolicy Bypass -Scope Process -Force
irm https://community.chocolatey.org/install.ps1 | iex

# 安装 Node.js
choco install nodejs -y

node -v
npm -v

也可从 Node.js 官网安装 LTS 安装包。npm 较慢时可临时：

powershell 
npm config set registry https://registry.npmmirror.com

安装 Claude Code

1

全局安装 Claude Code CLI

powershell 
npm install -g @anthropic-ai/claude-code
claude --version
2

运行健康检查

powershell 
claude doctor

权限不足时，请关闭终端后以管理员身份重新打开再执行。

配置 AUTH_TOKEN 与 BASE_URL

Windows 推荐通过 PowerShell Profile 或系统环境变量持久化配置。

1

方式一：PowerShell Profile（推荐）

powershell 
echo $PROFILE
if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
notepad $PROFILE

在打开的文件末尾追加并保存：

powershell 
# SSH Good API — Claude Code
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxx"
$env:ANTHROPIC_BASE_URL   = "https://api.sshgoodapi.cc"

重新打开 PowerShell，或执行 . $PROFILE 立即生效。

2

方式二：系统 / 用户环境变量（GUI）

  • 搜索并打开「编辑系统环境变量」→「环境变量」。
  • 在「用户变量」中新建： ANTHROPIC_AUTH_TOKEN = 控制台真实 Key； ANTHROPIC_BASE_URL = https://api.sshgoodapi.cc。
  • 关闭并重新打开终端，执行：
powershell 
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
3

验证连接

powershell 
claude "只回复：SSH Good API 已连接"

成功后可在控制台查看调用记录。编辑器接入见 IDE 配置。