--- title: "Choose between Claude Projects and Claude Code by where your files live" description: "Compare Claude Projects and Claude Code by file access, context use, workflow, and memory design, and find the signal that you have outgrown Projects." canonical: "https://scalewithsearch.com/articles/claude-projects-vs-claude-code" date: "2026-01-28" modified: "2026-09-25" --- ## Site navigation - [Scale With Search](https://scalewithsearch.com/) - Real estate - Real estate - [Real estate](https://scalewithsearch.com/for/real-estate) - Work - Start here - [Send your brief](https://scalewithsearch.com/work#send-your-brief) - [Prepare your six-question brief](https://scalewithsearch.com/work#prepare-your-six-question-brief) - Build - [Site build, content library with SEO, signal desk](https://scalewithsearch.com/work) - For your business - Trades and home services - [Auto body and collision shops](https://scalewithsearch.com/for/auto-body-and-collision-shops) - [Foundation and home repair contractors](https://scalewithsearch.com/for/foundation-and-home-repair) - [Garage door and fencing contractors](https://scalewithsearch.com/for/garage-door-and-fencing-contractors) - [HVAC contractors](https://scalewithsearch.com/for/hvac-contractors) - [Janitorial and commercial cleaning companies](https://scalewithsearch.com/for/janitorial-and-commercial-cleaning) - [Locksmiths](https://scalewithsearch.com/for/locksmiths) - [Moving companies](https://scalewithsearch.com/for/moving-companies) - [Pest control companies](https://scalewithsearch.com/for/pest-control-companies) - [Plumbing and electrical contractors](https://scalewithsearch.com/for/plumbing-and-electrical-contractors) - [Restoration and water or fire damage companies](https://scalewithsearch.com/for/restoration-and-water-fire-damage) - [Roofing companies](https://scalewithsearch.com/for/roofing-companies) - [Towing companies](https://scalewithsearch.com/for/towing-companies) - [Tree services and landscaping companies](https://scalewithsearch.com/for/tree-services-and-landscaping) - [Solar installers](https://scalewithsearch.com/for/solar-installation) - [General contractors](https://scalewithsearch.com/for/general-contractors-and-construction) - [Paving, concrete, and flooring contractors](https://scalewithsearch.com/for/paving) - Practices and professional services - [Bookkeeping and tax practices](https://scalewithsearch.com/for/bookkeeping-and-tax-practices) - [Dental practices](https://scalewithsearch.com/for/dental-practices) - [Family and criminal defense law firms](https://scalewithsearch.com/for/family-and-criminal-defense-law-firms) - [Med spas and aesthetics practices](https://scalewithsearch.com/for/med-spas-and-aesthetics) - [Personal injury law firms](https://scalewithsearch.com/for/personal-injury-law-firms) - [Veterinary clinics](https://scalewithsearch.com/for/veterinary-clinics) - [Gyms and fitness studios](https://scalewithsearch.com/for/fitness) - [Therapy and outpatient health practices](https://scalewithsearch.com/for/therapy-and-outpatient-health) - [Medical billing companies](https://scalewithsearch.com/for/medical-billing) - [Insurance agencies](https://scalewithsearch.com/for/insurance-agencies) - [Financial advisors](https://scalewithsearch.com/for/financial-advisors) - [Property management companies](https://scalewithsearch.com/for/property-management) - [Recruiting and staffing agencies](https://scalewithsearch.com/for/recruiting-and-staffing) - [Architects and interior designers](https://scalewithsearch.com/for/architects-and-interior-designers) - [Logistics and supply chain companies](https://scalewithsearch.com/for/logistics-and-supply-chain) - Agencies, MSPs, and manufacturing - [IT and managed service providers](https://scalewithsearch.com/for/it-and-managed-service-providers) - [Machine shops and precision manufacturers](https://scalewithsearch.com/for/machine-shops-and-precision-manufacturing) - [Marketing agencies and freelancers](https://scalewithsearch.com/for/marketing-agencies-and-freelancers) - [SEO agencies and consultants](https://scalewithsearch.com/for/seo-agencies-and-consultants) - [Small manufacturers and fabricators](https://scalewithsearch.com/for/small-manufacturers-and-fabricators) - Restaurants, shops, studios, and nonprofits - [Restaurants and hospitality businesses](https://scalewithsearch.com/for/restaurants-and-hospitality) - [Retail stores and ecommerce sellers](https://scalewithsearch.com/for/retail-and-ecommerce) - [Photographers, event planners, and travel agents](https://scalewithsearch.com/for/photographers) - [Churches and nonprofits](https://scalewithsearch.com/for/churches-and-nonprofits) - [All industries](https://scalewithsearch.com/for/) - Learn - For your office - [Office job guides](https://scalewithsearch.com/guides/) - [Browser calculators](https://scalewithsearch.com/tools/) - Start here - [How it works](https://scalewithsearch.com/how-it-works) - [Free Starter Kit](https://scalewithsearch.com/kit/business-memory-starter-kit.zip) - [Synthetic specimen](https://scalewithsearch.com/specimen/working-session-specimen.zip) - Guides - [The Complete Guide to Business Memory for AI Agents](https://scalewithsearch.com/articles/business-memory-for-ai-agents-guide) - [The Complete Small-Business Guide to AI Agent Governance](https://scalewithsearch.com/articles/ai-agent-governance-guide-small-business) - [The Complete Guide to Leaving Vendor AI Memory](https://scalewithsearch.com/articles/leaving-vendor-ai-memory-guide) - Articles by cluster - [Business memory](https://scalewithsearch.com/articles/business-memory-for-ai-agents-guide) - [Agent governance](https://scalewithsearch.com/articles/ai-agent-governance-guide-small-business) - [Migration and ownership](https://scalewithsearch.com/articles/leaving-vendor-ai-memory-guide) - For machines - [llms.txt](https://scalewithsearch.com/llms.txt) - [llms-full.txt](https://scalewithsearch.com/llms-full.txt) - [Machine view](https://scalewithsearch.com/?view=machine) - Company - Evidence - [Proof](https://scalewithsearch.com/proof) - Company - [About](https://scalewithsearch.com/about) # Choose between Claude Projects and Claude Code by where your files live. You keep reference files for your business, and you want Claude to use them in every conversation. Claude Projects and Claude Code both give Claude context beyond one message. Projects does it through the web interface with file uploads. Claude Code connects to the files on your machine. They are not two versions of one product. They are different tools for different problems. This article compares what each one does and what each one costs you in effort. It also finds the point where the limits of Projects start to block your work. The source observation for this article dates from January 2026. Anthropic changes plan limits and features, so check the current numbers in your own account before you plan around them. ## Know what Claude Projects gives you A Claude Project is a workspace inside the Claude web interface. You create the project, upload files, and write project instructions. Claude refers to those files and instructions in each conversation inside the project. Anthropic's help pages listed these limits when this article was checked on 2026.09.25: | Limit | Listed value | |---|---| | Size per project file | 30 MB | | Files per project | No fixed count; the files must fit in the context window | | Project knowledge on paid plans | Retrieval mode expands capacity up to 10 times near the limit | | Context window when you chat | 200,000 tokens by default, about 500 pages; some newer models list 1 million | Those pages state no character limit for project instructions, and reports measured the field differently. Treat each number as a dated observation. The [Claude instruction limits article](/articles/claude-custom-project-instructions-limits) shows how to measure the fields in your account. The context window holds everything at once: the instructions, the uploaded file contents, the conversation history, and Claude's replies. Near the limit, earlier parts of the conversation drop out, or the conversation must end. Projects work for contained tasks: one project, one document set, and a clear boundary. When your work spreads across several folders, or needs files Claude has not seen, Projects becomes a bottleneck. ## Know how Claude Code changes file access Claude Code is a command-line tool that connects Claude to your local files. You run it in a terminal. Inside the folders you permit, Claude can read files, run shell commands, search the directories, and write files back to disk. There is no upload step. Claude reads a file when a task needs it. Name a file path, and Claude opens it. Ask Claude to find something, and it searches with `grep` or `ripgrep` across the folder tree. The files stay on your disk. The text Claude reads from them goes to Anthropic for processing. Retention terms depend on your plan. The context window is still limited. The difference is timing. Claude does not load a file until it needs it. A session might touch 50 files and hold only 5 to 10 of them in context at one time. That changes what is possible. You can point Claude Code at a 3,000-file Obsidian vault and ask a question that needs a search across all of it. Claude finds the relevant files, reads them, combines the information, and writes the result back to the vault. The upload model of Projects does not work at that scale. ## Compare how each tool spends the context window Both tools share the same context limit. They spend it differently. In a Project, the uploaded files use context from the start. Upload 20 reference documents totaling 100,000 tokens, and 100,000 tokens remain for the conversation. A long conversation uses that up fast. On paid plans, retrieval mode changes this near the limit: Claude searches the project knowledge instead of loading all of it. In Claude Code, a file uses context only after Claude reads it. A vault can hold 2 million tokens of content while a session loads only what the current task needs. Files that Claude read stay in the session until the session compacts or ends. You can still reach the limit in Claude Code. You reach it more slowly. When you do, you start a new session, and Claude still has the same folders to read. The [context window guide](/articles/context-window-vs-persistent-ai-memory) explains why the window is working space, not memory. ## Compare how each tool fits your workflow Projects live in the browser. You switch windows, upload files by hand, and copy text between Claude and your work. Claude Code runs in a terminal next to your other tools. If you work in VS Code, Claude sits in a terminal pane. If you manage tasks in Obsidian, Claude reads and writes those files directly. If you need to process a folder of images or documents, Claude works through them one by one without an upload for each. The command line also allows automation. A shell script can call Claude Code with a prompt and a set of file paths, and a scheduler can run the script. A Project needs a person at the keyboard for each task. The [Claude Code setup guide](/articles/claude-code-setup-guide) covers the install and the first configuration file. ## Compare how each tool builds memory Neither tool carries the full text of one conversation into the next. Anthropic has added a chat memory feature on some plans, and its reach changes by plan. For durable context, the two tools use different designs. In a Project, memory lives in the project instructions and uploaded files. If you learn something new in a conversation, you edit the instructions or upload a new file, or the next conversation will not know it. In Claude Code, memory lives in files that Claude reads. The standard pattern is a `CLAUDE.md` file with instructions, context, current state, and recent work. Each session reads it first. After significant work, you update the file, and the next session starts from the new state. File-based memory scales further. It is not bound by an instruction field or an upload cap. It lives in your file system, organized the way you need. The [Claude Projects and ChatGPT Projects comparison](/articles/claude-projects-vs-chatgpt-projects-business-memory) covers the hosted side of this choice in more depth. ## Worked example: one question, two tools A consultant keeps 3,000 notes in an Obsidian vault: client folders, meeting notes, research, and past proposals. The question is: "Which past proposals mention a fixed-fee retainer, and what did each client decide?" In a Project, the consultant must first choose which files to upload. One project cannot hold 3,000 notes in context. The consultant searches the vault by hand, picks 20 likely proposals, uploads them, and asks the question. The answer covers only the chosen files. Any proposal the consultant missed is missing from the answer too. In Claude Code, the consultant starts a session in the vault folder and asks the same question. Claude searches all 3,000 notes for "fixed-fee retainer" and related terms. It reads the matching proposals, follows the links to each client's decision notes, and writes a summary table to a new note. The consultant reviews the table and opens any source note from its path. The Project answer was limited by the upload step. The Claude Code answer was limited by the search terms, which the consultant can check and widen. ## Know when Projects is enough Projects works when your needs fit its limits: - analysis of one document set that fits in the upload limits; - one-off research that needs no memory across sessions; - shared work where team members need web access to the same project. Inside those limits, Projects is simpler. It needs no terminal and no command-line learning. You get Claude with context in a familiar web interface. ## Know when Claude Code becomes necessary Claude Code becomes necessary when the limits of Projects start to block the work: - you need to process whole folders; - your knowledge base no longer fits the project, even with retrieval mode; - you want Claude to run commands, execute scripts, or work with other tools on your machine. The clearest signal is the update loop. If you edit the same project files after most conversations, you need file-system access. Claude Code removes that loop, because Claude reads and writes your working files directly. Before you give it a whole vault, scope the folder and its permissions; the [Claude and Obsidian connection guide](/articles/connect-claude-obsidian-business-memory) shows how. If you are new to the command line, the install is one terminal command, and the hardest part is writing the `CLAUDE.md` file. Claude Code needs a paid Claude plan. You can keep Notion or Google Docs for daily work and use Claude Code only on the folders that need it. ## Related: AI memory - [Install Claude Code and give it a CLAUDE.md it reads every session](/articles/claude-code-setup-guide) - [Stop Claude from forgetting your business between sessions with context files](/articles/claude-memory-problems) - [Understand Claude Code before you install it](/articles/what-is-claude-code) ---- ```text .|########||. .|########||. .|########||. |##||. .||##|. |##||. .||##|. |##||. .||##|. |#|. .|#|. |#|. .|#|. |#|. .|#|. |#| |#| |#| |#| |#| |#| .#| |#. .#| |#. .#| |#. .#. .#| .#. .#| .#. .#| |#. .#| |#. .#| |#. .#| |# ...... #| |# ...... #| |# ...... #| .# ||#########| #| .# ||#########| #| .# ||#########| #| .#. |######||######|. .#. .#. |######||######|. .#. .#. |######||######|. .#. #. .##|###|##|#|######| .# #. .##|###|##|#|######| .# #. .##|###|##|#|######| .# || |##|#||||||||||||#||#| || || |##|#||||||||||||#||#| || || |##|#||||||||||||#||#| || # |#||||||||||||||||||||#| #. # |#||||||||||||||||||||#| #. # |#||||||||||||||||||||#| #. || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || # .#||||||||||||||||||||||||#| # # .#||||||||||||||||||||||||#| # # .#||||||||||||||||||||||||#| # || ....|||#||||||##|#|||#|#||##||||....|. || || ....|||#||||||##|#|||#|#||##||||....|. || || ....|||#||||||##|#|||#|#||##||||....|. || #. . ....|# ....#||| ||| .#||| ....#. .# #. . ....|# ....#||| ||| .#||| ....#. .# #. . ....|# ....#||| ||| .#||| ....#. .# # . ||||#| .#####|| . .#| .#||| ||||# #. # . ||||#| .#####|| . .#| .#||| ||||# #. # . ||||#| .#####|| . .#| .#||| ||||# #. .| ||||| #. |#|||||. || #. |#||. .||||| || .| ||||| #. |#|||||. || #. |#||. .||||| || .| ||||| #. |#|||||. || #. |#||. .||||| || || |.... #. ....|#. |. ...|. ....|| || || |.... #. ....|#. |. ...|. ....|| || || |.... #. ....|#. |. ...|. ....|| || #. .||||||##||||||##||####|||||||#||||||#| .# #. .||||||##||||||##||####|||||||#||||||#| .# #. .||||||##||||||##||####|||||||#||||||#| .# # .||####|###########################|. # # .||####|###########################|. # # .||####|###########################|. # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#||||||############|######|||||#| # # .#||||||############|######|||||#| # # .#||||||############|######|||||#| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# || | ...|| ...##| | #| .|. |. ##### .. .| || || | ...|| ...##| | #| .|. |. ##### .. .| || || | ...|| ...##| | #| .|. |. ##### .. .| || || ||||| || ||||#| . |. |. |#. ||||| |#| || || || ||||| || ||||#| . |. |. |#. ||||| |#| || || || ||||| || ||||#| . |. |. |#. ||||| |#| || || .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. #.|||||||#############################| ||| .# #.|||||||#############################| ||| .# #.|||||||#############################| ||| .# || ##||#||#||||||#||#||#||#||##. || || ##||#||#||||||#||#||#||#||##. || || ##||#||#||||||#||#||#||#||##. || # .#|||||||||#||#|||||||||||#| # # .#|||||||||#||#|||||||||||#| # # .#|||||||||#||#|||||||||||#| # || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || .# |#||||||||||||||||||||#| #. .# |#||||||||||||||||||||#| #. .# |#||||||||||||||||||||#| #. || |#||||||||||||||||||#| || || |#||||||||||||||||||#| || || |#||||||||||||||||||#| || #. .######|#|#########| .# #. .######|#|#########| .# #. .######|#|#########| .# .#. |#####||||#####| .#. .#. |#####||||#####| .#. .#. |#####||||#####| .#. |# ||########|| #. |# ||########|| #. |# ||########|| #. |# ...... #| |# ...... #| |# ...... #| |#. .#| |#. .#| |#. .#| |#. .#. |#. .#. |#. .#. .#| |#. .#| |#. .#| |#. |#| |#| |#| |#| |#| |#| .|#|. .|#|. .|#|. .|#|. .|#|. .|#|. |##||. .||##| |##||. .||##| |##||. .||##| .||########||. .||########||. .||########||. Scale With Search 2026 [scalewithsearch.com](https://scalewithsearch.com) ```