KKCode文档站

Appearance

Claude Code macOS 使用指南 ​

1. 安装 Node.js ​

方式一：Homebrew（推荐） ​

bash
brew update
brew install node

方式二：官网安装 ​

  1. 打开 https://nodejs.org/
  2. 下载 macOS 的 LTS 安装包
  3. 双击 .pkg 完成安装

验证安装 ​

bash
node --version
npm --version

2. 安装 Claude Code ​

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

3. 配置环境变量 ​

临时生效（当前 shell）：

bash
export ANTHROPIC_BASE_URL="https://www.kkcode.ai/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

永久生效（zsh，macOS 默认）：

bash
echo 'export ANTHROPIC_BASE_URL="https://www.kkcode.ai/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

验证变量：

bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

4. 开始使用 ​

bash
claude

在项目目录中使用：

bash
cd /path/to/your/project
claude

5. 常见问题 ​

安装时权限不足 ​

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

命令未找到 ​

bash
echo $PATH
which claude