1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

第6回 AIで作ったコードを動かす前に確かめる「3つの安全チェック」(コードが読めなくてもOK)

1
Posted at

本記事は連載 「非エンジニアでもわかる!AIと作るFX自動売買入門」 の1本です。

第5回では、Claude Codeへの依頼を「小さく」「具体的に」分けて頼むコツをまとめました。

◀️ 前の記事:第5回 AIに頼みやすい単位で開発を分割するコツ(プロンプト設計の基本)

今回は、AIが作ったコードを動かす前に確認しておきたいことを整理しておきます。

コードが読めなくても大丈夫です。本記事では、Claude Codeに質問するだけで安全性を確かめる「3つの安全チェック」を紹介します。


この記事のゴール

本記事を読み終えた時点で、以下ができる状態を目指します。

  1. コードを読まずに安全を確かめる考え方がわかる
  2. APIキーなどの秘密情報が安全に扱われているかを、AIへの質問で確認できる
  3. 1回の取引でいくら動かしているか、最大でいくら損をするかを把握できる
  4. デモ環境と本番環境のどちらで動くコードかを見分けられる
  5. 3つのチェックをまとめて行うプロンプトを手元に置いている

事前準備

以下が完了していることを前提に進めます。

  1. 第2〜5回でClaude Code Desktopの操作に一通り慣れている
  2. 第3回で ~/oanda_credentials/.env にデモ口座のAPIトークンとアカウントIDを保存している
  3. oanda_bot フォルダをClaude Codeの作業フォルダとして開いている

まだお済みでない方は、先に第2〜5回をご覧ください。

なお、本記事では実際の発注は行いません。発注のサンプルコードを作ってもらいますが、動かさずに中身を確認するだけにとどめます。


コードを読まずに安全を確かめる考え方

まずは、3つのチェックの土台になる考え方から押さえておきましょう。

見るべきなのは「鍵」と「お金」と「場所」だけ

AIが作ったコードを1行ずつ理解する必要はありません。自動売買のコードで大きな事故につながりやすいのは、次の3つに関わる部分です。

  1. 鍵:APIトークンやアカウントIDなど、口座を操作するための秘密情報
  2. お金:1回の取引でいくら動かすか、最大でいくら失うか
  3. 場所:デモ環境と本番環境のどちらに注文を出すか

画面の表示が少し崩れている、ファイル名が想定と違う、といったズレはあとから直せば済みます。

一方で、この3つを間違えると、お金や口座の安全に直接影響します。そのため、動かす前のチェックはこの3つに絞ります。

AIに「質問して答えさせる」ことで確認する

コードが読めない場合でも、確認する方法はあります。コードを書いたAI本人に、質問して説明させればよいのです。

Claude Codeは、自分が書いたコードの中身を日本語で説明するのが得意です。「このコードはいくらの取引をしますか」と聞けば、該当する箇所を探して答えてくれます。

第4回で紹介した許可ダイアログは、「この操作をしてよいか」を確認する仕組みでした。本記事の安全チェックは、その一歩手前で「そもそもこのコードは何をするのか」を確認する作業だと考えてください。


確認用のサンプルコードを用意する

ここからは、実際にサンプルコードを使って3つのチェックを試していきます。

「実行しないで」と付けて発注のサンプルを作ってもらう

Claude Codeに、次のプロンプトを送ってください。

🧑 OANDA APIのデモ環境で、ドル円を1,000通貨だけ成行で買い、損切り20pips・利確30pipsを同時に指定するPythonコードを、oanda_botフォルダに sample_order.py として作成してください。
APIトークンとアカウントIDは ~/oanda_credentials/.env に保存済みです(中身を確認する必要はありません)。
python-dotenv を使って、実行時に環境変数 OANDA_ACCESS_TOKEN と OANDA_ACCOUNT_ID として読み込むようにしてください。
今回は内容の確認が目的なので、コードは作成するだけで実行しないでください。

ポイントは、最後の「実行しないでください」の一文です。これを付けておくことで、Claudeがコードを作ったあとに自動で動かそうとするのを防げます。

sample_order.pyの作成を依頼した結果。実行はせず、認証情報の読み込み方法や注文内容が説明されている。

※環境によって回答の内容が異なることが考えられます。

