工具Tools
AI 工具:ClaudeAI tools: Claude
公司目前使用的 AI 工具是 Claude。除了一般聊天問答,它還能透過 MCP(Model Context Protocol)直接連上 Trello、Redmine、GitHub、Outlook、Teams 等工作系統 —— 你用一句話下指令,它幫你查資料、整理重點,甚至在卡片上留言、在頻道發文。這頁說明怎麼安裝、怎麼接上工作工具、以及日常怎麼用。The company's AI tool is Claude. Beyond chat, it can connect directly to work systems like Trello, Redmine, GitHub, Outlook and Teams through MCP (Model Context Protocol) — give it one instruction and it looks things up, summarizes them, and can even comment on cards or post in channels. This page covers installing it, connecting work tools, and everyday use.
1. 先選要用哪一種1. Pick how you'll use it
| 形式Form | 適合誰Best for | 要安裝嗎Install? |
|---|---|---|
| claude.ai(網頁) (web) | 所有人。問答、整理文件、寫信、透過 Connectors 查 Trello / Outlook / TeamsEveryone. Q&A, documents, emails, and Trello / Outlook / Teams via Connectors | 不用,瀏覽器打開登入即可No — just sign in from a browser |
| Claude Desktop | 想要獨立視窗、拖拉檔案的人。內含 Code 分頁,等於 Claude Code 的圖形版Anyone who wants a separate window and drag-and-drop files. Includes a Code tab — Claude Code with a GUI | 要(Windows / macOS;Linux 為 beta)Yes (Windows / macOS; Linux in beta) |
| Claude Code(終端機) (terminal) | 工程師、QA。可以讀寫本機檔案、跑指令、改程式、接本機 MCPEngineers and QA. Reads and edits local files, runs commands, changes code, uses local MCPs | 要,見下方第 2 節Yes — see section 2 |
| VS Code / JetBrains 擴充套件 extension | 習慣在 IDE 裡工作的工程師Engineers who live in an IDE | 要,裝擴充套件(JetBrains 另需先裝 Claude Code)Yes — the extension (JetBrains also needs Claude Code installed) |
一律用公司配發的 Claude 帳號登入(不要用個人帳號),這樣才看得到公司共用的 Connectors,資料也受公司方案的隱私條款保護。還沒有帳號請找主管申請。Always sign in with your company-issued Claude account (not a personal one) — that's how you get the company's shared Connectors, and your data stays under the company plan's privacy terms. Ask your manager if you don't have one yet.
2. 安裝 Claude Code(依作業系統)2. Install Claude Code (by OS)
開 PowerShell,貼上(建議):Open PowerShell and paste (recommended):
irm https://claude.ai/install.ps1 | iex
或用 WinGet:Or with WinGet:
winget install Anthropic.ClaudeCode
建議另外安裝 Git for Windows,Claude Code 才能使用 Bash 跑指令(沒裝會改用 PowerShell)。Installing Git for Windows is recommended so Claude Code can use Bash (it falls back to PowerShell otherwise).
開「終端機」,貼上(建議,會自動更新):Open Terminal and paste (recommended; auto-updates):
curl -fsSL https://claude.ai/install.sh | bash
或用 Homebrew(不會自動更新,要自己跑 brew upgrade claude-code):Or with Homebrew (no auto-update; run brew upgrade claude-code yourself):
brew install --cask claude-code
curl -fsSL https://claude.ai/install.sh | bash
Debian / Fedora / RHEL / Alpine 也可以用 apt / dnf / apk 安裝,指令見官方文件。Debian / Fedora / RHEL / Alpine can also use apt / dnf / apk — see the official docs.
在 WSL 的終端機裡用 Linux 的安裝方式,不需要 Git for Windows:Inside the WSL terminal use the Linux installer; Git for Windows isn't needed:
curl -fsSL https://claude.ai/install.sh | bash
裝好之後After installing
- 確認版本:
claude --version,看到版本號就成功。顯示「找不到指令」的話,重開終端機,或把安裝路徑加進 PATH。Check the version:claude --version— a version number means success. If the command isn't found, reopen the terminal or add the install folder to PATH. - 登入:進到你的專案資料夾,輸入
claude,第一次會開瀏覽器請你登入(選 Claude 帳號,用公司帳號)。之後要換帳號,在 Claude Code 裡輸入/login。Sign in: go to your project folder and typeclaude. The first time, a browser opens for sign-in (choose the Claude account option, with your company account). To switch accounts later, type/logininside Claude Code. - 更新:用官方安裝指令裝的會自動更新;Homebrew / WinGet 要自己跑
brew upgrade claude-code/winget upgrade Anthropic.ClaudeCode。Update: the official installer auto-updates; for Homebrew / WinGet runbrew upgrade claude-code/winget upgrade Anthropic.ClaudeCode.
其他形式Other forms
- Claude Desktop:從 claude.ai/download 下載(Windows x64 / ARM64、macOS)。登入後就能用,裡面的 Code 分頁不用另外裝 Claude Code。Claude Desktop: download from claude.ai/download (Windows x64 / ARM64, macOS). Sign in and go — its Code tab doesn't need a separate Claude Code install.
- VS Code / Cursor:擴充套件頁(
Ctrl+Shift+X)搜尋「Claude Code」安裝,需要 VS Code 1.94 以上。VS Code / Cursor: search "Claude Code" in Extensions (Ctrl+Shift+X); needs VS Code 1.94+. - JetBrains(IntelliJ、PyCharm、WebStorm…):從 Marketplace 安裝「Claude Code」,要先照上面裝好 Claude Code。JetBrains (IntelliJ, PyCharm, WebStorm…): install "Claude Code" from the Marketplace; install Claude Code first as above.
- 網頁版 Claude Code:claude.ai/code,不用安裝,在雲端環境跑。Claude Code on the web: claude.ai/code — no install, runs in the cloud.
3. 接上工作工具(MCP)3. Connect work tools (MCP)
MCP 是讓 Claude 連上外部系統的「插頭」。接上之後,Claude 就能代替你在那個系統裡查資料、寫東西 —— 用的是你自己的帳號權限,你看不到的它也看不到。接法有兩種:MCP is the "plug" that connects Claude to outside systems. Once connected, Claude can read and write in that system for you — using your own account's permissions; whatever you can't see, it can't either. There are two ways to connect:
A. Connectors(網頁 / Desktop,最簡單)A. Connectors (web / Desktop — easiest)
在 claude.ai 或 Claude Desktop 打開 Settings → Connectors(或對話框旁的 +),點想用的服務 → Connect → 用你在那個服務的帳號授權。公司管理員已經設定好的 Connectors 會直接出現在清單裡。用同一個帳號登入 Claude Code 時,這些 Connectors 也會一起帶過去。In claude.ai or Claude Desktop open Settings → Connectors (or the + next to the prompt box), pick a service → Connect → authorize with your account on that service. Connectors the company admin has set up appear in the list. When you sign in to Claude Code with the same account, these Connectors come along.
| 工作上常用的Common at work | 可以做什麼What it can do |
|---|---|
| Trello | 搜尋卡片、讀卡片內容與留言、在卡片留言、更新卡片、勾 checklistSearch cards, read card details and comments, comment, update cards, tick checklists |
| Microsoft 365 | Outlook:搜尋信件、擬草稿、回信、查行事曆與空檔;Teams:讀頻道與聊天、在頻道發文或回覆;SharePoint:找檔案Outlook: search mail, draft and reply, check calendars and free time; Teams: read channels and chats, post or reply in channels; SharePoint: find files |
| GitHub | 查 PR / Issue / commit、讀程式碼、在 PR 留言Look up PRs / issues / commits, read code, comment on PRs |
| Notion、Google Drive | 搜尋與讀取文件Search and read documents |
B. 在 Claude Code 自己加(本機 MCP)B. Add your own in Claude Code (local MCP)
Connectors 清單裡沒有的系統(例如 Redmine),可以在 Claude Code 用 claude mcp add 加。金鑰要用你自己的,在該系統的個人設定頁產生(Redmine:My account → API access key;GitHub:Settings → Developer settings → Personal access tokens)。For systems not in the Connectors list (e.g. Redmine), add them in Claude Code with claude mcp add. Use your own key, generated from that system's personal settings (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# Redmine (--scope user = available in all your projects)
claude mcp add --scope user redmine \
-e REDMINE_URL=<company Redmine URL> -e REDMINE_API_KEY=<your key> \
-- npx -y @thelabnyc/redmine-mcp
# GitHub (if you're not using the Connector)
claude mcp add --scope user github \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your token> \
-- npx -y @modelcontextprotocol/server-github
加完在 Claude Code 裡輸入 /mcp,可以看每個 MCP 是否連上、需要授權的在這裡登入。npx 需要先裝 Node.js。Afterwards type /mcp in Claude Code to see whether each MCP is connected and to sign in to those that need it. npx needs Node.js installed.
金鑰只放在自己電腦上。不要把 token / API key 貼進對話、寫進專案的 .mcp.json 或任何會進 git 的檔案,也不要分享給同事 —— 每個人用自己的。公司另有內部自建的 MCP,需要時請向主管申請,不在這裡列出。Keep keys on your own machine. Never paste tokens / API keys into a chat, a project's .mcp.json, or any file that goes into git, and don't share them — everyone uses their own. The company also has internal MCPs; ask your manager if you need them — they're not listed here.
4. 怎麼下指令:實際例子4. How to ask: real examples
直接用中文描述你要什麼就好,不用記指令。Claude 會自己判斷要用哪個 MCP。Just describe what you want in plain language — no commands to memorize. Claude picks the right MCP itself.
| 想做的事Goal | 可以這樣說Try saying |
|---|---|
| 查 TrelloSearch Trello | 「幫我找 LOOP-TEAM 看板上這週移到 QA 的卡片,列出卡號、標題和負責人」"Find cards moved to QA this week on the LOOP-TEAM board; list number, title and owner" |
| 在卡片留言Comment on a card | 「在 LT700 留言:stg 已驗證通過,附上測試步驟摘要。先給我看內容再送出」"Comment on LT700: verified on stg, with a summary of the test steps. Show me the text before posting" |
| 查 RedmineSearch Redmine | 「列出指派給我、狀態是 Feedback 的 issue,依優先度排序」"List issues assigned to me in Feedback status, sorted by priority" |
| Teams 發文Post in Teams | 「把今天 auto_cl 的測試結果整理成三行摘要,草擬一則要發在 QA 頻道的訊息給我確認」"Summarize today's auto_cl results in three lines and draft a QA channel post for me to review" |
| 整理信件Triage email | 「找出這週寄給我、跟 Ava 有關但我還沒回的信,每封一句重點」"Find emails to me this week about Ava that I haven't answered; one line each" |
| 看 PRReview a PR | 「這個 PR 改了什麼?有沒有會影響 Transfer 的地方?」(貼上 PR 連結)"What does this PR change? Anything affecting Transfer?" (paste the PR link) |
| 串起來用Chain them | 「讀 LT710 的卡片描述,去 GitHub 找對應的 PR,整理成測試重點,再草擬一則 Trello 留言」"Read card LT710, find the matching GitHub PR, turn it into test points, then draft a Trello comment" |
會寫入的動作(留言、發文、寄信、改狀態)其他人都看得到,而且不一定能收回。養成習慣:請它「先給我看內容再送出」;Claude Code 執行前也會跳出確認,看清楚再按允許。Write actions (comments, posts, emails, status changes) are visible to others and can't always be undone. Make it a habit to ask "show me before sending"; Claude Code also asks for confirmation first — read it before you allow it.
5. Claude Code 常用操作5. Claude Code basics
| 操作Action | 說明What it does |
|---|---|
/init | 在專案裡建立 CLAUDE.md:寫專案慣例、怎麼跑測試、注意事項,Claude 每次開始都會先讀Creates CLAUDE.md in the project — conventions, how to run tests, caveats; Claude reads it at the start of every session |
Shift+Tab | 切換權限模式:每次都問(預設)/ 自動接受檔案修改 / Plan(先提計畫,你同意才動手)Switch permission modes: ask every time (default) / auto-accept edits / Plan (proposes a plan, acts only after you approve) |
@檔名 | 把檔案內容帶進問題,例如 @tests/test_ip.py 這支在測什麼?Pulls a file into your question, e.g. @tests/test_ip.py what does this test? |
!指令 | 直接跑一行 shell 指令,結果會留在對話裡,例如 !git statusRuns a shell command directly; output stays in the conversation, e.g. !git status |
Esc | 中斷 Claude 正在做的事Interrupts what Claude is doing |
/mcp、/status | 看 MCP 連線狀態;看目前帳號、模型、版本MCP connection status; current account, model and version |
/help | 列出所有指令Lists all commands |
6. 使用守則6. Ground rules
- 不要貼機密:密碼、token、客戶個資、完整的客戶名單不要貼進對話。No secrets: don't paste passwords, tokens, customer personal data or full customer lists into a chat.
- 結果要查證:AI 會出錯。關於系統行為的結論,請它附上出處(哪支程式、哪張卡、哪封信),重要的自己點開確認。Verify: AI makes mistakes. For conclusions about system behavior, ask for the source (which code, card or email) and open the important ones yourself.
- 寫入前先看:留言、發文、寄信、改狀態,先看內容再送出(見第 4 節)。Look before writing: review comments, posts, emails and status changes before they go out (see section 4).
- prod 謹慎:請 AI 操作 prod 環境或真實客戶資料前,先在 stg 試過。Careful with prod: try it on stg before letting AI act on prod or real customer data.
官方文件:快速上手 · MCP · CLAUDE.mdOfficial docs: Quickstart · MCP · CLAUDE.md