3948 字
20 分钟
macOS开荒指南
2026-08-16
技术分享
macOS

MacBook Air是一款好电脑。它轻便，快速，同时性能还不差。尤其在现在AI大行其道的时代，AI和Agent们往往对macOS的适配比Windows更好，因此笔者近期入手了一台MacBook Air。在拿到新的macOS之后，很有必要对其进行一系列配置。由于macOS本身基于Unix开发，因此相比于其他一些操作系统来说更干净，管理起来也很方便。本文就是记录笔者是如何对一个新到手或者重制后的新系统进行开荒的。在执行以下操作前，请先保证一个稳定的、可以流畅访问GitHub等境外网站的网络环境。

安装brew及软件管理#

安装brew#

为了便于统一管理macOS的各种软件，我们决定先暂时抛弃App Store，转而使用包管理器brew。之所以使用brew，不仅是因为它可以安装大多数我们需要的软件，也可以方便的我们之后需要的环境配置。另外，就像apt、pacman一样，使用它卸载软件也非常干净。

安装brew前首先需要安装xcode-select:

Terminal window
xcode-select --install

然后执行安装脚本：

Terminal window
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

如果你的macOS是基于Apple芯片的，则需要将brew添加到环境变量内：

Terminal window
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile

接着在当前终端中运行brew：

Terminal window
eval "$(/opt/homebrew/bin/brew shellenv)"

可以执行以下命令测试brew：

Terminal window
brew -v # 测试查看brew版本
brew doctor # 检查brew状态

通过brew安装GUI软件#

我们可以通过brew安装图形化软件。我们以Office中的Excel为例。首先我们先搜索Excel程序，可以使用：

Terminal window
brew search excel

结果可能是：

Terminal window
==> Formulae
excel-compare


==> Casks
microsoft-excel

在这里，Formulae指的是命令行工具或者库、Casks指的是带有图形化界面原生macOS应用。Excel是Casks所以我们可以查看这个microsoft-excel的程序信息：

Terminal window
brew info --casks microsoft-excel

或许会看到：

Terminal window
==> microsoft-excel ✔ (Microsoft Excel): 16.111.26072617 (auto_updates)
Spreadsheet software
https://www.microsoft.com/en-US/microsoft-365/excel
Installed (on request)
/opt/homebrew/Caskroom/microsoft-excel/16.111.26071913 (1.2GB)
  Installed using the internal formulae.brew.sh API on 2026-07-24 at 23:50:38
From: https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/m/microsoft-excel.rb
==> Requirements
Required: macOS ✔
==> Artifacts
Microsoft_Excel_16.111.26072617_Installer.pkg (Pkg)
==> Analytics
install: 1,492 (30 days), 4,425 (90 days), 17,606 (365 days)

在这里可以浏览所有信息。由于笔者已经安装了Excel，所以就以已安装的输出作为实例，未安装的输出与之类似。

  • ==> microsoft-excel ✔ (Microsoft Excel): 16.111.26072617 (auto_updates)：代表该程序的包名与最新版本号，(auto_updates)意味着该程序不经过经过软件自己更新，不会通过brew update更新。这样做的好处是Casks软件一旦安装就与普通软件使用起来一模一样，不需要走brew统一管理。
  • Spreadsheet software https://www.microsoft.com/en-US/microsoft-365/excel：描述与官方主页，可以在这里检查是否为所需要的软件。
  • Installed (on request)：说明用户已经安装了该软件，且是用户手动指定的，而不是其他软件的依赖。
  • /opt/homebrew/Caskroom/microsoft-excel/16.111.26071913 (1.2GB)：已安装版本及位置。这是该 Cask 在电脑上的实际存放目录。 对于微软 365 这类应用，Caskroom 里通常只存 .pkg 安装包或元数据，应用本体会在 /Applications 下。可以看到因为我没有手动更新，所以我使用brew update并不会使该软件更新，目前还停留在旧版本。
  • Installed using the internal formulae.brew.sh API on 2026-07-24 at 23:50:38：何时、通过何种方式安装。这个 Cask 通过 Homebrew 的内部 API 安装。
  • From: https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/m/microsoft-excel.rb定义来源。这个.rb文件定义了如何安装从何处下载。
  • ==> Requirements Required: macOS ✔：系统要求。
  • ==> Artifacts Microsoft_Excel_16.111.26072617_Installer.pkg (Pkg)：表示该软件是通过pkg方式安装的。
  • ==> Analytics install: 1,492 (30 days), 4,425 (90 days), 17,606 (365 days)：安装量统计。近期安装量统计排行榜可以看官方网站。

