跟着这个教程,你可以轻松在自己的电脑上安装并使用 Claude Code。
Claude Code 需要 Node.js 环境才能运行。
方法一:官网下载(推荐)
https://nodejs.org/
.msi
文件
方法二:使用包管理器
如果你安装了 Chocolatey 或 Scoop,可以使用命令行安装:
安装完成后,打开 PowerShell 或 CMD,输入以下命令:
如果显示版本号,说明安装成功了!
打开 PowerShell 或 CMD,运行以下命令:
这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
在 PowerShell 中运行以下命令:
💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
在 PowerShell 中运行以下命令设置用户级环境变量:
查看已设置的环境变量:
💡 设置后需要重新打开 PowerShell 窗口才能生效。
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
C:\Users\你的用户名\.claude\config.json
💡 如果该文件不存在,请手动创建。
设置完环境变量后,可以通过以下命令验证是否设置成功:
预期输出示例:
💡 如果输出为空或显示变量名本身,说明环境变量设置失败,请重新设置。
如果你使用 Gemini CLI,需要设置以下环境变量:
在 PowerShell 中运行以下命令:
💡 使用与 Claude Code 相同的 API 密钥即可。
在 PowerShell 中运行以下命令:
💡 设置后需要重新打开 PowerShell 窗口才能生效。
在 PowerShell 中验证:
如果你使用支持 OpenAI API 的工具(如 Codex),需要设置以下环境变量:
在
~/.codex/config.toml
文件开头添加以下配置:
在
~/.codex/auth.json
文件中配置API密钥:
{{ codexConfigContent.authInstructions.description }}
{{ codexConfigContent.authInstructions.platform.title }}:
{{ codexConfigContent.authInstructions.persistent.title }}:
{{ codexConfigContent.authInstructions.persistent.description }}
Droid CLI 使用
~/.factory/config.json
保存自定义模型;在 Windows 中可直接编辑
C:\Users\你的用户名\.factory\config.json。
将以下内容追加到配置文件中,并替换示例中的域名和 API 密钥:
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid 账号池;确保服务地址可被本地访问。
现在你可以开始使用 Claude Code 了!
这通常是权限问题,尝试以下解决方法:
npm config set prefix %APPDATA%\npm
如果遇到执行策略限制,运行:
设置永久环境变量后需要:
echo $env:ANTHROPIC_BASE_URL
Claude Code 需要 Node.js 环境才能运行。
方法一:使用 Homebrew(推荐)
如果你已经安装了 Homebrew,使用它安装 Node.js 会更方便:
方法二:官网下载
https://nodejs.org/
.pkg
文件
sudo
安装完成后,打开 Terminal,输入以下命令:
如果显示版本号,说明安装成功了!
打开 Terminal,运行以下命令:
如果遇到权限问题,可以使用 sudo:
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
在 Terminal 中运行以下命令:
💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
编辑你的 shell 配置文件(根据你使用的 shell):
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
~/.claude/config.json
💡 如果该文件不存在,请手动创建。
如果你使用 Gemini CLI,需要设置以下环境变量:
在 Terminal 中运行以下命令:
💡 使用与 Claude Code 相同的 API 密钥即可。
添加到你的 shell 配置文件:
在 Terminal 中验证:
如果你使用支持 OpenAI API 的工具(如 Codex),需要设置以下环境变量:
在
~/.codex/config.toml
文件开头添加以下配置:
在
~/.codex/auth.json
文件中配置API密钥:
{{ codexConfigContent.authInstructions.description }}
{{ codexConfigContent.authInstructions.platform.title }}:
{{ codexConfigContent.authInstructions.persistent.title }}:
{{ codexConfigContent.authInstructions.persistent.description }}
Droid CLI 使用
~/.factory/config.json
保存自定义模型;你可以在 Finder 中按
⌘ + Shift + G
并输入路径,或运行
open ~/.factory
快速打开配置目录。
将以下内容追加到配置文件中,并替换示例中的域名和 API 密钥:
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid 账号池;确保服务地址可被本地访问。
现在你可以开始使用 Claude Code 了!
尝试以下解决方法:
sudo npm install -g @anthropic-ai/claude-code
npm config set prefix ~/.npm-global
如果系统阻止运行 Claude Code:
sudo spctl --master-disable
检查以下几点:
echo $ANTHROPIC_BASE_URL
Claude Code 需要 Node.js 环境才能运行。
方法一:使用官方仓库(推荐)
方法二:使用系统包管理器
虽然版本可能不是最新的,但对于基本使用已经足够:
sudo
安装完成后,打开终端,输入以下命令:
如果显示版本号,说明安装成功了!
打开终端,运行以下命令:
如果遇到权限问题,可以使用 sudo:
安装完成后,输入以下命令检查是否安装成功:
如果显示版本号,恭喜你!Claude Code 已经成功安装了。
为了让 Claude Code 连接到你的中转服务,需要设置两个环境变量:
在终端中运行以下命令:
💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。
编辑你的 shell 配置文件:
如果你使用 Gemini CLI,需要设置以下环境变量:
在终端中运行以下命令:
💡 使用与 Claude Code 相同的 API 密钥即可。
添加到你的 shell 配置文件:
在终端中验证:
如果你使用支持 OpenAI API 的工具(如 Codex),需要设置以下环境变量:
在
~/.codex/config.toml
文件开头添加以下配置:
在
~/.codex/auth.json
文件中配置API密钥:
{{ codexConfigContent.authInstructions.description }}
{{ codexConfigContent.authInstructions.platform.title }}:
{{ codexConfigContent.authInstructions.persistent.title }}:
{{ codexConfigContent.authInstructions.persistent.description }}
如果使用 VSCode 的 Claude 插件,需要在配置文件中进行设置:
配置文件位置:
~/.claude/config.json
💡 如果该文件不存在,请手动创建。
Droid CLI 使用
~/.factory/config.json
保存自定义模型;在 Linux 或 WSL2 中,可直接编辑
/home/你的用户名/.factory/config.json
或在终端运行
xdg-open ~/.factory
打开目录。
将以下内容追加到配置文件中,并替换示例中的域名和 API 密钥:
💡 在 Droid CLI 中选择自定义模型即可使用新的 Droid 账号池;确保服务地址可被本地访问。
现在你可以开始使用 Claude Code 了!
尝试以下解决方法:
sudo npm install -g @anthropic-ai/claude-code
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
某些 Linux 发行版需要安装额外依赖:
检查以下几点:
source ~/.bashrc
echo $ANTHROPIC_BASE_URL
你已经成功安装并配置了 Claude Code,现在可以开始享受 AI 编程助手带来的便利了。
如果在使用过程中遇到任何问题,可以查看官方文档或社区讨论获取帮助。