+-- tutorial/guide --+
设置 Claude Code
Claude Code 是一个命令行工具,可以让 Claude 直接在你的电脑上编写和运行代码。本教程将指导你完成安装和配置。
已安装但遇到 401 等问题?跳转到环境变量配置
1安装 Claude Code
选择适合你的安装方式。推荐使用 Homebrew(macOS/Linux)或 Native Install(所有平台)。
Terminal
curl -fsSL https://claude.ai/install.sh | bash验证安装
安装完成后,运行以下命令验证:
Terminal
claude --version如果显示版本号,说明安装成功!
2连接到镜像服务
配置环境变量,让 Claude Code 通过本站的镜像服务访问 Claude API。
一键自动配置
在 Terminal 中运行以下命令:
正在获取你的 Token...
使用前请注意
脚本会自动备份你的配置文件(.bashrc, .zshrc, .bash_profile 等),备份文件保存为 .backup.YYYYMMDD_HHMMSS 格式
脚本执行后会做什么?
- 检测操作系统和 Shell 类型(bash/zsh/fish)
- 自动备份现有配置文件
- 清理旧的环境变量配置
- 写入新的环境变量
- 更新 Claude 配置文件
- 验证配置并显示下一步指引
脚本执行完成后需要做什么?
请重新加载 Shell 配置或重启终端:
Terminal
# 对于 zsh (macOS 默认)source ~/.zshrc# 对于 bashsource ~/.bash_profile3开始使用 Claude Code
现在你可以开始使用 Claude Code 了!在终端中运行:
Terminal
claudemacOS 常见问题解决
安装时提示权限错误
尝试以下解决方法:
- 使用 sudo 安装:
sudo npm install -g @anthropic-ai/claude-code - 或者配置 npm 使用用户目录:
npm config set prefix ~/.npm-global
macOS 安全设置阻止运行
如果系统阻止运行 Claude Code:
- 打开"系统偏好设置" → "安全性与隐私"
- 点击"仍要打开"或"允许"
- 或者在 Terminal 中运行:
sudo spctl --master-disable
环境变量不生效
检查以下几点:
- 确认修改了正确的配置文件(.zshrc 或 .bash_profile)
- 重新启动 Terminal
- 验证设置:
echo $ANTHROPIC_BASE_URL