oanda_bot フォルダに sample_order.py ができていれば準備完了です。

実行の許可を求められたら「拒否」する

「実行しないで」と伝えていても、Claudeが動作確認のために実行の許可を求めてくる可能性が考えられます。その場合は、許可ダイアログで「拒否」を選んでください。

拒否しても、作成したファイルはそのまま残ります。

デモ環境のコードなので実害はありませんが、「中身を確認してから動かす」という順番を守る練習として、ここでは動かさずに進めます。


チェック①:APIキーや秘密情報を安全に扱っているか

最初のチェックは「鍵」です。

何が起きると危ないか

APIトークンは、口座で注文を出すための鍵です。

第3回では、このトークンを oanda_bot フォルダの外にある .env に保存し、Claudeから読めないように設定しました。ただ、AIが書いたコードの中で、次のような扱いをされていると保護が台無しになります。

  1. トークンやアカウントIDが、コードの中に直接書き込まれている
  2. トークンが、画面に表示されるようになっている
  3. トークンが、ログファイルなどに書き出されるようになっている

1つ目の状態になっていると、コードを誰かに見せたり、どこかにアップしたりしたときに、トークンも一緒に漏れてしまいます。

AIへの質問例

Claude Codeに、次のように質問してください。

🧑 sample_order.py について質問です。コードは修正しないで、答えだけ教えてください。
1.APIトークンやアカウントIDが、コードの中に直接書かれている箇所はありますか?
2.APIトークンやアカウントIDを、画面に表示したりファイルに書き出したりする箇所はありますか?
3.APIトークンとアカウントIDは、どこから読み込んでいますか?

ここでも「コードは修正しないで」と添えておくと、Claudeが気を利かせて勝手にコード修正することを防げます。

チェック①の質問への回答。トークンとアカウントIDの直接記述がないこと、表示や書き出しの有無、読み込み元が説明されている。

※環境によって回答の内容が異なることが考えられます。

返ってきた答えの見方

答えは、次のような観点で確認します。

質問 OKな答え NGな答え
1.直接書かれているか 書かれていない トークンの文字列がコード内にある
2.表示・書き出しがあるか ない print やログでトークンを出力している
3.どこから読み込んでいるか .env から環境変数として読み込んでいる コード内の変数に直接設定している

参考までに、コードの中では次のような違いになります。

次のコードは、トークンを .env から読み込んでいるOKな例です。

access_token = os.getenv("OANDA_ACCESS_TOKEN")

次のコードは、トークンを直接書き込んでいるNGな例です。

access_token = "abc123xxxxxxxxxxxxxxxx-yyyyyyyyyyyyyyyy"

この違いを読み取れなくても問題ありません。AIの答えが表の「OKな答え」に当てはまっていれば合格です。

私の回答を確認すると、2つ目の質問への回答で62行目の約定しなかった時のOANDA側の挙動でエラー内容にアカウントIDが表示される可能性があると指摘されています。

これはAPIの仕様で、どのアカウントIDでエラーが発生したのかを教えてくれるようになっています。

この時、アカウントIDは表示されるのでClaude側で読み込めるようになる可能性はありますが、トークンが表示されることはないと回答されているので問題ありません。

第3回で設定した二重の保護のおさらい

第3回では、次の2つの方法でトークンを保護しました。

  1. .env を Claude Codeの作業フォルダ(oanda_bot)の外に置く
  2. settings.json で、Claudeが ~/oanda_credentials を読めないように設定する

チェック①は、この保護がコードの側でも守られているかを確かめる作業でした。

設定の詳細については第3回で解説しておりますので、ご参照ください。


チェック②:1回の取引でいくら動かしているか、最大損失はいくらか

2つ目のチェックは「お金」です。

確認するのは「数量」「損切り」「繰り返し」の3つ

1回の取引で失う可能性のある金額は、主に次の3つで決まります。

  1. 数量:何通貨を取引するか(OANDA APIでは units という項目で指定します)
  2. 損切り:何pips逆に動いたら決済するか
  3. 繰り返し:その注文を何回出すか

特に3つ目は見落としがちです。1回あたりの損失が小さくても、注文が何度も繰り返されるコードであれば、損失はその回数分ふくらみます。

AIへの質問例

