This guide shows you how to compile and run a C program on macOS Tahoe using the Terminal. If you have already installed a compiler, you are ready to go. If not, start with our guide on how to install GCC on macOS Tahoe first — it takes one command.
Just need to run one or two quick programs without setting anything up? You can compile C in your browser instead — see our guide to online C compilers. No installation required.
The Two-Step Workflow
Running a C program on macOS is always two steps:
- Compile — turn your
.c source file into an executable program
- Run — execute that program
Unlike Python or JavaScript, C is a compiled language — you cannot run a .c file directly. The compiler (gcc, which is Apple’s Clang on macOS) translates your code into machine code first.
Step 1 — Write Your C Program
Open any text editor and create a file called hello.c. You can use the built-in nano editor right in the Terminal:
nano hello.c
Type this program:
#include <stdio.h>
int main(void) {
printf("Hello, World!\n");
return 0;
}
Save and exit nano with Ctrl+O, Enter, then Ctrl+X.
Step 2 — Navigate to Your File
Use cd to move into the folder where you saved hello.c. For example, if it is on your Desktop:
cd ~/Desktop
Confirm the file is there with ls:
ls hello.c
Step 3 — Compile the Program
gcc hello.c -o hello
Breaking this command down:
| Part |
Meaning |
gcc |
The compiler (Apple Clang on macOS) |
hello.c |
Your source file — the input |
-o hello |
Name the output executable hello |
If your code has no errors, the command finishes silently and creates a new executable file named hello. If you omit -o hello, the compiler names the output a.out by default.
Step 4 — Run the Program
./hello
Output:
Hello, World!
The ./ prefix is required — it tells the shell to run the program from the current directory. Typing just hello will not work, because the current folder is not in your PATH by default.
The Complete Sequence
cd ~/Desktop
gcc hello.c -o hello
./hello
Three commands, every time: navigate, compile, run.
Recommended Compiler Flags
For learning C, always compile with warnings enabled. They catch real bugs before they bite:
gcc -Wall -Wextra hello.c -o hello
| Flag |
What it does |
-Wall |
Enable all common warnings |
-Wextra |
Enable extra warnings -Wall misses |
-std=c17 |
Use the C17 standard (or -std=c11, -std=c99) |
-g |
Add debug info for use with a debugger |
-O2 |
Optimise the compiled program for speed |
A good everyday command for students:
gcc -Wall -Wextra -std=c17 hello.c -o hello
Compiling Multiple Source Files
As your programs grow, you will split them across files. Compile them together by listing each .c file:
gcc -Wall main.c utils.c math_helpers.c -o myprogram
./myprogram
The compiler combines all three source files into a single executable. Header files (.h) are not listed — they are pulled in automatically by the #include directives in your code.
Reading Input While the Program Runs
If your program uses scanf() to read input, just type the values when it runs:
#include <stdio.h>
int main(void) {
int n;
printf("Enter a number: ");
scanf("%d", &n);
printf("You entered %d\n", n);
return 0;
}
gcc -Wall input.c -o input
./input
Enter a number: 42
You entered 42
Common Errors and Fixes
| Error message |
Cause and fix |
gcc: command not found |
No compiler installed — see our install guide |
hello.c: No such file or directory |
You are in the wrong folder — use cd to navigate to where the file is, check with ls |
permission denied: ./hello |
Rare — fix with chmod +x hello then run again |
undefined reference to 'function' |
You forgot to include a .c file in the compile command — list all of them |
implicit declaration of function 'printf' |
You forgot #include <stdio.h> at the top |
Tired of Typing Commands? Use an IDE
Running three commands for every change gets tedious. VS Code lets you compile and run with a single keypress, and adds code completion and a visual debugger. It is free and works great on Apple Silicon and Intel Macs.
If you prefer a faster, more modern Terminal experience, Warp Terminal adds autocomplete, command history search, and AI assistance — a nice upgrade for the compile-run-debug loop on macOS.
What’s Next
You now know how to compile and run C on macOS Tahoe. Time to practise — browse our full list of C programs with examples, from beginner exercises to sorting algorithms and data structures.
As an Amazon Associate we earn from qualifying purchases. The Warp Terminal link above is a referral link.
Recommended Book
Once you are comfortable compiling and running programs, the best book to actually learn the language is The C Programming Language by Brian Kernighan and Dennis Ritchie (K&R). Every example in it compiles and runs with the exact gcc workflow above.
