免费使用 Claude Code 的安装与配置指南

1 minute read

Published:

Claude Code 是 Anthropic 公司推出的一款新型编程辅助工具。这个工具相比较于cursor,copilot等ide或ide插件,能力更强,效果更好。通常,使用它需要订阅 Claude Pro 或 Business 套餐。但通过一些镜像服务,可以获得一定的免费额度进行体验。本文将介绍如何通过终端命令来安装和配置 Claude Code。

与 Cursor 这类集成开发环境(IDE)或其插件不同,Claude Code 是一个通过命令行终端进行交互的工具。它既可以安装在本地计算机(如 macOS),也可以部署在通过 SSH 连接的云端服务器(如 Linux)。

注意: 以下教程将使用 anyrouter.top 作为公益镜像站点的示例。如果通过我的邀请链接注册 anyrouter.top,获取额外的50刀额度:https://anyrouter.top/register?aff=ypyS

在 macOS 上安装

1. 安装 Node.js (版本需 > 18.0)

首先,通过以下命令检查是否已安装 Node.js 及其版本:

node --version

如果未安装或版本过低,可以通过 Homebrew 进行安装:

# 安装 Xcode Command Line Tools
sudo xcode-select --install
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"
# 使用 Homebrew 安装 Node.js
brew install node
# 再次检查版本
node --version

2. 安装 Claude Code

执行以下命令来全局安装 Claude Code:

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

安装后,验证是否成功:

claude --version

权限问题解决: 如果在执行 npm install -g 时遇到 EACCES: permission denied 错误,说明当前用户没有在默认全局目录 /usr/local/lib/node_modules/ 下创建文件的权限。可以按照以下步骤更改 npm 的全局安装目录:

  1. 创建新的全局包目录:
    mkdir ~/.npm-global
    
  2. 配置 npm 使用新目录:
    npm config set prefix '~/.npm-global'
    
  3. 将新路径添加到 Shell 配置文件中:
    echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
    
  4. 让配置立即生效:
    source ~/.zshrc
    
  5. 重新运行安装命令:
    npm install -g @anthropic-ai/claude-code
    

3. 配置与使用

在使用前,需要配置两个关键的环境变量:

  • Auth Token (ANTHROPIC_AUTH_TOKEN): 注册 anyrouter.top 后,在 “API令牌” 页面创建一个新的令牌(以 sk- 开头)。
  • API 地址 (ANTHROPIC_BASE_URL): 使用镜像站的服务地址 https://anyrouter.top

临时配置(仅当前终端会话有效): 进入项目文件夹,然后执行:

cd your-project-folder
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=[https://anyrouter.top](https://anyrouter.top)
claude

永久配置(推荐): 将环境变量写入 ~/.zshrc 文件,这样每次打开终端时都会自动加载:

echo -e '\nexport ANTHROPIC_API_KEY="sk-..."' >> ~/.zshrc
echo -e '\nexport ANTHROPIC_BASE_URL="[https://anyrouter.top](https://anyrouter.top)"' >> ~/.zshrc
source ~/.zshrc

配置完成后,就可以随时在任何项目目录下直接运行 claude 命令开始使用。

在 Linux 服务器上安装

1. 安装 Node.js (版本需 > 18.0)

检查 Node.js 版本:

node --version

如果未安装,可以使用以下命令安装:

curl -fsSL [https://deb.nodesource.com/setup_lts.x](https://deb.nodesource.com/setup_lts.x) | sudo bash -
sudo apt-get install -y nodejs
node --version

2. 安装 Claude Code

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

如果遇到权限问题,请参考 macOS 部分的解决方案。

3. 配置与使用

与 macOS 类似,需要配置认证令牌和 API 地址。

临时配置:

cd your-project-folder
export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=[https://anyrouter.top](https://anyrouter.top)
claude

永久配置: 将环境变量写入 ~/.bash_profile~/.bashrc 文件:

echo -e '\nexport ANTHROPIC_AUTH_TOKEN=sk-...' >> ~/.bash_profile
echo -e '\nexport ANTHROPIC_BASE_URL=[https://anyrouter.top](https://anyrouter.top)' >> ~/.bash_profile
source ~/.bash_profile

现在,就可以开始在mac本地和linux服务器上使用 Claude Code 加速你的编程生产力了!