Claude Codeに、次のように質問してください。

🧑 sample_order.py について質問です。コードは修正しないで、答えだけ教えてください。
1.1回の注文で何通貨を、買いと売りのどちらで発注しますか?
2.損切りと利確は設定されていますか?設定されている場合、それぞれ何pipsですか?
3.このコードを1回実行すると、注文は何回出されますか?繰り返し発注する処理はありますか?

チェック②の質問への回答。1,000通貨の買い、損切り20pips・利確30pips、注文は1回だけであることが説明されている。

※環境によって回答の内容が異なることが考えられます。

今回のサンプルでは、次のような答えが返ってくれば依頼どおりです。

  1. ドル円を1,000通貨、買いで発注する
  2. 損切り20pips、利確30pipsが設定されている
  3. 注文は1回だけで、繰り返し発注する処理はない

依頼した内容と答えが食い違っている場合は、そのまま動かさずに修正を頼んでください。修正の頼み方は、第5回のテンプレ2(修正依頼)が使えます。

最大損失を計算してもらう

数量と損切りがわかれば、1回の取引で想定される最大損失を計算できます。計算もClaude Codeに任せてしまいましょう。

🧑 sample_order.py の注文が損切りまで逆に動いた場合、損失はおよそ何円になりますか?計算式もあわせて教えてください。

最大損失の計算結果。損失はおよそ200円で、計算式とずれる要因が説明されている。

※環境によって回答の内容が異なることが考えられます。

ドル円の場合、1pipsは0.01円です。1,000通貨で20pipsの損切りであれば、1,000通貨 × 0.20円 = 約200円が想定される最大損失になります。

この金額を見て「この金額なら許容できる」と思えるかどうかが判断の基準です。

なお、相場が急変したときや週明けに価格が大きく飛んだときは、損切りに設定した価格より不利な価格で決済されることがあります。損切りの金額は「必ずこの金額で止まる」ではなく「目安」として捉えておいてください。

また、損切りが設定されていないと答えが返ってきた場合は、損失に上限がない状態です。損切りは必ず入れてもらうようにしましょう。


チェック③:デモ環境か本番環境か、どこで切り替わっているか

3つ目のチェックは「場所」です。

デモ環境と本番環境の見分け方

OANDA APIには、次の2つの環境があります。

項目 デモ環境 本番環境
コード上の指定 practice live
アカウントIDの形式 101-xxxxx 001-xxxxx
注文したときの影響 仮想のお金で取引される 実際のお金で取引される

コードの中では、次のように environment という項目で環境を指定しています。

client = API(access_token=access_token, environment="practice")

ここが practice であればデモ環境、live であれば本番環境に注文が出されます。アカウントIDの見分け方については、第3回でも解説しています。

AIへの質問例

Claude Codeに、次のように質問してください。

🧑 sample_order.py について質問です。コードは修正しないで、答えだけ教えてください。
1.このコードはデモ環境(practice)と本番環境(live)のどちらに接続しますか?
2.環境を指定している箇所はコードの中に何か所ありますか?
3.本番環境に切り替えるには、どこを変更すればよいですか?

チェック③の質問への回答。デモ環境に接続し、環境の指定は1か所であることが説明されている。

※環境によって回答の内容が異なることが考えられます。

1つ目の答えが「デモ環境(practice)」であることをまず確認してください。2つ目と3つ目は、今後のための確認です。

環境の指定がコードのあちこちに散らばっていると、本番に切り替えるときに一部だけデモのまま残る、あるいは意図せず本番になっている、といった混乱の原因になります。

環境の指定を1か所にまとめてもらう

環境を指定している箇所が2か所以上あると答えが返ってきた場合は、次のように頼んで1か所にまとめてもらいましょう。

🧑 sample_order.py で環境(practice/live)を指定している箇所を、ファイルの先頭の1か所にまとめてください。値は practice のままにしてください。それ以外の部分は触らないでください。

1か所にまとまっていれば、今後どちらの環境で動くかを確認するときも、その1か所を見るだけで済みます。

今の .env にはデモのトークンしか入っていない

もう一つ、安心材料があります。

第3回で .env に保存したのは、デモ口座のAPIトークンです。デモ口座のトークンは本番環境では使えないため、仮にコードが live を指定していても、認証エラー(401エラー)になって注文は出されません。

