ContactLoop

內部上手指南 · 請先登入

沒有密碼?請向管理員索取。

工具

AI 工具:Claude

公司目前使用的 AI 工具是 Claude。除了一般聊天問答,它還能透過 MCP(Model Context Protocol)直接連上 Trello、Redmine、GitHub、Outlook、Teams 等工作系統 —— 你用一句話下指令,它幫你查資料、整理重點,甚至在卡片上留言、在頻道發文。這頁說明怎麼安裝、怎麼接上工作工具、以及日常怎麼用。

1. 先選要用哪一種

形式適合誰要安裝嗎
claude.ai(網頁)所有人。問答、整理文件、寫信、透過 Connectors 查 Trello / Outlook / Teams不用,瀏覽器打開登入即可
Claude Desktop想要獨立視窗、拖拉檔案的人。內含 Code 分頁,等於 Claude Code 的圖形版要(Windows / macOS;Linux 為 beta)
Claude Code(終端機)工程師、QA。可以讀寫本機檔案、跑指令、改程式、接本機 MCP要,見下方第 2 節
VS Code / JetBrains 擴充套件習慣在 IDE 裡工作的工程師要,裝擴充套件(JetBrains 另需先裝 Claude Code)
🔑

一律用公司配發的 Claude 帳號登入(不要用個人帳號),這樣才看得到公司共用的 Connectors,資料也受公司方案的隱私條款保護。還沒有帳號請找主管申請。

2. 安裝 Claude Code(依作業系統)

開 PowerShell,貼上(建議):

irm https://claude.ai/install.ps1 | iex

或用 WinGet:

winget install Anthropic.ClaudeCode

建議另外安裝 Git for Windows,Claude Code 才能使用 Bash 跑指令(沒裝會改用 PowerShell)。

裝好之後

  1. 確認版本:claude --version,看到版本號就成功。顯示「找不到指令」的話,重開終端機,或把安裝路徑加進 PATH。
  2. 登入:進到你的專案資料夾,輸入 claude,第一次會開瀏覽器請你登入(選 Claude 帳號,用公司帳號)。之後要換帳號,在 Claude Code 裡輸入 /login。
  3. 更新:用官方安裝指令裝的會自動更新;Homebrew / WinGet 要自己跑 brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode。

其他形式

  • Claude Desktop:從 claude.ai/download 下載(Windows x64 / ARM64、macOS)。登入後就能用,裡面的 Code 分頁不用另外裝 Claude Code。
  • VS Code / Cursor:擴充套件頁(Ctrl+Shift+X)搜尋「Claude Code」安裝,需要 VS Code 1.94 以上。
  • JetBrains(IntelliJ、PyCharm、WebStorm…):從 Marketplace 安裝「Claude Code」,要先照上面裝好 Claude Code。
  • 網頁版 Claude Code:claude.ai/code,不用安裝,在雲端環境跑。

3. 接上工作工具(MCP)

MCP 是讓 Claude 連上外部系統的「插頭」。接上之後,Claude 就能代替你在那個系統裡查資料、寫東西 —— 用的是你自己的帳號權限,你看不到的它也看不到。接法有兩種:

A. Connectors(網頁 / Desktop,最簡單)

在 claude.ai 或 Claude Desktop 打開 Settings → Connectors(或對話框旁的 +),點想用的服務 → Connect → 用你在那個服務的帳號授權。公司管理員已經設定好的 Connectors 會直接出現在清單裡。用同一個帳號登入 Claude Code 時,這些 Connectors 也會一起帶過去。

工作上常用的可以做什麼
Trello搜尋卡片、讀卡片內容與留言、在卡片留言、更新卡片、勾 checklist
Microsoft 365Outlook:搜尋信件、擬草稿、回信、查行事曆與空檔;Teams:讀頻道與聊天、在頻道發文或回覆;SharePoint:找檔案
GitHub查 PR / Issue / commit、讀程式碼、在 PR 留言
Notion、Google Drive搜尋與讀取文件

B. 在 Claude Code 自己加(本機 MCP)

Connectors 清單裡沒有的系統(例如 Redmine),可以在 Claude Code 用 claude mcp add 加。金鑰要用你自己的,在該系統的個人設定頁產生(Redmine:My account → API access key;GitHub:Settings → Developer settings → Personal access tokens)。

# Redmine(--scope user = 你所有專案都能用)
claude mcp add --scope user redmine \
  -e REDMINE_URL=<公司 Redmine 網址> -e REDMINE_API_KEY=<你的金鑰> \
  -- npx -y @thelabnyc/redmine-mcp

# GitHub(沒用 Connector 的話)
claude mcp add --scope user github \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<你的 token> \
  -- npx -y @modelcontextprotocol/server-github

加完在 Claude Code 裡輸入 /mcp,可以看每個 MCP 是否連上、需要授權的在這裡登入。npx 需要先裝 Node.js。

⚠️

金鑰只放在自己電腦上。不要把 token / API key 貼進對話、寫進專案的 .mcp.json 或任何會進 git 的檔案,也不要分享給同事 —— 每個人用自己的。公司另有內部自建的 MCP,需要時請向主管申請,不在這裡列出。

4. 怎麼下指令:實際例子

直接用中文描述你要什麼就好,不用記指令。Claude 會自己判斷要用哪個 MCP。

想做的事可以這樣說
查 Trello「幫我找 LOOP-TEAM 看板上這週移到 QA 的卡片,列出卡號、標題和負責人」
在卡片留言「在 LT700 留言:stg 已驗證通過,附上測試步驟摘要。先給我看內容再送出」
查 Redmine「列出指派給我、狀態是 Feedback 的 issue,依優先度排序」
Teams 發文「把今天 auto_cl 的測試結果整理成三行摘要,草擬一則要發在 QA 頻道的訊息給我確認」
整理信件「找出這週寄給我、跟 Ava 有關但我還沒回的信,每封一句重點」
看 PR「這個 PR 改了什麼?有沒有會影響 Transfer 的地方?」(貼上 PR 連結)
串起來用「讀 LT710 的卡片描述,去 GitHub 找對應的 PR,整理成測試重點,再草擬一則 Trello 留言」
✋

會寫入的動作(留言、發文、寄信、改狀態)其他人都看得到,而且不一定能收回。養成習慣:請它「先給我看內容再送出」;Claude Code 執行前也會跳出確認,看清楚再按允許。

5. Claude Code 常用操作

操作說明
/init在專案裡建立 CLAUDE.md:寫專案慣例、怎麼跑測試、注意事項,Claude 每次開始都會先讀
Shift+Tab切換權限模式:每次都問(預設)/ 自動接受檔案修改 / Plan(先提計畫,你同意才動手)
@檔名把檔案內容帶進問題,例如 @tests/test_ip.py 這支在測什麼?
!指令直接跑一行 shell 指令,結果會留在對話裡,例如 !git status
Esc中斷 Claude 正在做的事
/mcp、/status看 MCP 連線狀態;看目前帳號、模型、版本
/help列出所有指令

6. 使用守則

  • 不要貼機密:密碼、token、客戶個資、完整的客戶名單不要貼進對話。
  • 結果要查證:AI 會出錯。關於系統行為的結論,請它附上出處(哪支程式、哪張卡、哪封信),重要的自己點開確認。
  • 寫入前先看:留言、發文、寄信、改狀態,先看內容再送出(見第 4 節)。
  • prod 謹慎:請 AI 操作 prod 環境或真實客戶資料前,先在 stg 試過。

官方文件:快速上手 · MCP · CLAUDE.md