開発・コード

開発・コードでツールの制約症状

症状

2⁠件

直す手順

6手順

代わりの道具

1種

区分で仕分ける

開発・コードの症状のうち、ツール側の制約が大きいものを集めました。こちらの工夫では限界があり、道具を替えるか、作業の分け方を変える症状です。全部で2⁠件。症状を見分けて、直す手順を上から試し、それでも残るときの代わりの道具まで進めます。

症状を見分ける

最初の切り分け

2⁠件の原因と直す順番

存在しない関数やライブラリを使う

起きやすいツール：ChatGPT・GitHub Copilot・Cursor／区分：ツール側の制約が大きい

なぜ起きるか　それらしい名前を作ってしまうことがあります。仕様です。

1. 公式の資料で名前を確かめる
2. 実行して確かめてから使う
3. 「実在するものだけ使って」と指示しても防ぎきれません

次から起こさないために　動かして確かめるまで信じないことです。

3つ試して直らなければ、代わりの候補はClaude Code（有料のみ・月3,000⁠円から）。直し方をくわしく・乗り換えで直るか

提案が古い書き方になる

起きやすいツール：GitHub Copilot・ChatGPT・Cline／区分：ツール側の制約が大きい

なぜ起きるか　学習した時点の情報に基づくため、新しい書き方が反映されていないことがあります。

1. 使いたい版を指定する
2. 公式の資料を貼って参照させる
3. 出てきたコードを最新の資料と突き合わせる

次から起こさないために　新しい機能を使うときは、資料を渡す前提で進めてください。

3つ試して直らなければ、代わりの候補はClaude Code（有料のみ・月3,000⁠円から）。直し方をくわしく・乗り換えで直るか

取り違えやすい症状

起きやすいツールが同じで、見た目が似ている症状です。手順を試しても変わらないときは、こちらを疑ってください。

起きやすいツールごとに見る

直す前に、使っている環境をそろえる

ツールの制約症状の直し方の考え方

上限は公式の案内で確かめる

長さ・回数・大きさの上限は提供元が決めていて、こちらでは変えられません。案内の日付も確かめます。

作業を分けて上限の内側に収める

長いものは分ける、大きいものは小さく作ってつなぐ。分け方で通ることがあります。

その作業だけ別の道具に移す

全部を移す必要はありません。制約に当たる作業だけ、代わりの道具に任せます。

開発・コードで区分の違う症状

いまの症状が上の手順で変わらないときは、区分の違うこちらの症状かもしれません。

生成されたコードが動かない

使い方で改善できる。使っているライブラリの版が違うか、前提の環境が異なります。まず「エラー文をそのまま貼って直させる」を試します。生成されたコードが動かない

既存のコードを壊される

使い方で改善できる。文脈を読み違えて、関係ない部分まで書き換えることがあります。まず「変更前にコミットしておく」を試します。既存のコードを壊される

長いファイルの後半を無視する

使い方で改善できる。一度に読める長さに上限があります。まず「ファイルを分割して渡す」を試します。長いファイルの後半を無視する

同じ修正を何度も繰り返す

使い方で改善できる。直した内容が伝わっていないか、前の指示に戻っています。まず「現在のコードを貼り直す」を試します。同じ修正を何度も繰り返す

APIキーをコードに書かれてしまう

使い方で改善できる。動く形を優先して、鍵を直接書いた例が出ます。まず「環境変数に移す」を試します。APIキーをコードに書かれてしまう

日本語のコメントが文字化けする

設定で改善できる。ファイルの文字コードが合っていません。まず「UTF-8で保存し直す」を試します。日本語のコメントが文字化けする

テストを書かずに完成と言う

使い方で改善できる。指示に含まれていないと、確認の工程を省きます。まず「テストまで含めて依頼する」を試します。テストを書かずに完成と言う

料金が急に増える

使い方で改善できる。従量課金のツールでは、長いやり取りや大きなファイルで消費が増えます。まず「使用量の画面を定期的に見る」を試します。料金が急に増える

開発・コードの症状18⁠件の区分（太字がこのページ）

3つの手順で直らないときの代わりの道具

3つの手順で直らないときに、当サイトが代わりの候補として挙げている道具を数えました。まず今のAIで手順を試し、それでも残るときだけ検討してください。

Claude Code（2⁠件で候補）

