できない.dev

tsc コマンドが見つからない(command not found: tsc)

tsc が command not found になる原因は、TypeScript をグローバルではなくプロジェクトにのみ入れているケースが大半。
npx tsc か npm run 経由で叩くのが正解。

公開: 更新:

症状できない · exit 127
command -v tsc
解決後できた · exit 0
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:20 Debian 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.json

npx は ./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 install

5. monorepo は workspace 経由で呼ぶ

# pnpm
pnpm --filter @myorg/app exec tsc --noEmit
 
# npm workspaces
npm exec --workspace=packages/app -- tsc --noEmit

よくある原因

  1. ローカルにだけ install している。
    npm install -D typescript だけだとシェルから tsc は引けないが、./node_modules/.bin/tsc には存在する。
  2. PATH がキャッシュされている。
    グローバルに入れた直後はシェルが旧 PATH を覚えているので、シェルの再起動が要る。
  3. install に失敗している。
    npm install がエラー終了して、node_modules/.bin/tsc が無い。
  4. Windows 固有の事情がある。
    PATHEXT に .cmd が無いか、WSL シェルから Windows 側 Node を呼んでパス変換が崩れている。
  5. monorepo で、TypeScript が workspace ルートだけに入っている。
    この場合、サブパッケージから直接呼べない。