既然已经确认该包就是需要下载的包，我们就可以：

Terminal window
brew install microsoft-excel

稍等一会儿后看到

Terminal window
🍺  microsoft-excel was successfully installed!

便安装成功了。稍等一会儿就可以到启动台中看到Excel了。

常用GUI软件#

下面列举了笔者常用的GUI软件，实测均可以正常下载。

Terminal window
brew install --casks microsoft-excel microsoft-powerpoint microsoft-word onedrive qq tailscale-app visual-studio-code wechat windows-app zotero chatgpt typora

使用brew还可以轻松的备份软件列表。只需要

Terminal window
brew bundle dump --file=~/Brewfile
  • 该命令会自动扫描：
    • 通过 brew install 安装的 Formula
    • 通过 brew install --cask 安装的 Cask
    • 通过 mas install 安装的 Mac App Store 应用（需安装 mas 命令行工具）
    • 甚至 Homebrew 的 tap 仓库

随后将Brewfile复制到新环境，然后运行：

Terminal window
brew bundle install --file=~/Brewfile

便可以自动安装所有项目。

如果想要卸载软件，使用以下命令即可：

Terminal window
brew uninstall microsoft-excel #删除软件
brew uninstall --zap microsoft-excel #彻底删除并清理残余文件

如果想清理brew缓存，可以使用命令：

Terminal window
brew cleanup

基础环境配置#

笔者对Mac的定位是终端机+轻量开发机，所以接下来的配置将会基于此展开。这些方案不一定适用于所有人，仅供参考。

终端配置#

作为一台终端机，清晰漂亮的终端是必不可少的。在这里笔者选择了zsh+Starship+Ghostty的配置，当然，oh-my-zsh和iTerm2也是很好的选择。

首先我们安装必要的软件：

Terminal window
# 安装终端模拟器和字体
brew install --cask ghostty font-jetbrains-mono-nerd-font
# 安装提示符引擎
brew install starship

以及一些好用的插件（可选）：

Terminal window
# 命令自动补全插件
brew install zsh-autosuggestions
# 命令语法高亮
brew install zsh-syntax-highlighting
# ls和cat的现代替代
brew install eza bat

详细的配置值得开一个专题文章去讲，在这里就不展开了。如果可以的话本博客后续有望介绍相关内容。

远程桌面配置#

前面提到，笔者主要把Mac定位为终端机，所以远程桌面连接Windows主力机是非常有必要的。在这里我使用的方案是Tailscale组网+Windows RDP。Windows RDP是Windows内置的一种远程桌面，但要求被控端电脑上安装的Windows必须是激活后的Windows 10专业版或者Windows 11专业版。

Tailscale简介与安装#

由于Windows内置的RDP远程桌面需要两台机器在同一局域网内，所以我们在这使用Tailscale进行虚拟组网。然而，通常情况下在家庭网络、校园网、办公网等复杂网络环境下，再叠加可能的运营商的多层NAT，Tailscale往往无法进行直连，会退化为通过DERP服务器连接，延迟高达300ms以上，几乎无法正常使用远程桌面。此前的解决方法往往是自建DERP服务器。不过，最近Tailscale为我们提供了一种新的解决方法，即peer relay，可以方便的解决无法直连的问题。

使用peer relay，需要一台拥有公网IP的云服务器。这里笔者使用的是99元/年的阿里云ECS服务器，然而若常用Tailscale，笔者并不推荐阿里云系服务器，因为Tailscale内部IP会与阿里云内网IP发生冲突，可能导致Tailscale开启时无法正常apt update，不过若只是用于peer relay便无伤大雅。

我们的目的是：使用Tailscale将所有需要连接的机器置于同一局域网下，并以云服务器为桥梁，连接macOS与Windows。首先我们需要在云服务器、macOS和Windows上同时下载Tailscale。具体下载方式可以减官方网站。macOS可以使用我们之前用过的brew命令下载。brew的库中包含两个Tailscale：一个是纯命令行的tailscale，一个是图形化的tailscale-app，笔者在这里安装了tailscale-app。

Linux可以使用脚本下载：

Terminal window
curl -fsSL https://tailscale.com/install.sh | sh

下载后直接启动Tailscale：

Terminal window
sudo tailscale up

启动后会返回一个网址，进入该网址登陆或注册Tailscale账号后便成功连接上Tailscale了。

Tailscale的peer relay设置#

