API Proxy Docs
联系我们
  1. Claude Code 使用教程
  • Claude Code 使用教程
    • 🎓使用教程
  • ⚠️ 常见问题
  1. Claude Code 使用教程

🎓使用教程

跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。

📋 选择你的平台#

Windows - 适用于 Windows 10/11
macOS - 适用于 Intel 和 Apple Silicon
Linux / WSL2 - 适用于 Linux 和 Windows Subsystem for Linux
Windows
macOS
Linux / WSL2

1️⃣ 安装 Node.js 环境#

Claude Code 需要 Node.js 环境才能运行。

Windows 安装方法#

方法一：官网下载（推荐）#

1.
打开浏览器访问 https://nodejs.org/
2.
点击 LTS 版本进行下载（推荐长期支持版本）
3.
下载完成后双击 .msi 文件
4.
按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器#

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：
💡 Windows 注意事项
建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功#

安装完成后，打开 PowerShell 或 CMD，输入以下命令：
如果显示版本号，说明安装成功了！

2️⃣ 安装 Claude Code#

全局安装#

打开 PowerShell、Terminal 或 Bash，运行以下命令：
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
💡 提示
建议使用 PowerShell（Windows）或 Terminal（macOS）
如果遇到权限问题，以管理员身份运行或使用 sudo

验证 Claude Code 安装#

安装完成后，输入以下命令检查是否安装成功：
如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3️⃣ 设置环境变量#

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：
ANTHROPIC_BASE_URL - API 服务地址
ANTHROPIC_AUTH_TOKEN - API 密钥
Windows
macOS/Linux

Windows 设置方法#

方法一：PowerShell 临时设置（当前会话）#

在 PowerShell 中运行以下命令：
$env:ANTHROPIC_BASE_URL = "base_url"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
💡 记得将 你的API密钥 替换为实际的 API 密钥

方法二：PowerShell 永久设置（用户级）#

在 PowerShell 中运行以下命令设置用户级环境变量：
# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "base_url", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
💡 设置后需要重新打开 PowerShell 窗口才能生效

方法三：图形界面设置#

1.
右键点击 此电脑 或 我的电脑，选择 属性
2.
点击 高级系统设置
3.
点击 环境变量 按钮
4.
在 用户变量 中点击 新建
5.
变量名：ANTHROPIC_BASE_URL，变量值：base_url
6.
再次点击 新建
7.
变量名：ANTHROPIC_AUTH_TOKEN，变量值：你的API密钥
8.
点击 确定 保存

VSCode Claude 插件配置#

如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：
配置文件位置：
Windows: C:\Users\你的用户名\.claude\config.json
macOS/Linux: ~/.claude/config.json
💡 如果该文件不存在，请手动创建
配置内容：
{
  "primaryApiKey": "crs"
}

验证环境变量设置#

设置完环境变量后，可以通过以下命令验证是否设置成功：

Windows (PowerShell)#

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

macOS / Linux#

预期输出示例：
base_url
cr_xxxxxxxxxxxxxxxxxx
💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置

4️⃣ 开始使用 Claude Code#

现在你可以开始使用 Claude Code 了！

启动 Claude Code#

在特定项目中使用#

常用命令#

⚙️ 常见问题解决#

Windows 常见问题#

❌ 安装时提示 "permission denied" 错误#

解决方法：
以管理员身份运行 PowerShell
或者配置 npm 使用用户目录：
npm config set prefix $env:APPDATA\npm

❌ PowerShell 执行策略错误#

解决方法：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

❌ 环境变量设置后不生效#

解决方法：
重新启动 PowerShell 或 CMD
或者注销并重新登录 Windows
验证设置：echo $env:ANTHROPIC_BASE_URL

❌ npm 命令找不到#

解决方法：
确保 Node.js 已正确安装
重新启动 PowerShell
检查 PATH 环境变量是否包含 npm 路径

macOS / Linux 常见问题#

❌ 权限不足错误#

解决方法：

❌ 找不到 claude 命令#

解决方法：
确保 npm 全局 bin 目录在 PATH 中
检查配置：npm config get prefix
重新加载 shell 配置：source ~/.zshrc 或 source ~/.bashrc

❌ 权限被拒绝#

解决方法：

🚀 进阶使用#

更新 Claude Code#

卸载 Claude Code#

查看已安装的全局包#

配置代理（如需要）#

📚 更多资源#

官方文档: https://github.com/anthropics/claude-code
NPM 包: https://www.npmjs.com/package/@anthropic-ai/claude-code
Node.js 官网: https://nodejs.org/
获取帮助: 使用 claude --help 命令

💡 最佳实践#

1.
定期更新 - 定期更新 Claude Code 以获得最新功能和安全补丁
2.
备份密钥 - 妥善保管你的 API 密钥，不要分享给他人
3.
使用版本管理 - 在项目中使用 git 管理代码版本
4.
查看日志 - 遇到问题时查看详细日志帮助诊断
5.
社区支持 - 在 GitHub Issues 中寻求帮助
祝你使用愉快！ 🎉
下一页
⚠️ 常见问题
Built with