mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-31 16:33:34 +08:00
c2cd615824
The site had drifted from the product. Every screenshot predated the v0.5.0 UI redesign, the reading experience shipped no search and no syntax highlighting, and a third of the pages were internal process artefacts — migration task lists addressed to agentic workers, a release runbook, a proposal marked "historical". Reorganise around the only two people who read this: someone getting the desktop app running for the first time, and someone reading the source. Five sections replace nine — start / desktop / im / cli / internals — and the pages that served neither reader are gone. Site rewrite: - Palette lifted from the desktop app's 「纸·墨·印」 themes, so the site and the product read as one thing. Light mirrors 纯白, dark mirrors 墨夜, and dark mode exists at all now. - Fonts are self-hosted. The old @import from Google Fonts is unreachable from mainland China, which left every heading in a fallback serif; it also only requested weight 600 while the CSS asked for 900, so Latin and CJK in the same heading disagreed. - Docs were shipped as one 968KB manifest downloaded on every page view. Split into a 32KB index plus one lazily imported chunk per page; the entry bundle is now 101KB gzipped. - Add search, syntax highlighting, per-route meta with canonical and hreflang, a sitemap, and an error boundary. Replace the 44vh mobile sidebar with a drawer. - Image dimensions are read at build time and written into the tag, so lazy images reserve their space instead of collapsing. Screenshots are recaptured from a real v0.5.0 build against a clean demo project, with tokens, QR codes and paired accounts redacted. The previous set is deleted rather than kept alongside. Routes follow file paths, so the restructure would have broken every inbound link; 37 old paths redirect, in both languages. The PR policy gate and CODEOWNERS also hardcoded docs/guide/contributing.md. Verified: check:docs 78 pages / 323 links / 0 problems, check:policy 127 pass. Walked every route at 1440 and 390 in both themes for overflow, contrast, keyboard reachability and focus management.
104 lines
6.0 KiB
Markdown
104 lines
6.0 KiB
Markdown
---
|
|
title: Run your first session
|
|
nav_title: First session
|
|
description: Pick a folder, set permissions, state a goal, watch it edit files, review the diff.
|
|
order: 3
|
|
---
|
|
|
|
# Run your first session
|
|
|
|
Your model is connected. Now let it actually do something. Find a project you don't mind touching — ideally one under Git, so anything it breaks is one command away from being undone.
|
|
|
|
## 1. New session, pick the project folder
|
|
|
|
Click "New session" in the sidebar, or press `Cmd/Ctrl + N`.
|
|
|
|
|
|
|
|
Look at the row along the bottom of the composer: `+` for attachments, then **permission mode**, **launch location**, **model and effort**, and finally "Run".
|
|
|
|
Start with the **launch location** pill in the middle (it reads `task-board / main` in the screenshot) and pick a project folder. This sets the agent's boundary: reading files, searching, running commands, checking Git status — all of it happens inside this directory and nowhere else.
|
|
|
|
If the folder is a Git repository, the same pill also lets you choose a branch and whether to use an isolated worktree. Skip the worktree for now — working directly in the folder makes the changes easiest to follow.
|
|
|
|
## 2. Permissions: start with "Ask permissions"
|
|
|
|
Click the permission mode button and all five levels open up.
|
|
|
|
|
|
|
|
| Mode | What the app says it does |
|
|
|---|---|
|
|
| **Ask permissions** | Confirm file edits and higher-risk commands when CLI asks |
|
|
| **Auto accept edits** | Claude writes to disk without asking |
|
|
| **Auto mode** (enable once) | Claude reviews tool calls and runs actions it considers safe |
|
|
| **Plan mode** | Architecture & reasoning only, no files |
|
|
| **Bypass permissions** (high risk) | Full tool access for shell and file system |
|
|
|
|
**Leave it on "Ask permissions" for your first run.** Every file write and every risky command stops and asks, so you can see exactly what it intends to do. Loosen it later, once you know how it behaves.
|
|
|
|
What the other four are for:
|
|
|
|
- **Auto accept edits** opens up file writes only; commands still prompt. Good once you're confident about the scope of the change.
|
|
- **Auto mode** has to be enabled once by hand. After that Claude reviews each tool call itself, running what it judges safe and blocking what it judges risky. **It reduces prompts; it does not guarantee safety.** Use it in isolated environments only.
|
|
- **Plan mode** never touches a file — it only produces a plan. Use it for read-only investigation, or to make it explain its approach before it starts.
|
|
- **Bypass permissions** removes every check. Shell and filesystem are wide open, it can delete anything, and it won't ask. **Never use it in a directory holding production credentials, personal data, or anything not under version control.**
|
|
|
|
:::danger
|
|
"Bypass permissions" is not just a slightly looser "Auto mode". Auto mode at least keeps Claude's own review in the loop; bypass removes even that.
|
|
:::
|
|
|
|
Permission modes are locked while a turn is running — what the UI shows and what's actually enforced have to match. Wait for the turn to finish, or press `Cmd/Ctrl + .` to stop it.
|
|
|
|
## 3. Say what you want
|
|
|
|
Plain language is fine; you don't need to write a spec. What matters is that the goal is **verifiable** — that you'll know how to check whether it got there.
|
|
|
|
For example:
|
|
|
|
```text
|
|
Read this project, then add a "sort by due date" toggle to the task list.
|
|
Put it to the right of the heading; clicking it switches between manual
|
|
order and due date, with undated items last. Tell me which files you changed.
|
|
```
|
|
|
|
If you'd rather ease in, ask for something read-only first: "Read this project and tell me what it does and how to start it. Don't change anything."
|
|
|
|
Press `Enter` to send (`Shift + Enter` for a newline).
|
|
|
|
## 4. Watch it work
|
|
|
|
|
|
|
|
It orients itself before it starts editing, and you'll see several kinds of card go by:
|
|
|
|
- **Tool call cards** ("Searched files, ran one command, read 4 files") — collapsed by default; expand to see exactly what it read and ran.
|
|
- **Thinking blocks** — its reasoning about the next step.
|
|
- **Permission prompts** ("Allow Claude to Edit index.html?") — these stop and wait for you. The card includes a preview of the change: green for added lines, red for removed. **Read the diff before you decide.**
|
|
|
|
Three buttons:
|
|
|
|
- **Allow** — this one time only.
|
|
- **Allow for session** — stop asking about this kind of operation for the rest of the session. Once the scope is clear, this saves a long string of repeated clicks.
|
|
- **Deny** — send it back. It will try a different approach, or ask you for more information.
|
|
|
|
To stop mid-run, use the stop button at the bottom right of the composer or press `Cmd/Ctrl + .`.
|
|
|
|
## 5. Review file by file
|
|
|
|
After each edit lands, the session shows an **inline diff**: the file path, an `+8 / -3` line count, and old and new lines side by side with syntax highlighting. That's the right view for following a single change as it happens.
|
|
|
|
Once a turn finishes and the changes pile up, open the **workspace** panel on the right ("Show Workspace" at the top right of the tab bar). It collects everything changed this turn into a list you can open for a full review, comment on specific lines, and send those comments — with their code location attached — straight back into the composer for another round.
|
|
|
|
The full workspace walkthrough is in [Workspace](../desktop/workspace.md).
|
|
|
|
:::warning
|
|
Denied edits never reach the disk, but the disk and `git diff` are the only source of truth. Run `git status` and `git diff` yourself before you ship anything — don't take the UI's word for it.
|
|
:::
|
|
|
|
## Next
|
|
|
|
- See what else it can do — [desktop feature map](../desktop/index.md)
|
|
- Keep going from your phone — [Phone and IM handoff](../desktop/remote.md)
|
|
- Something got stuck — [Won't install, won't open, won't connect](./troubleshooting.md)
|