# 課前準備 for macOS

本頁整理課程當日前需要完成的所有準備事項，請在上課前確認每個步驟都完成。

---

## 需要創建的帳號

在開始安裝任何軟體之前，請先確認以下帳號都已經註冊並可以正常登入。

- **Claude** — <https://claude.ai>
- **GitHub** — <https://github.com>
- **AWS** — <https://aws.amazon.com>（需要先提供信用卡，但流量沒用超過不會收費）
- **Pencil.dev** — <https://www.pencil.dev>

---

## 需要安裝的軟體

請在課程前將以下軟體安裝完畢並確認可以正常開啟。
指令請都在**terminal**執行
### brew 套件管理器

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

### XCode CLI tool

xcode-select --install

### Microsoft Visual Studio Code

https://code.visualstudio.com/download
安裝套件：
`pencil.dev extension`
`Jupyter`
將code設定進環境變數
1. 開啟vscode
2. Cmd + Shift + P
3. 在上方的搜尋框輸入以下內容，並**點擊出現的選項**：

Shell Command: Install 'code' command in PATH

4.輸入密碼並把terminal重啟
### SourceTree for macOS

brew install --cask sourcetree

>有輸入mail的地方就把創github的那個mail填上去
### Docker Desktop
https://www.docker.com/products/docker-desktop/
>建議用github帳號登入
>要全程保持開啟狀態
---
>如果docker desktop 運行後電腦很卡可以參考附錄1
### Claude Desktop
https://claude.com/download
### Claude Code
在terminal輸入

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

### Pencil.dev Desktop(裝pencil之前需先安裝claude)
https://www.pencil.dev/downloads

### 安裝gh

brew install gh 

### uv

curl -LsSf https://astral.sh/uv/install.sh | sh

> 安裝完後請重開終端機
### AWS CLI v2

https://awscli.amazonaws.com/AWSCLIV2.pkg
> 都點繼續

## 需要執行的指令(在terminal)

### 產生 SSH Key

mkdir -p ~/.ssh
chmod 700 ~/.ssh
cd ~/.ssh
ssh-keygen -t ed25519 -C "[e-mail]"
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

> 將 `[e-mail]` 換成你自己的 email
> 遇到詢問檔案存放和設定密碼都直接按enter
> 產生後會出現 `id_ed25519`（私鑰）和 `id_ed25519.pub`（公鑰）兩個檔案
### 設定 AWS

aws configure

依序填入以下資訊：

AWS Access Key ID: （看下面）
AWS Secret Access Key: （看下面）
Default region name: us-west-2
Default output format: json

key ID以及Access Key取得方式
1. 打開aws <https://aws.amazon.com/tw/console/>並登入
2. 在左上搜尋欄輸入IAM並按下IAM
3. ctrl+F 搜尋**Quick Links**
4. 點擊 **我的安全身份碼**(找不到的話可以登入後使用這個連結<https://us-east-2.console.aws.amazon.com/iam/home?region=us-east-2#/security_credentials>)
5. 點擊建立存取金鑰
6. 建立後複製輸出的 **存取金鑰**->是Key ID,**私密存取金鑰** ->是Secret Access Key

### 設定 Git 全域資訊

git config --global user.email "[e-mail]"
git config --global user.name "Name"

> 將上面的 email 和 Name 換成你自己的資訊。

### 綁定 SSH 公鑰到 GitHub
1. 複製公鑰內容：

cat ~/.ssh/id_ed25519.pub

2. 前往 GitHub → **Settings** → **SSH and GPG keys** → **New SSH key**
3. 貼上複製的內容 → 點擊 **Add SSH key**

### 設定mcp
1. 打開claude desktop
2. 設定
3. Developer
4. github
5. Edit Config
6. 把your token填上去(如果沒有github項就把這段貼在pencil下面 如下,複製範圍如附圖)

>如果有報錯可能是少了 ,

    "pencil": {
      "command": "/Applications/Pencil.app/Contents/Resources/app.asar.unpacked/out/mcp-server-darwin-arm64",
      "args": [
        "--app",
        "desktop"
      ],
      "env": {}
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ]
    }


>1. 前往 GitHub → **Settings** → **Developer Settings** → **Personal access tokens**
>2. 選擇 **Tokens (classic)** → **Generate new token (classic)**
>3. 選90天,勾選所有權限
>4. 複製產生的 token，填入上方設定檔的 `YOUR_TOKEN`

## Check 確認安裝結果

全部裝完後，請在 Terminal 執行以下指令，確認每個工具都有正確回傳版本號。

### 軟體安裝確認

code --version
docker --version
claude --version
uv --version
aws --version
git --version
gh --version

### SSH到Github確認

ssh -T [e-mail]

>要回傳HI! \...\...

---

## 附錄（先不要用）
### 附錄1. Docker Desktop替代 orbstack
刪除docker desktop並下載orbstack

brew install orbstack

### 附錄2. 使用本地 Ollama 作為 Anthropic API

若要測試 將 Claude Code 指向本地的 Ollama 服務：

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434