Claucode

Appearance

Claude Code 接入指南 ​

太长不看版

快速安装步骤 ​

  1. 安装 Node.js (≥ 18.0)

    bash
    # macOS
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Windows
# 下载并安装 Node.js LTS 版本：https://nodejs.org/

  2. 安装 Claude Code

    bash
    npm install -g @anthropic-ai/claude-code

  3. 获取认证信息

    • API 令牌 (Token): 从控制台获取以 sk- 开头的令牌
    • API 地址: https://claucode.com

  4. 配置环境变量

    bash
    # macOS/Linux (添加到 .bashrc 或 .zshrc)
export ANTHROPIC_AUTH_TOKEN=sk-你自己的Token
export ANTHROPIC_BASE_URL=https://claucode.com

# Windows (PowerShell 管理员模式)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你自己的Token", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://claucode.com", "User")

  5. 启动并使用

    bash
    cd your-project-folder
claude

Claude Code 是 Anthropic 提供的命令行工具，让你可以直接在终端中与 Claude AI 协作编程。本指南将带你完成完整的安装和配置流程。

前置要求 ​

在开始之前，请确保你的系统满足以下要求：

  • 操作系统：Windows、macOS 或 Linux
  • Node.js 版本 ≥ 18.0
  • 稳定的网络连接

1️⃣ 安装 Node.js ​

如果你已经安装了 Node.js 18+ 版本，可以跳过此步骤。

Ubuntu / Debian 用户 ​

bash
# 添加 NodeSource 存储库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 安装 Node.js
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

macOS 用户 ​

bash
# 安装 Xcode 命令行工具
sudo xcode-select --install

# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 使用 Homebrew 安装 Node.js
brew install node

# 验证安装
node --version
npm --version

Windows 用户 ​

  1. 访问 Node.js 官网
  2. 下载 LTS 版本的安装包
  3. 运行安装程序，按照提示完成安装
  4. 打开命令提示符或 PowerShell，验证安装：
bash
node --version
npm --version

提示

建议使用 Node.js LTS（长期支持）版本以确保稳定性。

2️⃣ 安装 Claude Code ​

使用 npm 全局安装 Claude Code：

bash
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

如果遇到权限问题，可以尝试：

bash
# macOS/Linux 用户
sudo npm install -g @anthropic-ai/claude-code

# Windows 用户（以管理员身份运行）
npm install -g @anthropic-ai/claude-code

注意

如果安装过程中遇到网络问题，可以尝试使用国内 npm 镜像：

bash
npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com

3️⃣ 获取认证信息 ​

在开始使用前，你需要准备以下信息：

API 令牌 ​

  1. 获取 Auth Token： ANTHROPIC_AUTH_TOKEN

    • 在 API 控制台的 API令牌 页面点击 添加令牌
    • 令牌格式以 sk- 开头
    • 名称可以随意填写，建议使用有意义的名称
    • 额度建议设为无限额度，其他保持默认设置
    • 分组请选 Anthropic，claude code 仅支持此分组

  2. API 地址： ANTHROPIC_BASE_URL

    • 使用：https://claucode.com
    • 这是本站的 API 服务地址，与主站地址相同

4️⃣ 首次使用 ​

在你的项目目录下运行 Claude Code：

bash
# 进入项目目录
cd your-project-folder

# 设置环境变量并启动
export ANTHROPIC_AUTH_TOKEN=sk-你自己的Token
export ANTHROPIC_BASE_URL=https://claucode.com
claude

初始化设置 ​

首次运行时，Claude Code 会引导你完成以下设置：

  1. 选择主题：选择你喜欢的终端主题，按 Enter 确认
  2. 确认安全须知：阅读并确认安全提示，按 Enter 继续
  3. Terminal 配置：使用默认配置即可，按 Enter 确认
  4. 信任工作目录：确认信任当前工作目录，按 Enter 确认

完成设置后，你就可以开始与 Claude AI 协作编程了！🚀

5️⃣ 配置环境变量（推荐） ​

为了避免每次使用时重复输入认证信息，建议将环境变量写入配置文件：

macOS / Linux 用户 ​

bash
# 添加到 bash_profile
echo -e '\nexport ANTHROPIC_AUTH_TOKEN=sk-你自己的Token' >> ~/.bash_profile
echo -e '\nexport ANTHROPIC_BASE_URL=https://claucode.com' >> ~/.bash_profile

# 添加到 bashrc
echo -e '\nexport ANTHROPIC_AUTH_TOKEN=sk-你自己的Token' >> ~/.bashrc
echo -e '\nexport ANTHROPIC_BASE_URL=https://claucode.com' >> ~/.bashrc

# 如果使用 zsh
echo -e '\nexport ANTHROPIC_AUTH_TOKEN=sk-你自己的Token' >> ~/.zshrc
echo -e '\nexport ANTHROPIC_BASE_URL=https://claucode.com' >> ~/.zshrc

Windows 用户 ​

  1. 打开 PowerShell（管理员模式）
  2. 设置系统环境变量：
powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你自己的Token", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://claucode.com", "User")

或者通过系统设置：

  1. 右键点击"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 点击"环境变量"
  4. 在"用户变量"中添加上述两个变量

验证配置 ​

重启终端后，直接使用以下命令即可启动 Claude Code：

bash
cd your-project-folder
claude

配置成功标志

如果环境变量配置正确，启动时不会要求你重新输入 API 令牌信息。

使用技巧 ​

常用命令 ​

  • /help - 查看帮助信息
  • /exit - 退出 Claude Code
  • /clear - 清除对话历史
  • /model - 切换 Claude 模型

最佳实践 ​

  1. 项目初始化：在项目根目录启动 Claude Code，这样 AI 可以更好地理解项目结构
  2. 清晰的指令：使用明确、具体的指令，比如"创建一个 React 组件"而不是"写点代码"
  3. 分步骤进行：对于复杂任务，建议分解为多个小步骤
  4. 代码审查：始终审查 AI 生成的代码，确保符合你的需求和标准

故障排除 ​

常见问题 ​

Q: 安装时提示权限错误 A: 尝试使用 sudo（Linux/macOS）或以管理员身份运行命令（Windows）

Q: 无法连接到 API A: 检查网络连接和 API 地址是否正确配置

Q: 令牌认证失败 A: 确认令牌格式正确（以 sk- 开头）且未过期

Q: 命令找不到 A: 确保 Node.js 和 npm 已正确安装，并且 PATH 环境变量包含 npm 全局安装目录

获取帮助 ​

如果遇到问题，可以：

  1. 查看 Claude Code 官方文档
  2. 在终端中运行 claude --help
  3. 联系技术支持

现在你已经成功配置了 Claude Code，可以开始享受 AI 辅助编程的强大功能了！记住，Claude Code 是你的编程搭档，善用它可以大大提高开发效率。