Mac Claude Code

在 Mac 电脑上安装和配置 Claude Code（Anthropic 推出的命令行 AI 编程助手）主要分为安装 、基础配置 以及自定义模型（第三方 API）配置三个部分。

以下是详细的操作步骤：

一、 安装 Claude Code

在 Mac 上，推荐使用 Homebrew 或官方脚本进行安装。

1. 使用 Homebrew 安装（推荐） 打开终端（Terminal），输入以下命令：

brew install claude-code

2. 使用官方脚本安装（备选） 如果没安装 Homebrew，可以使用 curl 脚本：

curl -fsSL https://claude.ai/install.sh | bash

3. 验证安装 安装完成后，检查版本以确认是否成功：

claude --version

---

二、 基础配置与登录

默认情况下，Claude Code 需要 Anthropic 的付费账号（Pro、Teams 或 Enterprise）。

1. 启动： 在你的项目根目录下输入 claude。
2. 登录： 首次运行会提示登录。它会打开浏览器让你授权。
3. 完成引导： 按照终端提示完成初始设置（如主题选择、权限授权等）。

---

三、 配置使用自定义模型（第三方 API）

如果你希望使用第三方中转接口或自定义模型（例如 DeepSeek、Poe 或国内镜像），可以通过环境变量 或配置文件来实现。

方法 1：通过环境变量（最简单）

在启动 claude 之前，设置以下环境变量。你可以将其添加到你的 ~/.zshrc 或 ~/.bash_profile 中以便永久生效。

# 设置第三方 API 的基础地址 (必须兼容 Anthropic 格式)
export ANTHROPIC_BASE_URL="https://your-proxy-api.com/v1"

# 设置你的 API Key
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

# 启动 Claude Code
claude

方法 2：修改本地配置文件（更稳定）

你可以创建一个本地设置文件来覆盖默认行为。

1. 创建配置目录（如果不存在）：

   mkdir -p ~/.claude

2. 创建/编辑 settings.json： 在 ~/.claude/settings.json 中添加环境配置：

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.your-provider.com",
       "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx"
     }
   }

方法 3：跳过官方登录流程（针对纯第三方用户）

如果你没有 Anthropic 官方账号，只想用第三方模型，需要手动"欺骗"程序通过初始化检查：

1. 创建伪造的 Key 文件：

   echo '{"primaryApiKey": "any-string"}' > ~/.claude/config.json

2. 标记已完成引导： 修改或创建 ~/.claude.json（注意文件名开头的点）：

   {
     "hasCompletedOnboarding": true
   }

---

四、 进阶：配置特定模型名称

Claude Code 默认寻找 claude-3-5-sonnet。如果你的第三方供应商使用不同的模型名称（如 deepseek-chat），你可能需要设置默认模型变量：

export ANTHROPIC_DEFAULT_HAIKU_MODEL="your-model-name"
# 或者在 settings.json 的 env 块中添加

---

五、 常用操作命令

启动 Claude Code 后，你可以在其内部交互界面使用以下斜杠命令：

• /config：查看和修改当前配置。
• /help：获取详细帮助指南。
• /login / /logout：管理官方账号登录。
• /compact：压缩对话历史以节省 Token。
• Ctrl+C：停止当前生成的代码或退出。

注意事项

• 兼容性： Claude Code 的核心功能（如自动读取文件、运行测试、修复 Bug）是针对 Claude 3.5 Sonnet 模型高度优化的。使用非 Claude 系列模型时，可能会出现指令理解不到位或工具调用（Tool Use）失败的情况。
• 网络： 如果你在国内使用，请确保终端环境可以正常访问你配置的 ANTHROPIC_BASE_URL。