つまり現時点では、.env の中身そのものが「本番で誤発注しない」ための安全装置になっています。

ただし、将来 .env に本番口座のトークンを入れたときは、この安全装置はなくなります。本番環境で動かす段階になったら、チェック③をいっそう丁寧に行うようにしてください。


3つを確認すれば事故の多くは防げる

ここまでの3つのチェックを確認しておけば、自動売買で起こりがちな事故の多くは防げます。

  1. トークンが漏れて、第三者に口座を操作される
  2. 想定より大きな数量や、損切りなしで発注してしまう
  3. デモのつもりで本番に発注してしまう

いずれも、動かす前に気づければ防げるものばかりです。

3つをまとめて確認するプロンプト

毎回3回に分けて質問するのは手間なので、まとめて確認できるテンプレートを用意しました。[] の中を書き換えてお使いください。

[ファイル名] について、動かす前に安全確認をしたいです。コードは修正しないで、答えだけ教えてください。
1.APIトークンやアカウントIDは、どこから読み込んでいますか?コード内への直接の記述や、画面・ファイルへの出力はありますか?
2.1回の注文の数量、売買の方向、損切りと利確の幅を教えてください。注文は1回の実行で何回出されますか?損切りまで動いた場合の損失はおよそ何円ですか?
3.デモ環境(practice)と本番環境(live)のどちらに接続しますか?環境を指定している箇所は何か所ありますか?
気になる点があれば、最後に別途指摘してください。

3つのチェックをまとめて確認するプロンプトへの回答。認証情報、注文内容、接続先と、気になる点が一覧で示されている。

※環境によって回答の内容が異なることが考えられます。

最後の「気になる点があれば指摘してください」は、3つ以外の問題にAIが気づいた場合に教えてもらうための一文です。

いつ確認するか

安全チェックは、次のタイミングで行うのがおすすめです。

  1. 発注に関わるコードを新しく作ってもらったとき
  2. 発注に関わるコードを修正してもらったとき
  3. デモ環境から本番環境に移すとき

2つ目は特に大切です。

第5回でも触れたとおり、「表示だけ変えて」と頼んだつもりが、AIが別の箇所まで書き換えてしまうことがあります。修正のたびに確認しておけば、数量や環境が知らないうちに変わっていた、という事態を防げます。


「読めないから怖い」を「怖いから質問する」に変える習慣

最後に、この連載を通じて身につけていただきたい習慣についてお話しします。

質問してよいタイミング

AIが書いたコードを前にして「よくわからないけれど、とりあえず動かしてみよう」となるのが一番危険です。次のようなタイミングでは、遠慮なくClaude Codeに質問してください。

  1. コードを動かす前に、何をするコードなのか知りたいとき
  2. AIの説明に知らない言葉が出てきたとき
  3. AIが自分の頼んでいないことを勝手に追加しているように見えるとき

質問するのにお金や回数を気にする必要はほとんどありません。コードの説明を求めるのは、コードを作ってもらうのと同じくらい正当な使い方です。

答えが曖昧なときの深掘りのしかた

AIの答えがはっきりしない場合は、次のように聞き直すと答えが具体的になります。

🧑 該当する箇所のコードを、その部分だけ抜き出して見せてください。そのうえで、何をしているかを1行ずつ説明してください。

コードそのものを見せてもらうことで、AIの説明と実際のコードが食い違っていないかも確かめられます。

用語がわからない場合は、次のように聞いてみてください。

🧑 今の説明に出てきた「[わからない言葉]」の意味を、プログラミングを知らない人向けに説明してください。

「読めないから怖い」と感じたら、それは質問するタイミングだと考えてください。


うまくいかないときは

安全チェックでつまずきやすい場面と、その対処をまとめます。

AIの答えがはっきりしない、毎回違う

「おそらく〜です」のような曖昧な答えが返ってくる場合は、該当箇所のコードを抜き出して見せてもらうよう頼んでください。前のセクションで紹介した深掘りのプロンプトが使えます。

会話が長くなって文脈が混乱している場合は、/clear で会話をリセットしてから、改めて質問するのも有効です。

「問題ありません」とだけ返ってくる