首先在云服务器中将云服务器设为relay server：

Terminal window
tailscale set --relay-server-port=40000

同时在对应安全组中放行UDP端口。

接着，在Tailscale控制台中，找到Access Controls -> JSON Editor，将下面这一段配置添加进json中：

{
  "grants": [
    // 中继授权：所有 office 设备可用 ECS 做 peer relay
    {
      "src": ["tag:office"],
      "dst": ["tag:relay"],
      "app": {
        "tailscale.com/cap/relay": []
      }
    },
    // overlay 访问：成员可访问所有 office 设备（文档要求的中继配套规则）
    {
      "src": ["autogroup:member"],
      "dst": ["tag:office"],
      "ip": ["*"]
    },
    // office 设备互访全放行
    {
      "src": ["tag:office"],
      "dst": ["tag:office"],
      "ip": ["*"]
    }
  ],
  "tagOwners": {
    "tag:office": [],
    "tag:relay": []
  },
  "ssh": [
    {
      "action": "check",
      "src": ["autogroup:member"],
      "dst": ["autogroup:self"],
      "users": ["autogroup:nonroot", "root"]
    }
  ],
  "nodeAttrs": [
    {
      "target": ["autogroup:member"],
      "attr": ["funnel"]
    }
  ]
}

最后，将云服务器设置ACL标签为relay，其他设备设置为office即可通过peer relay连接。

TIP

为了保证云服务器peer relay的稳定性，可以将云服务的key expiry设置为disabled以避免出现key过期无法peer relay的情况。

Windows app配置#

首先需要在Windows端启用远程桌面：在“设置 → 系统 → 远程桌面”中打开开关，并确认当前用户具备远程登录权限。同时勾选“要求设备使用网络级身份验证”。

接下来，在macOS上下载Windows app：

Terminal window
brew install windows-app

打开Windows app，输入目标Windows的Tailscale局域网ip、用户名和密码，稍等片刻便可以连接上Windows了。

Git配置#

Git是很重要的一个工具了。下载了xcode-select后会自带一个Apple的Git。这个Git可以与钥匙串整合，并且也不算老，所以我们在这里就直接使用这个自带的Git，不去下载新Git了。

Terminal window
git config --global user.name "your_name"
git config --global user.email "your_email@email.com" #邮箱可以选择匿名邮箱

向GitHub推送的时候，可以选择两种凭据方式：https和ssh。

  • https可以与macOS的钥匙串集成，只需要运行代码：

    Terminal window
    git config --global credential.helper osxkeychain

    即可。

    后续操作时需要确认GitHub用户名和token，具体token可以在GitHub右上角的Settings，前往左侧最底部Developer settings的Personal access tokens然后在Tokens (classic)中获取。

  • ssh也可以操作。执行以下命令：

Terminal window
ssh-keygen -t ed25519 -C "your_email"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub

然后到 GitHub → Settings → SSH Keys 里粘贴公钥。

另外建议写一个 ~/.ssh/config，让每次连接都自动用钥匙串:

Host *
AddKeysToAgent yes
UseKeychain yes
IdentityFile ~/.ssh/id_ed25519

Python环境配置#

大多时候笔者使用Python进行数据处理和分析，因此笔者更倾向于选择pixi而不是uv作为Python的管理工具。而相比于miniforge，pixi更便于brew管理，因此笔者在这里均以pixi为例配置python环境。

pixi的配置十分简单，只需要执行

Terminal window
brew install pixi

便可以完成安装。

使用时我们先进入项目文件夹，再执行：

Terminal window
pixi init #初始化pixi环境
pixi add python #向环境中添加python

便可以向环境中加入python以管理python版本。

如果后续想加入其他包，直接执行pixi add即可，例如：

Terminal window
pixi add numpy pytest #添加numpy和pytest

想使用当前环境运行目录中的python程序，可以使用：

Terminal window
pixi run python main.py

或者使用pixi shell

Terminal window
pixi shell #激活当前pixi环境
python main.py #在当前环境中运行main.py
exit #退出当前环境

当然，如果只用VS Code，可以直接在Python插件中管理Python版本。由于VS Code对pixi对支持还不那么完善，因此可能需要安装renan-r-santos.pixi-code插件后Code才会检测到pixi环境。该插件为Code官方推荐，可以放心安装。至于其他详细内容可以到官方网站中进一步查看。

其他程序配置#

Zotero配置#

Zotero是一个相当好用的文献管理软件。它开源免费、社群活跃、插件众多、自定义功能强大，几乎是科研必备软件。可以直接通过brew下载：

