Contents
I developed this site — the portfolio you're reading right now — using Claude Code. The process was both fast and educational. I wanted to share the experience.
What Is Claude Code?#
Claude Code is Anthropic's CLI-based AI coding assistant. It runs in the terminal, can read and write files, and execute commands. It's not a code editor plugin — it's a fully terminal-based agent.
How We Built the Project#
We started with Next.js 16 (App Router), TypeScript, and Tailwind CSS. We went through several iterations on the design:
- Corporate blue → boring
- Dark 3D / glassmorphism → too complex
- Pure white → too flat
- e-Government red → wrong feel
- CIA.gov style — dark navy + gold → right
Claude Code was able to independently edit the relevant files with each design change. I directed, it implemented.
Strengths#
- Context memory: doesn't forget what it did in long sessions
- File system understanding: knows which file is where
- Error analysis: usually finds and fixes TypeScript errors on its own
- Complex features like bilingual support worked on the first try
Weaknesses#
- Human eye is still necessary for UI/UX decisions
- Some CSS details remain incomplete without visual testing
- When context gets very long, old decisions may need to be re-asked
Conclusion#
Claude Code is a developer assistant — it doesn't replace you, it reduces your workload. I could have built this site on my own, but it would have taken much longer. We built it together, faster and better.
If you're thinking about building your own portfolio site: the Next.js + Tailwind + Claude Code combination is a strong starting point.