「安全ですか?」のように漠然と聞くと、「問題ありません」とだけ返ってくることがあります。

この場合は、本記事の質問例のように「何通貨ですか」「どこから読み込んでいますか」と、答えが具体的な値になる聞き方に変えてみてください。

「はい/いいえ」で答えられる質問より、値や場所を答えさせる質問の方が確認になります。

指示していないのにAIがコードを実行しようとする

「実行しないで」と伝えたのに、許可ダイアログが表示されることがあります。その場合は「拒否」を選び、次のように伝えてください。

🧑 今回はコードの確認だけが目的です。こちらから指示するまで、コードを実行しないでください。

なお、第4回で解説したとおり、Pythonの実行を「常に許可」にしていると、確認なしで実行されてしまいます。発注に関わるコードを扱う間は、実行の許可は「一度だけ許可」で都度確認するのが安全です。

チェックで問題が見つかった

数量が想定と違う、損切りが入っていない、などの問題が見つかった場合は、動かさずに修正を頼みます。第5回のテンプレ2(修正依頼)を使うと、修正範囲を絞って頼めます。

🧑 sample_order.py の注文部分を修正してください。
今の状態:損切りが設定されていない
変えたい状態:損切り20pipsを設定する
それ以外の部分は触らないでください。

修正が終わったら、もう一度安全チェックを行ってから先に進んでください。


まとめ

本記事では、AIが作ったコードを動かす前に行う「3つの安全チェック」を紹介しました。ポイントを振り返ります。

  1. コードが読めなくても、AIに質問して答えさせれば安全を確かめられる
  2. チェック①では、APIトークンが .env から読み込まれ、画面やファイルに出力されていないかを確認する
  3. チェック②では、数量・損切り・繰り返し回数を確認し、最大損失を計算してもらう
  4. チェック③では、デモ環境(practice)か本番環境(live)か、環境の指定がどこにあるかを確認する
  5. 質問するときは「コードは修正しないで、答えだけ教えてください」と添える
  6. 発注に関わるコードを作ったとき・修正したとき・本番に移すときに、まとめて確認するテンプレートを使う

次回(第7回)からは、自動売買botの部品づくりに入ります。最初のステップとして、OANDA APIで過去データを取得し、CSVに保存するところまで進めていきます。


免責事項

OANDA証券株式会社
第一種金融商品取引業 関東財務局長(金商)第2137号/商品先物取引業者
加入協会:一般社団法人 金融先物取引業協会/日本証券業協会/日本商品先物取引協会

  • 店頭外国為替証拠金取引(FX)、株価指数CFD取引及び商品CFD取引は、元本及び利益が保証されている金融商品ではありません。預託した証拠金の額に比べ大きい金額の取引ができるため、外国為替、株式、株価指数、商品、金利市場等の市場変動により、その損失額が預託された証拠金額を上回る可能性があります。
  • 各取引に必要な証拠金は次の通りです。店頭外国為替証拠金取引に関しては、個人口座は取引金額の4%以上、法人口座は、金融先物取引業協会が算出した通貨ペアごとの為替リスク想定比率を取引の額に乗じて得た額と、当社が算出したリスク想定比率を用いた額のどちらか高い額以上(為替リスク想定比率とは、金融商品取引業等に関する内閣府令第117条第27項第1号に規定される定量的計算モデルを用い算出します)、株価指数CFD取引に関しては、個人口座・法人口座いずれも取引金額の10%以上、商品CFD取引に関しては、個人口座・法人口座いずれも取引金額の5%以上の証拠金が必要です。
  • 口座管理費及び取引手数料は原則無料です。但し一部取引コースに関しては、取引にあたり手数料が発生することがあります。手数料の詳細については、該当するコースの取引説明書をご覧ください。
  • 売付価格と買付価格には差(スプレッド)があり、相場急変動等によりスプレッド幅が拡大し、意図したお取引ができない可能性があります。
  • お取引を始めるにあたっては取引説明書及び取引約款を熟読し、取引内容や仕組み、リスク等を十分にご理解いただいた上で、ご自身の判断にてお取引くださるようお願い致します。
  • 弊社企業情報は、弊社ホームページに開示しています。
  • お客様相談窓口:0120-923-213/日本商品先物取引協会相談センター:03-3664-6243
1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?