📌

Claude Code 是一个强大的 AI 编程助手，让您可以直接在终端中与 AI 协作编程。本教程将指导您完成安装和配置过程。

📋 系统要求

Node.js 版本 ≥ 18.0
支持的操作系统：macOS、Linux、Windows (WSL)

🚀 快速开始

1.安装 Node.js

📌

提示：如果您已经安装了 Node.js 18.0 或更高版本，可以跳过此步骤。

Windows用户

打开node.js官方进行下载安装

Ubuntu / Debian 用户

#安装 Node.js LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# 验证安装
node --version

macOS 用户

# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 通过 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version

安装Git

Claude Code 需要 Git 来进行代码管理操作：

访问 https://git-scm.com 下载并安装

安装完成后，在终端运行以下命令验证：

能正常输出版本号即表示安装成功

提示：Windows 用户安装 Git 时，建议勾选 "Add Git to PATH" 选项，确保在任意终端可以使用 git 命令。

2. 安装 Claude Code

Windows用户

使用快捷键 WINDOWS + R，然后输入cmd，打开电脑终端

然后使用 npm 全局安装 Claude Code：

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

# 验证安装
claude --version

3. 配置并开始使用

然后好Claude Code后，我们还需要获取必要的配置信息，不然无法启动使用

前往https://xinghuapi.com/ 注册并登录，前往控制台 -> API令牌页面复制令牌备用。

您需要准备两个重要的配置项：

配置项	说明	获取方式
ANTHROPIC_AUTH_TOKEN	API 认证令牌	注册后在 API令牌页面点击添加令牌获得（以 sk- 开头）
ANTHROPIC_BASE_URL	API 服务地址	使用 https://xinghuapi.com（与主站地址相同）

📝 创建令牌时的建议设置：

名称：随意命名
分组：可以选择Claude code专属分组，Claude官方直连分组，或者其他的分组
额度：设为无限额度
其他选项：保持默认设置

启动 Claude Code
在您的项目目录下运行：

Windows系统，使用终端cmd运行

进入项目目录

cd your-project-folder

#设置环境变量

set ANTHROPIC_AUTH_TOKEN=sk-...  # 替换为您的实际令牌
set ANTHROPIC_BASE_URL=https://xinghuapi.com

# 启动 Claude Code
claude

Mac系统设置环境变量

# 进入项目目录
cd your-project-folder

#  Linux/Unix设置环境变量
export ANTHROPIC_AUTH_TOKEN=sk-...  # 替换为您的实际令牌
export ANTHROPIC_BASE_URL=https://xinghuapi.com

# 启动 Claude Code
claude

初次运行配置

启动后，您将看到以下配置步骤：

选择主题 → 选择您喜欢的主题 + 按 Enter

安全须知 → 确认安全须知 + 按 Enter

Terminal 配置 → 使用默认配置 + 按 Enter

工作目录信任 → 信任当前目录 + 按 Enter

✨ 恭喜！现在您可以开始与您的 AI 编程搭档一起写代码了！

在这里插入图片描述

如何在VScode使用Claude code

方法一设置电脑系统变量

📌

因为Claude code 默认打开是需要登录Claude官方会员账号，或者开发者api账号才能使用，如果想通过我们星狐云第三方api调用的话，必须先配置一下用户环境变量！

第一步

打开电脑的环境变量设置窗口

还是一样添加api令牌跟api服务地址

变量名：ANTHROPIC_AUTH_TOKEN   变量值：sk-...  # 替换为您的星狐云令牌密钥
变量名：ANTHROPIC_BASE_URL   变量值：https://xinghuapi.com

第二步打开VScode安装Claude Code插件

安装好了以后编辑窗口右上角就会出现Claude code图标，打开即可使用！

方法二直接设置vscode里面的setting

打开vscode的setting设置，在搜索框输入claude（必须安装好插件才行），然后点击下面显示出来的setting.json文件

在json文件下的claudecode环境变量里面，增加图中的实例代码，密钥改成自己创建的就行

 {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://xinghuapi.com"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "星狐云令牌密钥"
    }

❓ 常见问题解答

Q: 遇到 "Invalid API Key · Please run /login" 错误？
A: 这表明 Claude Code 未检测到环境变量。请检查：

是否正确设置了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL

环境变量值是否正确（令牌以 sk- 开头）

如果使用了永久配置，是否重启了终端

Q: 为什么显示 "offline" 状态？
A: Claude Code 通过连接 Google 来判断网络状态。显示 "offline" 不影响正常使用，只是表明无法连接到 Google。

Q: 为什么浏览网页的 Fetch 会失败？
A: Claude Code 在访问网页前需要调用 Claude 服务进行安全检查。您需要：

保持稳定的国际互联网连接

必要时使用全局代理

Q: 请求总是显示 "fetch failed"？
A: 可能是网络环境导致的问题。解决方案：

尝试使用代理工具

Q: API 报错如何处理？
A: 可能是转发代理不稳定导致的，建议：

退出 Claude Code（Ctrl+C）

重新运行 claude 命令

如果问题持续，请稍后再试

Q: 网页登录错误？
A: 尝试清除本站的 Cookie，然后重新登录。

📌 注意事项

请妥善保管您的 API 令牌，避免泄露

🔗 相关链接
Claude Code 官方文档
Node.js 官方网站

Claude Code配置星狐云API教程【最新】

📋 系统要求#

🚀 快速开始#

1.安装 Node.js#

安装Git#

2. 安装 Claude Code#

3. 配置并开始使用#

如何在VScode使用Claude code#

方法一设置电脑系统变量#

第一步#

第二步打开VScode安装Claude Code插件#

方法二直接设置vscode里面的setting#

❓ 常见问题解答#

📌 注意事项#