Claude Code 接入教程

在 Windows、macOS、Linux 上安装和配置 Claude Code，使用 XiDao Api 作为后端服务

什么是 Claude Code?

Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具，是目前最强的编程 AI 之一。

🧠

深度理解项目上下文

不仅是补全代码，更是深度分析整个代码库，提供精准的架构建议

✨

自动生成代码

只需描述逻辑，即可根据业务需求生成高质量、可维护的功能代码

🔧

智能修复 Bug

快速定位逻辑漏洞，提供一键式修复方案，显著提升调试效率

📈

代码重构优化

自动识别技术债与冗余，持续提升代码质量、可读性与系统性能

前置条件

Claude Code 需要以下环境，请逐项检查：

依赖 最低版本 检查命令 用途
Git 2.23+ git -v 项目上下文分析、版本控制
Node.js 18.0+ node -v 运行 Claude Code CLI
💡
提示 如果以上命令都能正常输出版本号，可直接跳到安装 Claude Code 步骤。

Windows 安装

1. 安装 Git

Git 是 Claude Code 的必要依赖，用于分析项目历史、执行代码提交等操作。

下载 Git

访问 Git 官网 下载 Windows 安装包

运行安装程序

双击安装包，一路使用默认选项点击「Next」即可完成安装

验证安装

重新打开终端（PowerShell 或 CMD），运行以下命令确认安装成功：

powershell
git -v

2. 安装 Node.js

方式一：使用 fnm 安装（推荐）

fnm (Fast Node Manager) 是一个快速的 Node.js 版本管理器，支持轻松安装和切换多个 Node.js 版本。

✅
推荐使用 fnm 版本切换方便、升级无痛、不污染系统环境，且跨平台通用。

下载 fnm

访问 fnm 发布页面，下载 fnm-windows.zip 压缩包

解压到固定目录

将压缩包内的 fnm.exe 解压到一个固定位置，例如 C:\fnm

添加环境变量

按 Win + R，输入 SystemPropertiesAdvanced 回车，打开系统属性窗口。点击底部「环境变量」按钮，在「用户变量」中找到 Path，双击编辑，新增一行填入 fnm 所在目录（如 C:\fnm），点击确定保存。

安装 Node.js

重新打开终端，运行以下命令安装最新 LTS 版本：

powershell
fnm install --lts
node -v

方式二：官网下载安装包

  1. 访问 Node.js 官网 下载 LTS 版本安装包
  2. 运行安装包，完成后在终端验证：node -v

3. 安装 Claude Code

打开终端

按 Win + R，输入 powershell 或 cmd

执行安装命令

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

验证安装

运行 claude --version 确认安装成功

macOS 安装

系统要求

  • macOS 10.15 (Catalina) 或更高版本
  • Git（macOS 通常已预装，终端运行 git -v 检查）
  • Node.js 18+
💡
macOS 首次运行 git 时会自动提示安装 Xcode Command Line Tools，按提示操作即可。

1. 安装 Node.js

方式一：使用 fnm 安装（推荐）

bash
# Install fnm
curl -fsSL https://fnm.vercel.app/install | bash

# Install latest LTS version
fnm install --lts
node -v

方式二：使用 Homebrew

bash
brew install node

2. 安装 Claude Code

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

Linux 安装

系统要求

  • Ubuntu 18.04+、CentOS 7+、Debian 9+ 等主流发行版
  • Git 2.23+（运行 git -v 检查）
  • Node.js 18+

0. 安装 Git（如未安装）

bash
# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y git

# CentOS / RHEL
sudo yum install -y git

1. 安装 Node.js

方式一：使用 fnm 安装（推荐）

bash
# Install fnm
curl -fsSL https://fnm.vercel.app/install | bash

# Reload shell config
source ~/.bashrc

# Install latest LTS version
fnm install --lts
node -v

方式二：使用 NodeSource（Ubuntu/Debian）

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

2. 安装 Claude Code

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

配置 API

⚙️
推荐 使用 CC-Switch 进行配置更加方便，支持图形化界面一键切换。

macOS / Linux 配置

Zsh 用户（macOS 默认）

bash
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API_KEY"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://api.xidao.online"' >> ~/.zshrc
source ~/.zshrc

Bash 用户

bash
echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API_KEY"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://api.xidao.online"' >> ~/.bashrc
source ~/.bashrc

Windows 配置

方式一：PowerShell 临时设置

powershell
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的API_KEY"
$env:ANTHROPIC_BASE_URL = "https://api.xidao.online"
⚠️
Windows 的 $env: 方式为临时配置，关闭终端后失效。

方式二：settings.json 持久化配置（推荐）

打开配置目录

按 Win + R，输入 %userprofile%\.claude

编辑配置文件

找到或创建 settings.json，写入以下内容：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xidao.online",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API_KEY"
  }
}

启动 Claude Code

重新打开终端，输入 claude 即可启动

使用方法

启动方式

打开终端

在你的项目目录中打开终端

启动 Claude

输入 claude 启动交互式模式

信任目录

首次启动选择 Yes 信任目录

✅
恭喜！ 现在你已经可以开始使用 Claude Code 了。直接用自然语言描述你的需求即可。

常用命令

基础命令

命令功能说明
claude在当前目录启动交互式 REPL，对话式使用
claude "解释这个项目"启动 REPL 并带上初始问题
claude -p "解释这个函数"Print 模式一次性问答，输出后直接退出
cat logs.txt | claude -p "帮我总结"通过管道喂给 Claude 做总结分析
claude update更新到最新版本

会话管理

命令功能说明
claude -c继续最近的一次会话
claude -c -p "检查类型错误"在最近会话中执行一次性请求
claude --continue载入最近会话（继续上次对话）
claude --resume abc123通过会话 ID 恢复指定会话

高级选项

命令功能说明
claude mcp管理 MCP 服务器配置
claude --model sonnet指定使用的模型
claude --verbose显示详细日志，便于调试
claude -p "生成文档" --output-format jsonJSON 格式输出
⚠️
注意 --dangerously-skip-permissions 可跳过权限确认让 Claude 自动执行操作，但风险较高，仅在完全信任的环境中使用。

常见问题排查

无法连接到服务

如果出现连接错误，可以尝试以下解决方案：

powershell (Windows)
powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

然后重启 Claude CLI。

令牌无效或余额不足

  • 检查令牌是否正确复制（包含 sk- 前缀）
  • 登录平台检查账户余额
  • 确认令牌分组是否支持你使用的模型

响应速度慢

  • 检查网络连接是否稳定
  • 尝试切换到速度更快的模型（如 Gemini Flash）
  • 减少单次请求的上下文长度

推荐配置优化

建议在 settings.json 的 env 中添加以下环境变量以获得更稳定体验：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xidao.online",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "DISABLE_AUTOUPDATE": "1"
  }
}
←
返回
接入教程
下一篇
Codex 教程
→