Walkthroughs

Claude / Workspace setup

Create a Claude Cowork Project from a Local Folder

Cowork lets Claude work inside a folder you choose on your computer. Attach the folder, approve access, add standing instructions, and reopen the project from Cowork whenever you need it.

Claude open3 minutesBeginner
An image-generated Claude file-permission dialog hero image with the Always allow button highlighted.

Use the local folder first, then save it as a Cowork project

Click `Work in a project`, choose a different folder, select `This Project`, and approve the folder access. That makes the folder active for the current session. To make it easy to reopen later, switch to Cowork, open Projects, create a new project from an existing folder, choose the same folder, add instructions, and click Create.

Attach the folder, approve access, and save it as a Cowork project

  1. 1

    The folder button sets Claude's working boundary

    Why
    Claude needs a folder boundary before it can work with local files. The project button in the composer is where you choose that boundary for the current session.
    Action
    In Claude, click `Work in a project` underneath the composer.
    Result
    Claude opens the project menu so you can choose where this session should work.
    An image-generated Claude composer screenshot with the Work in a project button highlighted.
  2. 2

    A different folder lets you point Claude at the real project

    Why
    You already have a folder on your computer, so you do not need Claude to create a new one just to begin.
    Action
    Choose `Choose a different folder` from the project menu.
    Result
    macOS opens the folder picker.
    Tip
    `Create new project` is useful when you want Claude to make a new folder. Pick `Choose a different folder` when the folder already exists.
    An image-generated Claude project menu screenshot with Choose a different folder highlighted.
  3. 3

    Pick the project folder itself, not the organizer around it

    Why
    The folder you choose is the folder Claude can work inside. If you keep many projects in one parent folder, select the specific project subfolder.
    Action
    In the folder picker, open `My Agent Projects` if you use that parent folder, select `This Project`, and confirm the picker.
    Result
    Claude asks whether it may access the selected folder.
    Tip
    The example names are placeholders. Use the real folder name for your project.
    An image-generated macOS folder picker screenshot with the This Project folder selected.
  4. 4

    Permission should match the folder you meant to share

    Why
    Claude can only work with local files after you grant folder access. The permission dialog is the moment to confirm you picked the right folder.
    Action
    If the dialog names the correct folder, click `Always allow`.
    Result
    Claude can use that folder without asking again each time you start work there.
    Tip
    `Always allow` gives Claude read and write access inside that folder. Use a narrower folder if the selected folder contains unrelated private material.
    An image-generated Claude file-permission dialog with the Always allow button highlighted.
  5. 5

    The active directory should show the folder name

    Why
    This quick check prevents you from asking Claude to work before it is pointed at the right local files.
    Action
    Look under the composer and confirm the folder button now says `This Project`.
    Result
    The folder is active for the current Claude session.
    An image-generated Claude composer screenshot showing This Project as the active directory.
  6. 6

    Cowork is where local projects live

    Why
    The folder session is useful right away. A saved Cowork project makes the setup reusable, with the same folder and instructions available later.
    Action
    Open Claude Desktop and click `Cowork`.
    Result
    Claude shows the Cowork workspace.
    An image-generated Claude Desktop sidebar screenshot with the Cowork tab highlighted.
  7. 7

    Projects turns the folder into a repeatable workspace

    Why
    The Projects view is where Claude stores named local workspaces, so you can return to the same folder without rebuilding the setup.
    Action
    In the Cowork sidebar, click `Projects`.
    Result
    The Projects page opens.
    An image-generated Claude Cowork sidebar screenshot with the Projects row highlighted.
  8. 8

    New project starts the saved workspace record

    Why
    A saved project gives the folder a name, instructions, and memory that belong to that area of work.
    Action
    Click `New project`.
    Result
    Claude opens the project creation dialog.
    An image-generated Claude Cowork Projects page with the New project button highlighted.
  9. 9

    Use the folder you already work from

    Why
    You are saving an existing local folder as a Cowork project, not asking Claude to create a new folder or import a Chat project.
    Action
    Choose `Use an existing folder`.
    Result
    Claude opens the folder-based project form.
    Tip
    `Import a project` brings a Claude Chat project into Cowork. `Use an existing folder` is the local-folder path.
    An image-generated Claude create-project modal with Use an existing folder highlighted.
  10. 10

    The folder field mounts the local files

    Why
    This field tells Cowork which files belong to the project.
    Action
    Click `Select a folder...`, choose `This Project`, and approve the folder picker.
    Result
    The form shows the folder path, the project name, and the instructions field.
    An image-generated Claude existing-folder form with the folder chooser highlighted.
  11. 11

    Instructions tell Claude how to behave every time

    Why
    Project instructions are the standing context Claude should remember whenever you open this project.
    Action
    Add important information about the project: what it is for, what files matter, what Claude should avoid changing, how you want answers formatted, and any privacy boundaries.
    Result
    Claude has the local folder plus the rules it should use while working there.
    Tip
    Keep instructions specific to the project. General preferences belong in your broader Claude instructions.
    An image-generated Claude existing-folder form with the project instructions field highlighted.
  12. 12

    The project stays one click away

    Why
    Once the project is created, you do not have to repeat the folder setup each time.
    Action
    Click `Create`. Later, open Cowork, click `Projects`, and choose `This Project` whenever you want Claude to work there.
    Result
    `This Project` appears as a saved Cowork project.
    Tip
    Cowork projects are local desktop projects. If you need a project shared through Claude Chat or teammates, use a Chat project deliberately instead.
    An image-generated Claude Cowork Projects page with the saved This Project card highlighted.