tsc コマンドが見つからない(command not found: tsc)
tsc が command not found になる原因は、TypeScript をグローバルではなくプロジェクトにのみ入れているケースが大半。npx tsc か npm run 経由で叩くのが正解。
公開: 更新:
command -v tsc
npx tsc --version Version 5.9.3
2026-10-29 に node:20(TypeScript 5.9.3 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細
要約
tsc: command not found の原因のほとんどは、ローカルに install しただけでグローバルには無いことである。npx tsc で node_modules/.bin/tsc を直接叩くか、npm scripts で間接的に呼ぶのが定石である。
実行例
node:20(Debian GNU/Linux 12)環境で上記の手順を動かすと、グローバルに tsc が存在しない状態では終了コード 127 になった。
ローカル install 後は、node_modules/.bin/tsc と npx tsc のどちらでも TypeScript 5.9.3 が正常に実行できた(終了コード 0)。
$ command -v tsc
$ echo $?
127$ tsc --version
sh: 43: /recipe.sh: tsc: not found
$ echo $?
127$ tsc --version
sh: 43: /recipe.sh: tsc: not found
$ echo $?
127$ ls node_modules/.bin/tsc && ./node_modules/.bin/tsc --version
node_modules/.bin/tsc
Version 5.9.3
$ echo $?
0$ npx tsc --version
Version 5.9.3
$ echo $?
0— 2026-10-29 時点の出力
検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-29 検証(ほか 2 件)
- 検証日
- 実行環境
node:20Debian GNU/Linux 12 (bookworm)- バージョン
- Node.js 20.20.2
- npm 10.8.2
- Python 3.11.2
- Git 2.39.5
- TypeScript 5.9.3
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. npx で叩く(推奨)
npx tsc --version
npx tsc -p tsconfig.jsonnpx は ./node_modules/.bin を最優先で探すため、ローカル install で足りる(npm Docs - npx(新しいタブで開く))。
2. npm scripts に書く
{
"scripts": {
"build": "tsc -p .",
"typecheck": "tsc --noEmit"
}
}npm run build ではシェルの PATH に ./node_modules/.bin が自動で先頭追加される。
3. どうしてもグローバルに必要なら
npm install -g typescript
which tsc
tsc --versionただし複数プロジェクトでバージョン差があると挙動が変わるので、CI とローカルで一致させて運用する。
4. install 失敗を確認
ls node_modules/.bin/tsc
# 存在しなければ
rm -rf node_modules package-lock.json
npm install5. monorepo は workspace 経由で呼ぶ
# pnpm
pnpm --filter @myorg/app exec tsc --noEmit
# npm workspaces
npm exec --workspace=packages/app -- tsc --noEmitよくある原因
- ローカルにだけ install している。
npm install -D typescriptだけだとシェルからtscは引けないが、./node_modules/.bin/tscには存在する。 - PATH がキャッシュされている。
グローバルに入れた直後はシェルが旧 PATH を覚えているので、シェルの再起動が要る。 - install に失敗している。
npm installがエラー終了して、node_modules/.bin/tscが無い。 - Windows 固有の事情がある。
PATHEXTに.cmdが無いか、WSL シェルから Windows 側 Node を呼んでパス変換が崩れている。 - monorepo で、TypeScript が workspace ルートだけに入っている。
この場合、サブパッケージから直接呼べない。