创智AI
教程Claude Code

Claude Code 安装与配置

从零开始安装 Claude Code 并连接到创智AI网关。预计耗时 5-10 分钟。

1

安装 Node.js(v18 或更高版本)

Claude Code 需要 Node.js 运行环境。打开终端运行:

winget install OpenJS.NodeJS.LTS

验证安装:

node --version\nnpm --version

如果你已安装 Node.js v18+,可以跳过此步。 也可以从 nodejs.org 官网下载安装包。

2

安装 Claude Code

通过 npm 全局安装:

# 使用国内镜像源加速(推荐)
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或使用默认源
npm install -g @anthropic-ai/claude-code

验证安装:

claude --version
3

配置创智AI网关

设置环境变量,让 Claude Code 通过创智AI网关发送请求。 请将 你的API_KEY 替换为你在API Key 管理中创建的密钥。

# PowerShell 中设置环境变量
$env:ANTHROPIC_BASE_URL = "https://api.my-genesis.top"
$env:ANTHROPIC_API_KEY = "你的API_KEY"

# 永久设置(重启后仍有效)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.my-genesis.top", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "你的API_KEY", "User")
4

启动 Claude Code

在项目目录下启动:

cd 你的项目目录
claude

启动后输入 /status 验证连接是否正常。

常见问题

安装 npm 报错 EACCES 权限不足

以管理员身份运行 PowerShell 再执行安装命令。

提示 "API key is invalid"

检查 ANTHROPIC_API_KEY 是否正确设置。在终端中运行 echo $env:ANTHROPIC_API_KEY 确认值是否正确。

不想每次都设置环境变量?

推荐使用 CC-Switch, 图形化界面一键切换,无需手动编辑配置。