「存在しない関数やライブラリを使う」「提案が古い書き方になる」で、今の道具の代わりに挙げています。有料のみで、月3,000⁠円から（当サイト掲載値）。Claude Codeへ移る前に確かめることも用意しています。

開発・コードで症状を起こしにくくする使い方

開発・コードの症状は、直し方より先に、起こしにくい使い方で差がつきます。

動く単位で小さく頼む

まとめて書かせると、どこで壊れたかが分からなくなります。1つ作るごとに動かして確かめます。

使っている版を伝える

言語やライブラリの版を伝えないと、古い書き方が返ってきます。設定ファイルの中身を渡すのが確実です。

鍵や個人情報を貼らない

パスワード・APIキー・顧客データをそのまま貼ると、外へ出たのと同じ扱いになります。

同じことを起こさないための決めごと

直したあとに同じことを起こさないための決めごとを、そのまま共有できる形にまとめました。必要な行だけ残してください。

【この決めごとの対象】［部署・作業名］

1. 動かして確かめるまで信じないことです。
2. 新しい機能を使うときは、資料を渡す前提で進めてください。

【困ったときの相談先】［担当者・窓口］
【見直す時期】［例：3⁠か月ごと］

区分の読み方

当サイトは症状を4つの区分に分けています。区分で、最初にやることが変わります。

設定で改善できる

画面の設定や、最初に渡す指定を変えれば止まる症状です。画面の設定・最初の指定・会話の作り直しから試します。

使い方で改善できる

指示の出し方や、渡す材料の切り方で変わる症状です。指示の分け方・材料の絞り方・頼む順番を変えます。

ツール側の制約が大きい

こちらの工夫では限界があり、道具を替えるか、作業の分け方を変える症状です。上限を公式の案内で確かめ、作業を分けるか代わりの道具を試します。

規約・権利・データの扱いによる

直す以前に、使ってよいか・渡してよいかの判断が要る症状です。社内の決まりと利用規約を先に確かめ、使ってよい範囲を決めます。

それでも直らないときに、人に聞く文面

社内の詳しい人や、ツールの窓口へ出すときの形です。試したことを先に並べると、同じ手順をもう一度言われずに済みます。

【起きていること】
存在しない関数やライブラリを使う

【使っている道具】［ツール名・プラン・使っている画面（ブラウザ／アプリ）］
【いつから】［日付。最初に気づいた作業］
【毎回起きるか】［毎回／ときどき／一度だけ］

【試したこと】
1. 公式の資料で名前を確かめる　→［結果］
2. 実行して確かめてから使う　→［結果］
3. 「実在するものだけ使って」と指示しても防ぎきれません　→［結果］

【見てほしいもの】［画面の写し・入力した指示・出てきた結果］
【困っていること】［何の作業が止まっているか。期限があれば］

起きた条件を残す

同じ症状が何度も出るなら、起きた条件を3回ぶん残してください。条件がそろうと、原因が自分の側か道具の側かが分かれます。

【日時】［　］　【道具とプラン】［　］
【何をさせていたか】［　］
【渡した材料の量】［文字数・枚数・長さ］
【会話の長さ】［新しい会話／何往復目か］
【起きたこと】［　］
【直したこと】［　］　→　【直ったか】［はい／いいえ］

開発・コードのほかの区分

• 開発・コードで設定で直る症状（3⁠件）
• 開発・コードで使い方で直る症状（10⁠件）
• 開発・コードで規約・権利・データ症状（3⁠件）

開発・コードの症状をまとめて仕分ける

開発・コードでツールの制約症状についてよくある質問

有料プランにすれば直りますか？

2⁠件はツール側の制約で、プランで上限が変わるものもあります。

どこまで試したら道具を替えますか？

当サイトでは、症状ごとの3つの手順を試しても残るときを目安にしています。替える前に、代わりの道具の無料枠で同じ作業を1回だけ通して比べてください。

次にやること

• 症状を1つに決める
  見分けの表から、いちばん近い症状を選びます。
  存在しない関数やライブラリを使うの直し方
• 3つの手順を上から試す
  1つ試すごとに結果を記録すると、人に聞くときにそのまま使えます。
• 同じ分類のほかの症状と見比べる
  似た症状を取り違えていることがあります。
  開発・コードの症状を見る