CLAUDE CODE

Claude Code - macOS 安装配置

在 macOS 系统安装和配置 Claude Code，并使用千模岛 API 服务。

#前置要求

macOS 系统与管理员或 sudo 权限
稳定的互联网连接
千模岛 API 账户与 Claude Code 专用分组令牌

#步骤 1：安装 Node.js

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

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

# 安装 Node.js
brew install node

#方法 2：从官网下载

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

验证安装：

node --version
npm --version

#步骤 2：安装 Claude Code CLI

# 使用 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://www.qianmodao.com，不要填写 https://www.qianmodao.com/v1。

创建配置目录：

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

创建 settings.json：

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

{
  "env": {
    "ANTHROPIC_API_KEY": "粘贴为Claude Code专用分组令牌key",
    "ANTHROPIC_BASE_URL": "https://www.qianmodao.com"
  },
  "model": "自行选择一个该Claude Code分组支持的model（在模型广场查看）"
}

chmod 600 ~/.claude/settings.json

#步骤 4：设置 API 密钥

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

# 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：验证配置

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

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

#VSCode 集成（可选）

如果你使用 VSCode，可以安装 Claude Code 扩展：

打开 VSCode。
按 Cmd+Shift+X打开扩展面板。
搜索 “Claude Code” 并安装。

安装扩展后，继续使用 ~/.claude/settings.json，无需单独填写 claude.apiBaseUrl 或 claude.apiKey。

#常用命令

# 启动交互式聊天
claude

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

# 查看帮助
claude --help

# 代码审查
claude ultrareview

#快捷键（VSCode）

Cmd+Shift+C：打开 Claude 面板
Cmd+Shift+A：分析当前文件
Cmd+Shift+G：生成代码
Cmd+K Cmd+C：生成代码注释

#故障排除

#问题：权限被拒绝

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

#问题：命令未找到

npm config get prefix
echo $PATH
which claude

#问题：API 连接失败

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

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

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

#性能优化

#配置代理（如需要）

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

#下一步

提示

macOS 用户推荐使用 Homebrew 管理和更新：brew upgrade claude-code