Claude Code 安装教程（macOS）

0. 前置：安装 Node.js

先装 Node.js（建议 22+）：Nodejs macOS

验证安装：分别执行下面两个命令

node -v

npm -v

如果看到版本号，说明 Node.js 安装成功了。

1. 安装 Claude Code

第一步：打开终端（按 Command + 空格，输入 Terminal，按回车）

第二步：执行安装命令

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

第三步：验证安装

claude --version

如果看到版本号，说明安装成功了。

2. 配置环境变量（接入词元AI）

2.1 什么是环境变量？

环境变量就是告诉 Claude Code 去哪里调用 AI 服务，以及用什么密钥。

你需要设置两个环境变量：

• ANTHROPIC_BASE_URL - 词元AI的服务地址
• ANTHROPIC_AUTH_TOKEN - 你的词元AI Key（密钥）

2.2 写入 Shell 配置文件（永久生效）

macOS 默认使用 zsh，我们需要把环境变量写入配置文件。

第一步：写入环境变量配置（注意替换 API Key）

{
  echo ''
  echo '# CI-Yuan AI (词元AI)'
  echo 'export ANTHROPIC_BASE_URL="https://api.ci-yuan-ai.com"'
  echo 'export ANTHROPIC_AUTH_TOKEN="你的词元AI Key"'
} >> ~/.zshrc

必须替换：把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key

如何替换？

1. 复制上面整段命令
2. 把 你的词元AI Key 这几个字替换成你的真实 Key
3. 然后粘贴到终端执行

第二步：让配置立即生效

source ~/.zshrc

2.3 验证环境变量是否设置成功

分别执行下面两个命令：

echo "$ANTHROPIC_BASE_URL"

应该显示：https://api.ci-yuan-ai.com

echo "$ANTHROPIC_AUTH_TOKEN"

应该显示你设置的 API Key（如果显示出来了，说明设置成功）

3. 启动并验证

第一步：进入你的项目目录

cd /path/to/your/project

把 /path/to/your/project 替换成你实际的项目路径。

第二步：启动 Claude Code

claude

可选：先做环境检查

如果你想先检查环境是否配置正确：

claude doctor

常见问题

1. npm install -g 报权限错误

原因：没有权限安装全局包。

解决方法：

• 不要用 sudo npm install -g 强制安装
• 推荐回到 Nodejs macOS 用 Homebrew 重新安装 Node.js
• Homebrew 安装的 Node.js 不需要 sudo 权限

2. 环境变量设置后不生效

原因：没有执行 source ~/.zshrc 或者终端没有重启。

解决方法：

1. 执行 source ~/.zshrc 让配置生效
2. 或者关闭终端，重新打开一个新的终端窗口
3. 再次验证：echo "$ANTHROPIC_BASE_URL"

3. 提示找不到 claude 命令

原因：全局包路径没有加到 PATH 环境变量里。

解决方法：

1. 检查 Node.js 是否正确安装：node -v
2. 重启终端
3. 如果还不行，重新安装 Claude Code