+-- tutorial/guide --+

使用教程

选择你想要使用的AI编程助手,跟着教程轻松安装配置。

📖查看飞书文档 — 最新教程与更新更新频率高,包含最新配置说明和常见问题解答 ↗

Claude设置 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 格式

脚本执行后会做什么?
  1. 检测操作系统和 Shell 类型(bash/zsh/fish)
  2. 自动备份现有配置文件
  3. 清理旧的环境变量配置
  4. 写入新的环境变量
  5. 更新 Claude 配置文件
  6. 验证配置并显示下一步指引
脚本执行完成后需要做什么?

请重新加载 Shell 配置或重启终端:

Terminal
# 对于 zsh (macOS 默认)
source ~/.zshrc
# 对于 bash
source ~/.bash_profile

3开始使用 Claude Code

现在你可以开始使用 Claude Code 了!在终端中运行:

Terminal
claude

macOS 常见问题解决

安装时提示权限错误

尝试以下解决方法:

  • 使用 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
🎉 配置完成!

你已经成功安装并配置了 Claude Code,现在可以开始使用 AI 编程助手了。

📖 下一步:

  • • 在项目目录运行 claude 启动 Claude Code
  • • 查看 使用指南 了解更多功能
  • • 探索 示例项目 快速上手
需要帮助?

遇到问题?查看 故障排除 或联系技术支持。