Claude Code 接入

Claude Code 是 Anthropic 提供的终端 AI 编程助手（CLI 命令为 claude）。完成安装后，可配置为通过 PhanEdge 网关调用。

系统要求

平台	要求
macOS	13.0 及以上
Windows	10（1809+）或 Server 2019+；需安装 Git for Windows，或使用 WSL
Linux	Ubuntu 20.04+、Debian 10+、Alpine 3.19+ 等
硬件	约 4GB+ 内存，x64 或 ARM64

安装

原生安装（推荐，支持自动更新）

macOS / Linux / WSL
Windows (PowerShell)
Windows (CMD)

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

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

包管理器安装（需手动升级）

macOS (Homebrew)
Windows (WinGet)

brew install --cask claude-code
# 升级：brew upgrade claude-code

winget install Anthropic.ClaudeCode
# 升级：winget upgrade Anthropic.ClaudeCode

验证安装

claude --version
claude doctor

接入 PhanEdge 网关

在启动 claude 的终端中设置以下环境变量：

Bash / Zsh
PowerShell

export ANTHROPIC_BASE_URL="https://models.phanedge.cloud"
export ANTHROPIC_API_KEY="<在 PhanEdge 控制台创建的 API 密钥>"
claude

$env:ANTHROPIC_BASE_URL = "https://models.phanedge.cloud"
$env:ANTHROPIC_API_KEY = "<你的 PhanEdge API 密钥>"
claude

不要在 ANTHROPIC_BASE_URL 末尾拼接 /v1，Claude Code 会自动处理路径。

验证接入

确认 PhanEdge 控制台中密钥有效、模型路由包含所需 Claude 型号。
启动 claude，执行 /status 确认网关配置已加载。
发送一条测试消息验证响应正常。

排错提示

仍命中 Anthropic 官方直连

检查环境变量是否在启动 claude 的同一终端中生效，或是否被用户/组织级 settings 覆盖。

认证失败

若当前版本要求 Authorization: Bearer，尝试改用 ANTHROPIC_AUTH_TOKEN 承载同一令牌。

企业网络代理

另设 HTTPS_PROXY / HTTP_PROXY，详见 Claude Code 官方 Enterprise network configuration 文档。

旧版 npm 全局安装已弃用。若仍需在 Node 18+ 下使用：npm install -g @anthropic-ai/claude-code（不推荐）。

概述

API 调用

工具接入

系统要求

安装

原生安装（推荐，支持自动更新）

包管理器安装（需手动升级）

验证安装

接入 PhanEdge 网关

验证接入

排错提示

​系统要求

​安装

​原生安装（推荐，支持自动更新）

​包管理器安装（需手动升级）

​验证安装

​接入 PhanEdge 网关

​验证接入

​排错提示

系统要求

安装

原生安装（推荐，支持自动更新）

包管理器安装（需手动升级）

验证安装

接入 PhanEdge 网关

验证接入

排错提示