跳到主要内容
快速上手API 参考接入与支持
工具接入

Claude Code 接入指南

按主站快速开始完整整理，并补充协议核对结果，覆盖 Claude Code 在 Windows、macOS、Linux 下的安装、配置、启动和排障。

Claude Code 接入指南

这页保留主站快速开始里的完整 Claude Code 教程，主站原页不会删除。

先记住这 2 个值​

  • 根地址：https://anideaai.com
  • 鉴权变量：ANTHROPIC_AUTH_TOKEN

Claude Code 走的是 Anthropic 协议。ANTHROPIC_BASE_URL 要填根地址，不要手动加 /v1。

1. 推荐安装（无需 Node.js）​

# PowerShell 一键安装
irm https://claude.ai/install.ps1 | iex

# CMD 一键安装
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# WinGet
winget install Anthropic.ClaudeCode

# 验证安装
claude --version

一键安装会自动后台更新。Windows 建议先装好 Git for Windows。

2. 如果你要走 npm 安装，先装 Node.js​

可以任选一种方式：

  1. 打开 https://nodejs.org/ 下载 LTS 版本
  2. 或在 PowerShell 里运行 winget install OpenJS.NodeJS.LTS

安装后检查：

node --version
npm --version

3. npm 安装 Claude Code​

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

如果遇到权限问题，建议用管理员身份打开 PowerShell。

4. 配置环境变量​

当前会话临时生效：

$env:ANTHROPIC_BASE_URL = "https://anideaai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxx"

如果你用 CMD：

set ANTHROPIC_BASE_URL=https://anideaai.com
set ANTHROPIC_AUTH_TOKEN=sk-xxxxx

用户级永久生效：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://anideaai.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxxx", [System.EnvironmentVariableTarget]::User)

检查变量：

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

清除变量：

Remove-Item Env:ANTHROPIC_BASE_URL -ErrorAction Ignore
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction Ignore
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, [System.EnvironmentVariableTarget]::User)
set ANTHROPIC_BASE_URL=
set ANTHROPIC_AUTH_TOKEN=

5. 启动 Claude Code​

cd C:\path\to\your\project
claude

6. 常见问题​

问题 1：PowerShell 执行策略拦截（Windows 10 常见）​

运行 claude 时报错：

claude : 无法加载文件 C:\Users\xxx\AppData\Roaming\npm\claude.ps1，因为在此系统上禁止运行脚本。
CategoryInfo : SecurityError (:) [], PSSecurityException
FullyQualifiedErrorId : UnauthorizedAccess

解决方法：在 PowerShell 中执行以下命令，提示时输入 Y 确认：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

执行后重新运行 claude 即可。此问题主要出现在 Windows 10 上，Windows 11 默认策略通常不会触发。

问题 2：缺少 Git（git-bash）​

运行 claude 时报错：

Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).
If installed but not in PATH, set environment variable pointing to your bash.exe,
similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

解决方法：

  1. 访问 https://git-scm.com/downloads/win 下载对应版本的 Git for Windows
  2. 安装时保持默认选项（会自动添加到 PATH）
  3. 安装完成后重新打开 PowerShell，再运行 claude

如果已安装 Git 但仍报错，手动设置环境变量指向 bash.exe：

$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

永久生效：

[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", [System.EnvironmentVariableTarget]::User)

问题 3：安装时报 permission denied​

先用管理员身份打开 PowerShell。 如果还不行，再检查 npm 全局目录权限。

快速排错顺序​

  1. 先确认 ANTHROPIC_BASE_URL 是根地址 https://anideaai.com
  2. 再确认 ANTHROPIC_AUTH_TOKEN 已生效且没有多余空格
  3. 最后再检查 CLI 版本是不是过旧
这页有帮助吗？
本页目录