Mac Claude Code

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

以下是详细的操作步骤:

一、 安装 Claude Code

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

1. 使用 Homebrew 安装(推荐) 打开终端(Terminal),输入以下命令:

bash 复制代码
brew install claude-code

2. 使用官方脚本安装(备选) 如果没安装 Homebrew,可以使用 curl 脚本:

bash 复制代码
curl -fsSL https://claude.ai/install.sh | bash

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

bash 复制代码
claude --version

二、 基础配置与登录

默认情况下,Claude Code 需要 Anthropic 的付费账号(Pro、Teams 或 Enterprise)。

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

三、 配置使用自定义模型(第三方 API)

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

方法 1:通过环境变量(最简单)

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

bash 复制代码
# 设置第三方 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. 创建配置目录(如果不存在):

    bash 复制代码
    mkdir -p ~/.claude
  2. 创建/编辑 settings.json: 在 ~/.claude/settings.json 中添加环境配置:

    json 复制代码
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.your-provider.com",
        "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx"
      }
    }

方法 3:跳过官方登录流程(针对纯第三方用户)

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

  1. 创建伪造的 Key 文件:

    bash 复制代码
    echo '{"primaryApiKey": "any-string"}' > ~/.claude/config.json
  2. 标记已完成引导: 修改或创建 ~/.claude.json(注意文件名开头的点):

    json 复制代码
    {
      "hasCompletedOnboarding": true
    }

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

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

bash 复制代码
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。
相关推荐
feixing_fx7 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx8 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
JavaGuide11 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健12 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
feixing_fx12 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
丘山望岳12 小时前
【开发工具】 cluade code常用快捷键
前端
小巫编程室12 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
小y的笔记12 小时前
JavaScript URL 状态同步
前端·javascript
十有八七12 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端
Swot13 小时前
产品 RAG 知识库与 AI 顾问 设计与实现
前端·后端