Claude Code には Workflow というツールがあります。JavaScript で書いたスクリプトを渡すと、その手順どおりに複数のエージェントを動かします。私は Windows でこれを使っています。2026年8月に、保存してあったスクリプトをファイルのパスで渡したところ、次の文面で起動を断られました。
script contains control characters that would be hidden in the approval dialog
実行を許可する画面に映らない制御文字がある、という意味です。そのときの自分の作業メモには「スクリプトの改行が CRLF だった。CR を抜いた写しを作ると起動した」とあり、「CRLF のスクリプトは断られる」と結んでいます。ただ、確かめたのはその1本だけで、改行が本当に CRLF だったかも調べていませんでした。
CRLF というだけで断られるのでしょうか。改行と見えない文字を変えたスクリプトを18通り作り、2つの形で3回ずつ起動しました。1つ目は、Claude Code に「このパスのスクリプトを起動して」と頼み、ファイルをそのまま Workflow へ渡す形で、54回です。2つ目は、先に起動した親のスクリプトが、中から18通りのファイルを呼ぶ形で、こちらも54回です。Windows でファイルを書く7通りの方法が出したファイルも3回ずつ、21回起動しました。合わせて129回です。
先に結論
- 全行が CRLF のスクリプトは、3回とも起動しました。試した版(Claude Code 2.1.325)では、CRLF だからといって LF に直す必要はありませんでした。
- 直接渡したときに断られたのは、CRLF の組になっていない CR と、ESC や NUL などの制御文字が入ったファイルです。ゼロ幅スペース、文字の並びを右から左に変える U+202E、ファイルの先頭に付く印の BOM は、見えないか見え方を変える文字ですが、断られませんでした。
- Windows の書き方7通りのうち、断られるファイルを出したのは1通りだけでした。CRLF のファイルをバイト列で読み、Python の
open(path, 'w')で書き戻すと、改行が CR CR LF になります。 - 試した2つの形のうち、制御文字を理由に断ったのは、ファイルを直接渡す形だけでした。親のスクリプトから呼ぶ形では、同じファイルが1回も断られていません。直接だと断られた9通りのうち8通りはそのまま動き、単独の CR を入れた1通りは、コメントの続きがコードとして実行されてエラーで止まりました。
8月のファイルが CRLF だったのか CR CR LF だったのかは、分かりません。当時のファイルは残っておらず、Git の履歴にある中身は LF で、作業フォルダでの改行は記録されていないためです。CR CR LF だったなら、今回の結果と合います。CRLF だったなら合いませんが、8月に使っていた Claude Code の版を記録しておらず、版の違いによるのかは調べられません。
断られたときに調べること
疑うのは、組になっていない CR と制御文字です。次のスクリプトを check.py として保存し、python check.py スクリプトのパス で実行すると、何行目に何があるかを出します。
import sys
s = open(sys.argv[1], 'rb').read().decode('utf-8')
REJECTED = {0x85} # U+0085
PASSED = {0x200B: 'ゼロ幅スペース', 0x202E: 'U+202E', 0xFEFF: 'BOM'}
line = 1
for i, ch in enumerate(s):
c = ord(ch)
if c == 13 and s[i + 1:i + 2] != chr(10):
print(f'{line}行目: CRLF の組でない CR')
elif (c < 32 and c not in (9, 10, 13)) or c == 127 or c in REJECTED:
print(f'{line}行目: 制御文字 U+{c:04X}')
elif c in PASSED:
print(f'{line}行目: {PASSED[c]}(起動は断られなかった)')
if c == 10:
line += 1
print('調べ終わり')
出すのは、組になっていない CR、タブと改行を除く 0x00〜0x1f と 0x7f の制御文字、U+0085、それに断られなかった見えない文字3つです。「調べ終わり」だけが出ても、見えない文字が無いとは言えません。ここに挙げていない文字は拾わないためです。行の番号は LF で数えるので、改行が CR だけのファイルは、全部が1行目として出ます。
組になっていない CR がたくさん出たら、改行そのものが CR CR LF か CR だけになっています。CR CR LF なら、Python でバイト列として読んだ中身を open(path, 'w') で書いている所を探します。CRLF のファイルを5通りの読み方と書き方で写し、出来た改行を3回ずつ調べました。3回とも同じ結果です。この5通りは、出来たファイルのバイトを見ただけで、起動はしていません。
| 読み方 | 書き方 | 出来た改行 |
|---|---|---|
read_bytes().decode() |
open(path, 'w') |
CR CR LF |
read_bytes().decode() |
open(path, 'w', newline='') |
CRLF |
read_bytes().decode() |
write_bytes(s.encode()) |
CRLF |
open(path).read() |
open(path, 'w') |
CRLF |
open(path, newline='').read() |
open(path, 'w', newline='') |
CRLF |
1行目が CR CR LF を作る組み合わせで、残りの4通りのどれかに替えれば CRLF のままになります。
スクリプトから別のスクリプトを呼ぶ作りにしている場合は、呼ばれる側のファイルにも check.py を当ててください。呼ばれる側のコメントの途中に単独の CR があると、コメントのつもりの文字がコードとして動きます。親から呼ぶ形では、単独の CR が入ったファイルも、起動の前に断られませんでした。
何を測ったか
元にしたスクリプトは7行です。エージェントを1体も起こさず、名前を返すだけにしました。NAME と COMMENT は、あとで置き換える目印です。
export const meta = {
name: 'probe-NAME',
description: 'returns a constant, spawns no agent',
}
// COMMENT
const out = { probe: 'NAME' }
return out
これを18通りに書き分けました。名前が v で始まる10通りは最初に用意したもの、x で始まる8通りは、断られる境目を確かめるために足したものです。
| 名前 | 中身 |
|---|---|
| v1 | 全行 LF |
| v2 | 全行 CRLF |
| v3 | LF のうち1行だけ CRLF |
| v4 | LF で、コメントの途中に CR が1個 |
| v5 | LF で、字下げがタブ |
| v6 | LF で、先頭に BOM |
| v7 | LF で、コメントに ESC(0x1b) |
| v8 | LF で、コメントにゼロ幅スペース(U+200B) |
| v9 | LF で、コメントが日本語 |
| v2_fixed | v2 から CR を抜いた写し |
| x1 | 全行 CR だけ |
| x2 | 全行 CR CR LF |
| x3 | LF で、コメントに NUL(0x00) |
| x4 | LF で、コメントに BEL(0x07) |
| x5 | LF で、コメントに DEL(0x7f) |
| x6 | LF で、コメントに改ページ(0x0c) |
| x7 | LF で、コメントに U+0085(「次の行」を表す制御文字) |
| x8 | LF で、コメントに U+202E(文字の並びを右から左に変える文字) |
1つ目の形は、Claude Code に「このパスのスクリプトを Workflow で起動して」と頼む形です。Claude Code が Workflow ツールの scriptPath にそのパスを入れて起動します。2つ目は、LF で書いた親のスクリプトを先に起動し、その中から18通りを1本ずつ呼ぶ形です。呼ぶときは、Workflow のスクリプトの中で使える関数 workflow({scriptPath: ...}) を使いました。
環境は Windows 11、Claude Code 2.1.325、Python 3.12.10、Git 2.55.0、Node.js v24.19.0 です。
結果
直接渡したとき
18通りのうち、起動したのは9通り、断られたのも9通りでした。3回とも同じ結果です。
| 結果 | 名前 |
|---|---|
| 起動して値を返した | v1(LF)、v2(CRLF)、v3(1行だけ CRLF)、v5(タブ)、v6(BOM)、v8(ゼロ幅スペース)、v9(日本語)、v2_fixed(CR を抜いた写し)、x8(U+202E) |
| 断られた | v4(単独の CR)、v7(ESC)、x1(CR だけ)、x2(CR CR LF)、x3(NUL)、x4(BEL)、x5(DEL)、x6(改ページ)、x7(U+0085) |
断られたときの文面は、9通りとも次のとおりでした。冒頭に引いた8月の文面とは、言い回しが変わっています。
Workflow script file <パス> contains a control character that an approval prompt cannot show, such as an escape byte or a carriage return that is not part of a CRLF line ending. Remove it from the file and try again.
check.py を18通りに当てると、断られた9通りはすべて1行以上が出ました。起動した9通りのうち6通りは「調べ終わり」だけで、残る v6、v8、x8 は断られなかった見えない文字として出ます。
起動済みのスクリプトの中から呼んだとき
同じ18通りを親のスクリプトから呼ぶと、3回とも次の結果でした。制御文字を理由に断られた呼び出しは、54回のうち0回です。
| 結果 | 名前 |
|---|---|
| 動いて値を返した(17通り) | 直接渡して起動した9通りと、v7、x1、x2、x3、x4、x5、x6、x7 |
| JavaScript のエラーで止まった(1通り) | v4 |
v4 のエラーは次のとおりです。
ReferenceError: MENT is not defined
v4 は、コメントの行 // COMMENT の COM と MENT の間に CR を1個入れたものです。JavaScript では、CR が単独でも行の終わりとして扱われます。コメントは COM で終わり、MENT が次の行のコードとして実行されました。Node.js でも確かめています。// just a comment の後ろに CR を置き、続けて console.log("ran") と書いたファイルは、3回とも ran を出力しました。
Windows の書き方7通り
同じ7行を7通りの方法で書き、出来たファイルのバイトを数えてから、直接渡して3回ずつ起動しました。
| 書き方 | 出来た改行 | 起動(3回とも) |
|---|---|---|
Python の open(path, 'w') に LF の文字列を書く |
CRLF | 起動した |
CRLF のファイルを read_bytes().decode() で読み、open(path, 'w') で書き戻す |
CR CR LF | 断られた |
Python の open(path, 'w', newline='\n') に書く |
LF | 起動した |
Windows PowerShell 5.1 の Set-Content -Encoding UTF8
|
CRLF と先頭の BOM | 起動した |
Git Bash の printf
|
LF | 起動した |
LF でコミットしたファイルを core.autocrlf=true で取り出し直す |
CRLF | 起動した |
同じ操作を、.gitattributes に *.js text eol=lf を置いてから行う |
LF | 起動した |
断られたのは2番目だけです。Windows の Python は、open(path, 'w') で書くときに LF を CRLF へ置き換えます。read_bytes().decode() で読んだ文字列には、CR と LF が両方残っています。書くときに LF だけが CRLF へ置き換えられ、元の CR が残って CR CR LF になります。
Git については、core.autocrlf を true、false、input に変えた取り出し直しも、3回ずつ行いました。表の最後の2行とは別の実験で、出来た改行を調べただけです。起動はしていません。.gitattributes に *.js text eol=lf があると、3つの値のどれでも LF になり、無いと true のときだけ CRLF になりました。
Claude Code 自身がファイルを書いたときの改行も、3回ずつ数えました。新しく書いたファイルは LF でした。CRLF のファイルの1行を編集すると CRLF のまま、LF のファイルの1行を編集すると LF のままで、CR CR LF は1回も出ていません。試したのは7行のファイルだけです。
追試のためのコード
18通りのファイルは、次のコードで作りました。見えない文字はすべて chr() で作り、バイト列で書いています。gen.py として保存し、python gen.py 出力先のフォルダ で18個のファイルが出来ます。出力先には、まだ無いフォルダの名前を渡します。すでにあるとエラーで止まります。ファイルの名前は、表の名前の後ろに中身を表す語を付けています。
import sys
from pathlib import Path
LF, CR = chr(10), chr(13)
BASE = LF.join([
"export const meta = {",
" name: 'probe-NAME',",
" description: 'returns a constant, spawns no agent',",
"}",
"// COMMENT",
"const out = { probe: 'NAME' }",
"return out",
"",
])
mid = lambda ch: (lambda t: t.replace("COMMENT", "COM" + ch + "MENT"))
KINDS = {
"v1_lf": lambda t: t,
"v2_crlf": lambda t: t.replace(LF, CR + LF),
"v3_one_crlf": lambda t: t.replace("// COMMENT" + LF, "// COMMENT" + CR + LF),
"v4_cr_in_comment": mid(CR),
"v5_tab": lambda t: t.replace(" name", chr(9) + "name").replace(" description", chr(9) + "description"),
"v6_bom": lambda t: chr(0xFEFF) + t,
"v7_esc": mid(chr(0x1B)),
"v8_zwsp": mid(chr(0x200B)),
"v9_ja": lambda t: t.replace("COMMENT", "日本語のコメント"),
"x1_cr_only": lambda t: t.replace(LF, CR),
"x2_crcrlf": lambda t: t.replace(LF, CR + CR + LF),
"x3_nul": mid(chr(0)),
"x4_bel": mid(chr(7)),
"x5_del": mid(chr(0x7F)),
"x6_ff": mid(chr(0x0C)),
"x7_nel": mid(chr(0x85)),
"x8_rlo": mid(chr(0x202E)),
}
out = Path(sys.argv[1])
out.mkdir(exist_ok=False)
for name, fn in KINDS.items():
(out / f"{name}.js").write_bytes(fn(BASE.replace("NAME", name)).encode("utf-8"))
fixed = (out / "v2_crlf.js").read_bytes().replace(bytes([13]), b"")
(out / "v2_fixed.js").write_bytes(fixed)
直接渡す形は、Claude Code のセッションで「C:/.../v2_crlf.js を Workflow の scriptPath に渡して起動して」のように、1本ずつパスを書いて頼みました。
親のスクリプトは次のとおりです。nested.js のような名前で、LF で保存します。Claude Code に「nested.js を Workflow で起動して。args には {"dir": "18個のファイルを置いたフォルダのパス"} を渡して」と頼むと動きます。args は起動のときに Workflow へ渡す値で、スクリプトの中から同じ名前で読めます。パスの区切りは / で書きました。
export const meta = {
name: 'nested-probe',
description: 'calls 18 child scripts via workflow(), spawns no agent',
}
const names = ['v1_lf','v2_crlf','v3_one_crlf','v4_cr_in_comment','v5_tab','v6_bom','v7_esc','v8_zwsp','v9_ja','v2_fixed','x1_cr_only','x2_crcrlf','x3_nul','x4_bel','x5_del','x6_ff','x7_nel','x8_rlo']
const out = {}
for (const n of names) {
try {
const r = await workflow({ scriptPath: args.dir + '/' + n + '.js' })
out[n] = 'OK ' + JSON.stringify(r)
} catch (e) {
out[n] = 'ERR ' + String(e && e.message ? e.message : e).slice(0, 160)
}
}
return out
親から呼ぶ形の54回は、このスクリプトを3回動かしたものです。
測っていないこと
試したのは、上の環境1つと、表の18通りの文字だけです。スクリプトをファイルでなく文字列で渡す形と、あらかじめ登録したスクリプトを名前で呼ぶ形は測っていません。実行を許可する画面に、18通りのファイルがどう映るかは見ていません。起動済みのスクリプトの中から呼ぶ形で断られなかった理由は、分かっていません。意図した作りなのか、不具合なのかも確かめていません。書き方の7通りは、エディタの保存と PowerShell 7 を含みません。
AIエージェントに仕事を任せて実際に起きた事故と、その防ぎ方を7組にまとめた本が出ています。『AIエージェントに仕事を任せる前に知っておきたい、実際に起きた事故と防ぎ方』(Kindle・680円)
https://tony-kinot.github.io/kdp-book1/go/?from=qiita