叶智叶 API 文档
CLAUDE CODE

Claude Code - macOS 安装配置

在 macOS 系统安装和配置 Claude Code，并使用智叶 API 服务。

#前置要求

  • macOS 13.0 或更高版本；安装时使用当前用户环境
  • 稳定的互联网连接
  • 智叶 API 账户与 Claude Code 专用分组令牌

npm 安装方式：当前 Claude Code 要求 Node.js ≥22；本站推荐 Node.js 24 LTS。Node.js 18/20 已结束维护，不再作为新安装推荐。

#步骤 1：安装 Node.js

#方法 1：使用 Homebrew（推荐）

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

# 安装 Node.js
brew install node

#方法 2：从官网下载

访问 Node.js 官网，下载并安装 macOS 版本。

验证安装：

bash
node --version
npm --version

#步骤 2：安装 Claude Code CLI

bash
# 使用 npm 安装
sudo npm install -g @anthropic-ai/claude-code

# 也可以使用 Homebrew
brew install --cask claude-code

# 验证安装
claude --version
权限问题
Windows 请使用管理员终端；macOS/Linux 使用系统级 npm 时可加 sudo， 使用 nvm 时不需要 sudo。

#步骤 3：配置 API 端点

Claude Code 地址不带 /v1
使用 https://api.ziyelian.site，不要填写 https://api.ziyelian.site/v1。

创建配置目录：

bash
mkdir -p ~/.claude
cd ~/.claude

创建 settings.json：

配置文件位置：~/.claude/settings.json

json
{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://api.ziyelian.site"
  },
  "model": "自行选择一个该Claude Code分组支持的model（在模型广场查看）"
}
bash
chmod 600 ~/.claude/settings.json

#步骤 4：设置 API 密钥

#方法 1：环境变量（推荐）

bash
# Zsh（macOS 默认）
echo 'export ANTHROPIC_API_KEY="你的智叶_API令牌"' >> ~/.zshrc
source ~/.zshrc

# Bash
echo 'export ANTHROPIC_API_KEY="你的智叶_API令牌"' >> ~/.bash_profile
source ~/.bash_profile

#方法 2：配置文件

也可以直接使用前面的 ~/.claude/settings.json。请妥善保管 API 密钥，不要将配置文件提交到版本控制系统。

#步骤 5：验证配置

bash
claude "你好，请介绍一下你自己"

如果配置正确，Claude Code 会正常响应。

VS Code 集成

安装 Anthropic 发布的 Claude Code 官方扩展，通过活动栏图标或命令面板打开。CLI 与扩展共享 ~/.claude/settings.json 中的 env 配置；Windows 对应用户主目录。

不要使用旧教程里的 claude.apiBaseUrl / claude.apiKey VS Code 字段，它们不是当前官方扩展的通用接入配置。修改 settings.json 后重启扩展会话；不要在公开工作区配置里写入令牌。

官方 VS Code 配置文档

#常用命令

bash
# 启动交互式聊天
claude

# 非交互式输出
claude --print "请审查 src/ 目录并列出主要问题"

# 查看帮助
claude --help

# 代码审查
claude ultrareview

快捷键

快捷键随操作系统和扩展版本不同。通过 VS Code 命令面板搜索 Claude Code，或在“键盘快捷方式”中查看当前绑定；不要把 VS Code 的扩展面板、资源管理器快捷键当作 Claude 专用功能。

#故障排除

#问题：权限被拒绝

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

#问题：命令未找到

bash
npm config get prefix
echo $PATH
which claude

#问题：API 连接失败

验证 ANTHROPIC_API_KEY 和 ~/.claude/settings.json， 并确认端点为 https://api.ziyelian.site（不带 /v1）。

#问题：M1/M2 芯片兼容性

bash
# Apple Silicon 使用原生 arm64 Node.js；Intel Mac 使用 x64。
uname -m
node -p "process.arch"

#性能优化

#配置代理（如需要）

bash
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

#下一步

提示
macOS 用户推荐使用 Homebrew 管理和更新：brew upgrade claude-code
本页目录前置要求