Claude Code 配置教程

Claude Code 是 Anthropic 官方推出的命令行 AI 编程工具。本教程将指导您如何配置 Claude Code 使用 XueXin API。

💡 前提条件

确保您已经在 XueXin 控制台 注册账号并获取了 API Key。

选择您的操作系统

安装 Node.js

Claude Code 需要 Node.js 18 或更高版本。

方式一：官网下载

访问 nodejs.org 下载 LTS 版本安装包。

方式二：使用 winget

powershellwinget install OpenJS.NodeJS.LTS

安装 Claude Code

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

配置 XueXin API

创建或编辑配置文件 %USERPROFILE%\.claude.json：

json{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.xuexin.xyz"
  }
}
⚠️ 重要

请将 你的API密钥 替换为您在 XueXin 控制台获取的真实 API Key（格式：sk-xxxx）。

启动 Claude Code

powershellclaude

如果一切正常，您将看到 Claude Code 的交互界面。

安装 Node.js

方式一：使用 Homebrew（推荐）

bashbrew install node@20

方式二：使用 nvm

bashcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

安装 Claude Code

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

配置 XueXin API

创建或编辑配置文件 ~/.claude.json：

json{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.xuexin.xyz"
  }
}

快速创建命令：

bashcat > ~/.claude.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.xuexin.xyz"
  }
}
EOF

启动 Claude Code

bashclaude

安装 Node.js

Ubuntu/Debian：

bashcurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS/RHEL：

bashcurl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

安装 Claude Code

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

配置 XueXin API

创建配置文件 ~/.claude.json：

bashcat > ~/.claude.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.xuexin.xyz"
  }
}
EOF

启动 Claude Code

bashclaude

VSCode 中使用 Claude Code

Claude Code 也可以在 VSCode 中作为扩展使用：

  1. 打开 VSCode
  2. 按 Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）打开扩展面板
  3. 搜索 "Claude Code" 并安装
  4. 配置扩展设置中的 API Key 和 Base URL

常见问题

Q: 出现 "API key not found" 错误

请检查：

Q: 出现 "model not allowed" 错误

您的套餐可能不包含 Claude 模型。请前往控制台查看您的套餐包含的模型列表，或联系客服升级套餐。

Q: 连接超时

请检查网络连接，确保能够访问 api.xuexin.xyz。