Terminal window
brew install --cask zotero

下载后打开即可进入Zotero。

同步配置#

文献的同步可以走Zotero官方，也可以走WebDAV服务。Zotero官方的服务价格太高昂，因此性价比最高的一般是走WebDAV。

走WebDAV也有两条路：第一种是云服务，最典型的就是坚果云。然而之前笔者使用坚果云，免费版只支持每月1GB上传/3GB下载配额，有的时候迁移数据库不太够用，所以笔者选择第二条路：文献库自托管。关于Zotero文献自托管的配置方法，本博客曾介绍过，在此不做深究。感兴趣的读者可以移步此处。

插件配置#

相比于其他文献管理软件，Zotero的一大亮点就是丰富的插件生态。详细的插件列表和下载方式可以见插件商店，具体使用方法可以见Zotero中文百科全书，在此笔者不过度阐述。下面简单列举笔者比较常用的几个插件以供参考：

Agent配置#

对于如今的电脑，Agent几乎是必须的。对我个人而言我一般会用两种方式使用Agent，一种是通过订阅ChatGPT使用CodeX，另一种则是使用自定义API接入Agent。前者只需要下载chatgpt即可，所以本节主要讨论后者，即自定义API的接入。

Claude Code#

目前几乎最完善、最好用的Agent是Claude Code。使用Claude Code的方法很简单，首先下载Claude Code：

Terminal window
brew install claude-code

下载安装完成后，可以执行：

Terminal window
claude -v

查询Claude Code版本号。

Claude Code是Anthropic对于自家模型Claude发布的一款Agent工具，如果需要接入第三方API，则需要修改一些配置：

  • 编辑或新增 ~/.claude.json 文件，将 hasCompletedOnboarding 字段的值设置为 true 并保存文件：

    {
      "hasCompletedOnboarding": true
    }

  • 编辑配置文件~/.claude/settings.json。

    {
        "env": {
            "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
            "ANTHROPIC_BASE_URL": "your_base_url",
            "ANTHROPIC_MODEL": "A",
            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "B",
            "ANTHROPIC_DEFAULT_SONNET_MODEL": "C",
            "ANTHROPIC_DEFAULT_OPUS_MODEL": "D",
            "CLAUDE_CODE_SUBAGENT_MODEL": "E",
            "CLAUDE_CODE_EFFORT_LEVEL": "max"
        }
    }

    将上述代码中YOUR_API_KEY、your_base_url及A~E分别改为第三方内容即可。

  • 如果想临时修改环境变量，也可以直接复制以下代码到终端：

    Terminal window
    export ANTHROPIC_BASE_URL=your_base_url
    export ANTHROPIC_AUTH_TOKEN=<YOUR_API_KEY
    export ANTHROPIC_MODEL=A
    export ANTHROPIC_DEFAULT_OPUS_MODEL=B
    export ANTHROPIC_DEFAULT_SONNET_MODEL=C
    export ANTHROPIC_DEFAULT_HAIKU_MODEL=D
    export CLAUDE_CODE_SUBAGENT_MODEL=E
    export CLAUDE_CODE_EFFORT_LEVEL=max

不过，Claude Code无论如何也会出现一个叫做“Claude Code URL Handler”的幽灵App在启动台，有些令人反感。此外，使用Claude很难统一管理多个API Key，因此如果使用第三方API接口并且追求干净，可以试试其他Angent工具，例如OpenCode。

OpenCode#

OpenCode的安装方式比Claude Code要简单得多，只需要执行：

Terminal window
brew install opencode

然后：

Terminal window
opencode

就能进入opencode界面了。在TUI界面提示下切换设置模型即可。

结语#

本台MacBook Air是七月初拿到手的，到现在八月中旬了，有不少软件都更新了，理应再改一改详细内容。像是现在DeepSeek Harness出来了，笔者非常喜欢，有潜力代替OpenCode，但一方面还是预览版，另一方面没有上brew，所以考虑再三没有放进去。当然，本文后续也会更新维护，包括一些更详细多配置、一些使用技巧、增加一些图片等等。但是目前不足之处，还请海涵。

macOS开荒指南
https://arslinear.com/p/V87P410Z/
作者
Arlyn
发布于
2026-08-16
许可协议
CC BY-NC-SA 4.0
Zotero自建WebDAV同步服务
© 2026 Arlyn. All Rights Reserved. / RSS / Sitemap
Powered by Astro & Fuwari